Codierte Abfragezeichenfolgen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • 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 einzubeziehen, z. B. Navigieren Sie mithilfe einer URL zu einem Datensatz oder Modul, Oder als Referenzqualifizierer Zum Einschränken der Daten, die für ein Referenzfeld ausgewählt werden können.

    Um eine codierte Abfragezeichenfolge zu erstellen, generieren Sie eine Listenabfrage und dann Kopieren Sie sie 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 kennen Operatoren .

    Tabelle : 1. Beispiele für codierte Abfragezeichenfolge
    Titel Beispiel
    Verweist auf boolesche Werte oder Zeichenfolgenwerte Um eine Abfragezeichenfolge für boolesche Felder zu erstellen, verwenden Sie diese Syntax: Field=wahr oder field=falsch. Um beispielsweise nur aktive Datensätze in einer Tabelle zurückzugeben, verwenden Sie:
    active=true

    Um eine Abfragezeichenfolge mit einem Feld zu erstellen, das einen bestimmten Zeichenfolgenwert hat, verwenden Sie diese Syntax: Field=value. Um beispielsweise Incident-Datensätze zurückzugeben, bei denen die Kategorie „Netzwerk“ ist, verwenden Sie:

    category=network
    Verweisen auf Referenzfelder Um eine Abfragezeichenfolge zu erstellen, die sich auf ein Referenzfeld in einer anderen Tabelle bezieht, verwenden Sie diese Syntax: Field_in_referenced_table=value. Beispiel: Um Anwender mit der Rolle itil in zurückzugeben Zugewiesen an Referenzfeld im Incident-Formular verwenden:
    Assigned_to.roles=itil
    Bezieht sich auf Auswahllistenwerte Dient zum Erstellen einer Abfragezeichenfolge, die sich auf bezieht Auswahlliste Option: Verwenden Sie den Wert der Auswahlliste, nicht die Bezeichnung, mit dieser Syntax: Auswahllistenfeld = Wert. Beispiel: Um Konfigurationselemente (Configuration Items, CIs) mit dem Status zurückzugeben Installiert , Der in der Auswahlliste einen Wert von 1 hat, verwenden Sie:
    install_status=1

    Siehe Werte, die Auswahlbezeichnungen für das Skripting zugeordnet werden sollen Um die Optionen für die Werte zu finden.
    Mit mehreren Bedingungen Um zwei Bedingungen zu verwenden, die von einem UND-Operator verbunden sind, verwenden Sie das Karat ^-Symbol in dieser Syntax: field1=value1^field2=value2. Um beispielsweise alle aktiven Anwender mit der Rolle „itil“ zurückzugeben, verwenden Sie:
    active=true^roles=itil

    Um zwei Bedingungen zu verwenden, die von einem ODER-Operator verbunden sind, verwenden Sie das Karat-Symbol mit ODER mit dieser Syntax: field1=value1^ORfield1=value2. Um beispielsweise alle Anwender mit der Rolle „itil“ oder „admin“ zurückzugeben, verwenden Sie:

    roles=itil^ORroles=admin

    Um die Bedingung des LIKE-Operators zu verwenden, verwenden Sie die Syntax:fieldLIKEsubstring. Um beispielsweise alle Anwender mit Rollen zurückzugeben, die die Zeichenfolge „IT“ enthalten, verwenden Sie:

    rolesLIKEit

    Um die Bedingung eines IN-Operators zu verwenden, verwenden Sie die folgende Syntax: FieldINvalue1,value2,value3. Um beispielsweise alle Anwender mit Rollen zurückzugeben, die entweder „itil“, „admin“ oder „user“ sind, verwenden Sie:

    rolesINitil,admin,user

    Um mehrere Bedingungen hinzuzufügen, bei denen eine Bedingung eine JavaScript-Funktion ist, verwenden Sie diese Syntax: javascript:'field=value^' + function(). Die Funktion muss eine Zeichenfolge zurückgeben, die mit der ersten Zeichenfolge verkettet werden kann, um eine gültige Abfragezeichenfolge zu erzeugen. Um beispielsweise alle aktiven Anwender zurückzugeben und die Bedingungen der Funktion „getGroupQualifier()“ zu erfüllen, verwenden Sie:

    javascript:'active=true^' + getGroupQualifier()
    Werte werden in der Reihenfolge aufgelistet 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 Reihenfolge aus der Tabelle Wochentag [sys_cal_unit] zurückzugeben, verwenden Sie:

    unit_name=day^ORDERBYvalue

    In der Tabelle „Wochentag“ ist „unit_Name“ das Feld, das Tag, Woche oder Monat angibt, und der 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 zurück, vom niedrigsten Wert, der Montag darstellt, bis zum größten Wert, der Sonntag darstellt.

    Hinweis:
    Referenzqualifizierer unterstützen die ORDERBY-Bedingung nicht. In Referenzqualifizierern können Sie die Referenzsuchliste mithilfe von Standardlistensteuerungen sortieren. Um die Reihenfolge einer Liste mit automatischer Vervollständigung 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 zugehörigen Listeninformationen 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:
    ^RLQUERYincident.problem_id,>=1^ENDRLQUERY

    Sie können auch Bedingungen in der zugehörigen Tabelle angeben. Um beispielsweise die Bedingung einzubeziehen, dass mindestens einer der zugehörigen Incidents kritische Priorität hat, verwenden Sie:

    ^RLQUERYincident.problem_id,>=1^priority=1^ENDRLQUERY
    Hinweis:
    Abfragen der zugehörigen Liste müssen in aktiviert sein Systemeigenschaften Liste v3 . Wählen Sie aus Zulassen, dass Abfragebedingungen für zugehörige Listen über den Filter hinzugefügt werden Kontrollkästchen zum 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 einzubeziehen, verwenden Sie die reservierte Variable 123TEXTQUERY321. Um beispielsweise Ergebnisse mit dem Suchbegriff „E-Mail“ zurückzugeben, verwenden Sie diese codierte Abfragezeichenfolge.

    123TEXTQUERY321=email
    Einschließlich einer Textindexgruppenabfrage

    Um eine Textindexgruppe in eine Abfrage einzubeziehen, 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.

    123TEXTINDEXGROUP321=portal_index_group