Erweiterte Suche - Referenz

Verwenden Sie diese Suchparameter und Operatoren, um präzise Suchabfragen zu erstellen.

Genaue Übereinstimmung

Generell sollten Sie doppelte Anführungszeichen nur für Zeichenfolgenfelder verwenden. Vermeiden Sie doppelte Anführungszeichen für numerische, Datums- und boolesche Felder. Doppelte Anführungszeichen werden hauptsächlich in zwei Fällen verwendet:

1. Suchen nach Begriffen mit Leerzeichen: Verwenden Sie doppelte Anführungszeichen, wenn Sie nach mehreren Wörtern oder Wortfolgen suchen, bei denen die Reihenfolge wichtig ist.

   Beispiele:

   • Mit owner="Doe John" wird nach Artikeln gesucht, deren Eigentümer John Doe ist. Zeichen wie Komma, Punkt oder Doppelpunkt werden ignoriert, damit "Doe, John" als Eigentümer des Artikels zugeordnet werden kann.
   • Mit ITEM_DETAILS:DESC_CHANGE="Scratch on aluminum" wird nach Artikeln gesucht, die genau diese Wortfolge im Feldwert aufweisen.

2. Suchen nach exakten Wörtern: Verwenden Sie doppelte Anführungszeichen, um nur vollständige Wörter zu finden.

   Beispiele:

   • Mit red wird "predator" als Treffer gefunden (Teilübereinstimmung).
   • Mit "red" wird "blue red wheel", jedoch nicht "predator" gefunden.

Sternchen sind für Teilübereinstimmungen nicht erforderlich. Das Suchwerkzeug verwendet automatisch Platzhalter, wenn keine doppelten Anführungszeichen vorhanden sind.

Bedingungsoperatoren

Verwenden Sie Klammern mit Bedingungsoperatoren (AND/OR), um komplexe Abfragen zu erstellen. Beispiel: Verwenden Sie diese Suchabfrage zur Suche nach Artikeln mit einer Auswahllistenauswahl, die der Zeichenfolge "Medium" oder dem Wort "test" in den Arbeitsbereichen Items und BOMs oder Change Orders entspricht: (ITEM_DETAILS:PRIORITY=Medium OR test) AND (workspaceId=9 OR workspaceId=8)

Relationale Operatoren

Verwenden Sie relationale Operatoren (größer als, kleiner als, gleich usw.) mit numerischen und Datumsfeldern. Beispiel: Suchen Sie mit dieser Suchabfrage nach Artikeln, die im Januar 2019 erstellt wurden und das Wort "test" enthalten: test AND createdOn>=2019-01-01 AND createdOn<=2019-01-31

Arbeitsbereichübergreifende Suche

Beschränken Sie Suchanfragen auf bestimmte Arbeitsbereiche. Da Artikel nicht mehreren Arbeitsbereichen angehören können, verwenden Sie zwischen den Arbeitsbereichs-IDs OR anstelle von AND. Beispiel: Suchen Sie mit dieser Suchabfrage nach Artikeln, die John im Arbeitsbereich 9 oder 26 gehören: ownerName=John AND (workspaceId=9 OR workspaceId=26)

Anordnung

Die Suchergebnisse werden vorgabemäßig nach Relevanz (Bewertung) angeordnet. Die Benutzeroberfläche unterstützt derzeit keine benutzerdefinierte Sortierung. In der API können Sie jedoch nach den folgenden Feldern sortieren:

• Bewertung (Relevanz, in den Datensatzinformationen nicht sichtbar) - Vorgabe
• Zuletzt geändert am
• Erstellt am
• Artikelbeschreibung

Die Ergebnisse können in aufsteigender (asc) oder absteigender (desc) Reihenfolge sortiert werden. Beispiel: Verwenden Sie diese Suchabfragen, um das Wort "testing" im Arbeitsbereich 9 zu finden und alle Revisionen zurückzugeben:

• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=score asc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=lastModifiedOn desc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=createdOn asc
• GET /api/v3/search-results?limit=100&offset=0&query=testing+AND+workspaceId%3D19&revision=2&sort=itemDescriptor desc

Tipps

• Vorgabemäßig wird bei der Suche aus revisionsgesteuerten Arbeitsbereichen nur die neueste Version zurückgegeben. Verwenden Sie &revision=2 in API-Aufrufen, um alle Artikel abzurufen, und filtern Sie dann mithilfe der Felder isLatestVersion und isWorkingVersion.

• Alle Bedingungsoperatoren (AND/OR) müssen in Großbuchstaben eingegeben werden.

• Verwenden Sie Datumsbereiche, um nach bestimmten Jahren oder Monaten zu suchen.

• Geben Sie boolesche Werte in Groß- oder Kleinbuchstaben ein.

• Die Suche wird auf allen indizierten Registerkarten durchgeführt. Ab Februar 2019 sind Artikeldetails (ausgenommen Klassifizierungsdaten) und Anhänge (nur Dateititel und Dateinamen) für die Suche indiziert.

• Leerzeichen in Suchabfragen ohne doppelte Anführungszeichen fungieren als OR-Operatoren.

• Die folgenden Zeichen sind in Suchabfragen nicht zulässig:

  • `
  • (
  • )
  • :
  • <
  • >
  • =
  • \
  • /
  • ]
  • [
  • {
  • }