Schnellstart – "Search ServiceNow Records" verwenden

Überblick

Dieser Leitfaden soll Sie durch mehrere Beispiele für die Abfrage von Daten mit der Aktivität Search ServiceNow Records führen.

Sie können eine Abfrage wie „name-value pairs=state=closed“ eingeben, die besagt, dass die Liste der Objekte (z. B. ein Incident) gefiltert werden soll, bei denen der Status geschlossen ist. Dies wird in der Dokumentation von ServiceNow beschrieben und Sie können dies mit dem ServiceNow-REST-API-Explorertesten. Unsere Aktivität nimmt die Abfrage, die der Benutzer bereitstellt, und hängt sie an den entsprechenden ServiceNow-REST-API -Aufruf an und empfängt dann die Ergebnisse.

Das Problem für einige Kunden besteht darin, dass es nicht leicht zu verstehen ist, wie Abfragen erstellt oder getestet werden, oder dass die Person nicht so technisch ist, dass das Erlernen und Verwenden des ServiceNow-REST-API-Explorers praktisch ist.

Anleitung (Guide)

Die Dokumentation von ServiceNow zum Erstellen von Abfragen, die mit ihrer REST-API verwendet werden können, befindet sich in der Dokumentation zu codierten Abfragezeichenfolgen . Dies ist eine nützliche Ressource, wenn Sie erfahren möchten, wie Abfragen erstellt werden, die mit der Search ServiceNow Records-Aktivität verwendet werden können.

Nachfolgend finden Sie einige Abfragebeispiele, die mit dem Incidents- Objekt verwendet werden können:

Abfrage	Beschreibung
sysparm_fields=number,sys_created_on,sys_created_by	Gibt alle Datensätze zurück, gibt jedoch nur die drei angegebenen Spalten zurück (number, sys_created_on und sys_created_by).
name-value pairs=state=closed	Gibt alle Datensätze zurück, bei denen der Status geschlossenist.
sysparm_fields=number,sys_created_on,sys_created_by&sysparm_limit=1&name-value pair=state%3Dopen	Geben Sie nur die drei Spalten (number, sys_created_on und sys_created_by) für jeden Datensatz zurück, geben Sie nur Datensätze zurück, deren Status Openist, und begrenzen Sie die Ergebnisse auf 1 Datensatz.
priority=2	Gibt alle Datensätze zurück, bei denen die Priorität 2ist.
sysparm_query=active=true&state=closed	Alle Datensätze zurückgeben, bei denen die Kurzbeschreibung wie „Netzwerk“ lautet
sysparm_query=short_descriptionLIKEnetwork	Einen Datensatz mit der Zahl INC0010060 zurückgeben und nur drei Spalten als Teil des Ergebnisses zurückgeben (sys_id, number, short_description)

Es gibt zwei weitere Methoden zum Erstellen und Abrufen nützlicher Abfragen, die mit dieser Aktivität verwendet werden können.

1. Option A: Kopieren Sie eine beliebige Abfrage aus der ServiceNow-Benutzeroberfläche.
2. Option B: Kopieren der Abfragezeichenfolge aus dem Browser.

Option A: Kopieren Sie eine beliebige Abfrage aus der ServiceNow-UI

Sie müssen den Text „sysparm_query=" jeder Abfrage voranstellen, die gemäß den folgenden Schritten zu Ergebnissen führt.

Schritt 1

Wechseln Sie zu einem Objekt, in diesem Fall Vorfälle .

Schritt 2

Löschen Sie die Filter und erstellen Sie einen neuen Filter. In unserem Fall suchen wir nach Vorfällen, deren Nummer mit der Zeichenfolge „100“ endet.

Schritt 3

Kopieren Sie die Abfrage, die das Menüelement Abfrage kopieren (Copy Query) verwendet. Sie sieht wie folgt aus: numberENDSWITH100.

Schritt 4

Fügen Sie dies in die Aktivität Search ServiceNow Records ein. Sie können dies im Fenster Testabfrage (siehe unten) oder in der Abfrageeigenschaft der Aktivität tun.

Stellen Sie sicher, dass Sie sysparm_query= voranstellen, damit es wie sysparm_query=numberENDSWITH100aussieht, andernfalls funktioniert es nicht richtig.

Option B: Kopieren der Abfragezeichenfolge aus dem Browser.

Bei dieser Option müssen Sie nicht daran denken, etwas als vorab ausstehenden Schritt hinzuzufügen. Sie können die Abfragezeichenfolge kopieren und einfügen, wenn Sie die Option Neues Fenster öffnen wie folgt verwenden:

Schritt 1:

Erstellen Sie den Filter, den Sie verwenden möchten, wie zuvor in Option A.

  Schritt 2: Klicken Sie mit der rechten Maustaste und wählen Sie die Menüoption Neues Fenster öffnen aus .

Schritt 3: Kopieren Sie die Abfragezeichenfolge insgesamt (alles nach dem Fragezeichen „?“). Fügen Sie sie dann direkt in das Dialogfeld „Testabfrage“ der Aktivität Search ServiceNow Records ein, wie unten gezeigt.