Codierte Abfragezeichenfolgen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 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 (z. B. Navigieren Sie mithilfe einer URL zu einem Datensatz oder Modul) oder als Referenzqualifizierer einzubeziehen, um die Daten einzuschränken, die für ein Referenzfeld ausgewählt werden können.

    Um eine codierte Abfragezeichenfolge zu erstellen, generieren Sie eine Listenabfrage, und 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 Operatorenkennen.

    Tabelle : 1. Beispiele für codierte Abfragezeichenfolgen
    Titel Beispiel
    Bezieht sich auf boolesche Werte oder Zeichenfolgenwerte Verwenden Sie die folgende Syntax, um eine Abfragezeichenfolge für boolesche Felder zu erstellen: field=true oder field=false. Um beispielsweise nur aktive Datensätze in einer Tabelle zurückzugeben, verwenden Sie:
    active=true

    Verwenden Sie die folgende Syntax, um eine Abfragezeichenfolge mit einem Feld zu erstellen, das einen bestimmten Zeichenfolgenwert enthält: field=value. Um beispielsweise Incident-Datensätze mit der Kategorie „Netzwerk“ zurückzugeben, verwenden Sie:

    category=network
    Verweist 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 itil-Rolle im Referenzfeld Zugewiesen an im Incident-Formular zurückzugeben, verwenden Sie:
    roles=itil
    Bezieht sich auf Auswahllistenwerte Um eine Abfragezeichenfolge zu erstellen, die auf eine Auswahllistenoption verweist, verwenden Sie den Wert der Auswahlliste und nicht die Bezeichnung mit der folgenden Syntax: Auswahllistenfeld = Wert. Um beispielsweise Konfigurationselemente (CIs) mit dem Status Installiertzurückzugeben, die in der Auswahlliste den Wert 1 haben, verwenden Sie:
    install_status=1

    Informationen zu den Optionen für die Werte finden Sie unter Werte, die Auswahlbezeichnungen für die Skripterstellung zugeordnet werden sollen.
    Verwendung mehrerer Bedingungen Um zwei Bedingungen zu verwenden, die durch einen AND-Operator verbunden sind, verwenden Sie das Carat-Symbol ^ in der folgenden Syntax: field1=value1^field2=value2. Um beispielsweise alle aktiven Benutzer mit der Rolle „itil“ zurückzugeben, verwenden Sie:
    active=true^roles=itil

    Um zwei Bedingungen zu verwenden, die durch einen OR-Operator verbunden sind, verwenden Sie das Carat-Symbol mit OR mit der folgenden Syntax: field1=value1^ORfield1=value2. Um beispielsweise alle Benutzer mit den Rollen „itil“ oder „admin“ zurückzugeben, verwenden Sie:

    roles=itil^ORroles=admin

    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 Benutzer zurückzugeben und die Bedingungen der Funktion getGroupQualifier() zu erfüllen, verwenden Sie:

    javascript:'active=true^' + getGroupQualifier()
    Werte in der Reihenfolge auflisten Um Daten nach einem bestimmten Feld zu sortieren, verwenden Sie die Bedingung ORDERBY 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 value 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 Referenznachschlageliste mithilfe von Standardlistensteuerelementen sortieren. Um die Reihenfolge einer Autovervollständigungsliste für ein Referenzfeld anzugeben, verwenden Sie das Wörterbuchattribut ref_ac_order_by.
    Einbindung 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, Folgendes:
    ^RLQUERYincident.problem_id,>=1^ENDRLQUERY

    Sie können auch Bedingungen für die zugehörige Tabelle angeben. Um beispielsweise die Bedingung aufzunehmen, dass mindestens einer der zugehörigen Incidents eine kritische Priorität hat, verwenden Sie:

    ^RLQUERYincident.problem_id,>=1^priority=1^ENDRLQUERY
    Hinweis:
    Abfragen zugehöriger Listen müssen in Systemeigenschaftenliste v3aktiviert sein. Aktivieren Sie das Kontrollkästchen Zulassen, dass Abfragebedingungen für zugehörige Listen über den Filter hinzugefügt werden, um dies zu aktivieren.

    Sie können eine zugehörige Listenabfrage für eine Liste erstellen, die 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.

    123TEXTQUERY321=email
    Einschließlich einer Textindex-Gruppenabfrage

    Um eine Textindexgruppe in eine Abfrage aufzunehmen, verwenden Sie die reservierte Variable 123 TEXTINDEXGROUP321. 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