Codierte Abfragezeichenfolgen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 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 (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.

    Tabelle : 1. Beispiele für codierte Abfragezeichenfolgen
    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:
    active=true

    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:

    category=network
    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:
    Assigned_to.roles=itil
    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:
    install_status=1

    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:
    active=true^roles=itil

    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:

    roles=itil^ORroles=admin

    Um die Bedingung durch den LIKE-Operator zu verwenden, verwenden Sie die Syntax:fieldLIKETeilzeichenfolge. Um beispielsweise alle Benutzer mit Rollen zurückzugeben, die die Zeichenfolge „it“ enthalten, verwenden Sie:

    rolesLIKEit

    Um die Bedingung durch einen IN-Operator zu verwenden, verwenden Sie die folgende Syntax: fieldINvalue1,value2,value3. Um beispielsweise alle Benutzer mit den Rollen „itil“, „admin“ oder „user“ zurückzugeben, verwenden Sie Folgendes:

    rolesINitil,admin,user

    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:

    javascript:'active=true^' + getGroupQualifier()
    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:

    unit_name=day^ORDERBYvalue

    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:
    ^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 kritische Priorität hat, verwenden Sie:

    ^RLQUERYincident.problem_id,>=1^priority=1^ENDRLQUERY
    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.

    123TEXTQUERY321=email
    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.

    123TEXTINDEXGROUP321=portal_index_group