Codierte Abfragezeichenfolgen
Eine codierte Abfragezeichenfolge stellt einen komplexen Filter in einer Liste von Datensätzen dar.
Verwenden Sie codierte Abfragezeichenfolgen, um einen Filter als Teil eines URL-Parameters (z. B. Navigieren Sie über eine URL zu einem Datensatz oder einem Modul) oder als Referenzqualifizierer einzubeziehen, um die für ein Referenzfeld auswählbaren Daten einzuschränken.
Um eine codierte Abfragezeichenfolge zu erstellen, generieren Sie eine Listenabfrage, und kopieren Sie sie dann aus dem Listenfilter. Dies ist die bevorzugte Methode, da die Alternative darin besteht, die Zeichenfolge manuell zu erstellen.
Um eine codierte Abfragezeichenfolge manuell zu erstellen, müssen Sie die relevanten Tabellen- und Feldnamen und Operatorenkennen.
| Titel | Beispiel |
|---|---|
| Bezieht sich auf boolesche Werte oder Zeichenfolgenwerte | Um eine Abfragezeichenfolge für boolesche Felder zu erstellen, verwenden Sie diese Syntax: field=true oder field=false. Um beispielsweise nur die aktiven Datensätze in einer Tabelle zurückzugeben, verwenden Sie:Um eine Abfragezeichenfolge mit einem Feld zu erstellen, das einen bestimmten Zeichenfolgenwert enthält, verwenden Sie diese Syntax: Feld = Wert. Um beispielsweise Incident-Datensätze zurückzugeben, bei denen die Kategorie „Netzwerk“ lautet, verwenden Sie: |
| Bezieht sich auf Referenzfelder | Um eine Abfragezeichenfolge zu erstellen, die auf ein Referenzfeld in einer anderen Tabelle verweist, verwenden Sie diese Syntax: field_in_referenced_table=value. Um beispielsweise Benutzer mit der Rolle itil im Referenzfeld Zugewiesen an im Incident-Formular zurückzugeben, verwenden Sie: |
| Bezieht sich auf Auswahllistenwerte | Um eine Abfragezeichenfolge zu erstellen, die auf eine Auswahllistenoption verweist, verwenden Sie den Wert der Auswahlliste, nicht die Bezeichnung, mit dieser Syntax: Auswahllistenfeld=Wert. Um beispielsweise Configuration Items (CIs) mit dem Status Installiertzurückzugeben, die in der Auswahlliste den Wert 1 haben, verwenden Sie:Unter Werte, die Auswahlbezeichnungen für Skripting zugeordnet werden können, finden Sie die Optionen für die Werte. |
| Mehrere Bedingungen werden verwendet | Um zwei Bedingungen zu verwenden, die durch einen UND-Operator verbunden sind, verwenden Sie das Caret-Symbol ^ in dieser Syntax: field1=value1^field2=value2. Um beispielsweise alle aktiven Benutzer mit der Rolle „itil“ zurückzugeben, verwenden Sie:Um zwei Bedingungen zu verwenden, die durch einen ODER-Operator verbunden sind, verwenden Sie das Caret-Symbol mit ODER mit dieser Syntax: field1=value1^ORfield1=value2. Um beispielsweise alle Benutzer mit den Rollen „itil“ oder „admin“ zurückzugeben, verwenden Sie: Um mehrere Bedingungen hinzuzufügen, von denen eine Bedingung eine JavaScript-Funktion ist, verwenden Sie diese Syntax: javascript:'field=value^' + Funktion(). Die Funktion muss eine Zeichenfolge zurückgeben, die mit der ersten Zeichenfolge verkettet werden kann, um eine gültige Abfragezeichenfolge zu erstellen. Um beispielsweise alle aktiven Benutzer zurückzugeben und die Bedingungen der Funktion getGroupQualifier() zu erfüllen, verwenden Sie: |
| Werte in Reihenfolge auflisten | Um Daten nach einem bestimmten Feld zu sortieren, verwenden Sie die ORDERBY-Bedingung mit der folgenden Syntax: field1=value^ORDERBYfield2. Um beispielsweise die Wochentage in der richtigen Reihenfolge aus der Tabelle „Wochentag“ [sys_cal_unit] zurückzugeben, verwenden Sie: In der Tabelle „Wochentag“ ist „unit_name“ das Feld, das Tag, Woche oder Monat angibt, und „Wert“ ist ein numerischer Wert für jeden Tag von 1 (Montag) bis 7 (Sonntag). Die Abfragezeichenfolge gibt eine Liste der Wochentage in der Reihenfolge vom niedrigsten Wert, der Montag darstellt, bis zum größten Wert, der Sonntag darstellt, zurück. Hinweis: Referenzqualifizierer unterstützen die ORDERBY-Bedingung nicht. In Referenzqualifizierern können Sie die Referenzsuchliste mithilfe von Standardlistensteuerelementen sortieren. Um die Reihenfolge einer automatisch vervollständigten Liste für ein Referenzfeld anzugeben, verwenden Sie das Wörterbuchattribut ref_ac_order_by. |
| Einschließlich einer zugehörigen Listenabfrage | Schließen Sie am Ende der Abfrageanweisung die Informationen der zugehörigen Liste mit ^RLQUERY und ^ENDRLQUERY und der Menge ein. Verwenden Sie beispielsweise in einer Abfrage in der Problemtabelle, die Probleme mit mindestens einem zugehörigen Incident enthält, Folgendes:Sie können auch Bedingungen für die zugehörige Tabelle angeben. Um beispielsweise die Bedingung aufzunehmen, dass mindestens einer der zugehörigen Incidents kritische Priorität hat, verwenden Sie: Hinweis: Abfragen zugehöriger Listen müssen in der Systemeigenschaftenliste v3aktiviert werden. Aktivieren Sie das Kontrollkästchen Zugehörige Listenabfragebedingungen, die über Filter hinzugefügt werden können, um sie zu aktivieren. Sie können eine zugehörige Listenabfrage für eine Liste erstellen, die Liste v2 verwendet. Die Filterbedingungen können jedoch erst geändert werden, wenn Sie die zugehörige Listenbedingung im Breadcrumb entfernt haben. |
| Einschließlich einer Suchbegriffabfrage | Um einen Suchbegriff in eine Abfrage aufzunehmen, verwenden Sie die reservierte Variable 123TEXTQUERY321. Um beispielsweise Ergebnisse mit dem Suchbegriff „E-Mail“ zurückzugeben, verwenden Sie diese codierte Abfragezeichenfolge. |
| Einschließlich einer Textindex-Gruppenabfrage | Um eine Textindexgruppe in eine Abfrage aufzunehmen, verwenden Sie die reservierte Variable 123TEXTINDEXGROUP321. Um beispielsweise Ergebnisse innerhalb der Textindexgruppe „portal_index_group“ in der Tabelle „Textindexgruppen“ [ts_index_group] zurückzugeben, verwenden Sie diese codierte Abfragezeichenfolge. |