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-Wert-Paare=Status=geschlossen“ eingeben, die besagt, dass die Liste der Objekte (z. B. ein Vorfall) gefiltert werden soll, bei denen der Status geschlossen ist. Dies wird in der ServiceNow-Dokumentation beschrieben. Sie können dies mit dem ServiceNow REST API Explorer testen. Unsere Aktivität nimmt die vom Benutzer bereitgestellte Abfrage, 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 Aktivität Search ServiceNow Records 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.