Démarrage rapide : Comment utiliser la fonction Rechercher les enregistrements ServiceNow

Vue d'ensemble (Overview)

L'objectif de ce guide est de vous guider à travers plusieurs exemples d'interrogation de données à l'aide de l'activité Rechercher dans les enregistrements ServiceNow (Search ServiceNow Records) .

Vous pouvez saisir une requête telle que « name-value pairs=state=closed » qui demande de filtrer la liste des objets (tels qu’un incident) pour lesquels l’état est fermé. Ceci est décrit dans la documentation de ServiceNow et vous pouvez le tester à l'aide de l ' explorateur d'API REST de ServiceNow. Notre activité prend la requête fournie par l’utilisateur et l’ajoute à l’appel API REST ServiceNow pertinent, puis reçoit les résultats.

Le problème pour certains clients est qu'il n'est pas facile de comprendre comment créer des requêtes, comment tester des requêtes, ou que la personne n'est pas technique dans la mesure où l'apprentissage et l'utilisation de l'explorateur d'API REST de ServiceNow sont pratiques.

Guide

La documentation de ServiceNow concernant la création de requêtes pouvant être utilisées avec son API REST se trouve dans la documentation Chaînes de requête codées ( Encoded query strings ). Il s'agit d'une ressource utile si vous souhaitez apprendre à créer des requêtes pouvant être utilisées avec l'activité Search ServiceNow Records.

Vous trouverez ci-dessous quelques exemples de requêtes pouvant être utilisées avec l’objet Incidents :

Requête	Description
sysparm_fields=number,sys_created_on,sys_created_by	Renvoie tous les enregistrements, mais ne renvoie que les trois colonnes spécifiées (number, sys_created_on et sys_created_by)
name-value pairs=state=closed	Renvoie tous les enregistrements où l'état est fermé.
sysparm_fields=number,sys_created_on,sys_created_by&sysparm_limit=1&name-value pair=state%3Dopen	Renvoie uniquement les trois colonnes (number, sys_created_on et sys_created_by) pour chaque enregistrement, renvoie uniquement les enregistrements dont l'état est Open(Open) et limite les résultats à 1 enregistrement.
priority=2	Renvoie tous les enregistrements dont la priorité est 2.
sysparm_query=active=true&state=closed	Renvoie tous les enregistrements dont la brève description ressemble à un réseau
sysparm_query=short_descriptionLIKEnetwork	Renvoie un enregistrement dont le nombre est INC0010060 et ne renvoie que trois colonnes dans le cadre du résultat (sys_id, number, short_description)

Il existe deux autres méthodes pour créer et obtenir des requêtes utiles qui peuvent être utilisées avec cette activité.

1. Option A : copiez n'importe quelle requête de l'interface utilisateur de ServiceNow.
2. Option B : copie de la chaîne de requête à partir du navigateur.

Option A : copier n'importe quelle requête à partir de l'interface utilisateur de ServiceNow

Vous devrez ajouter le texte « sysparm_query=" au début de toute requête résultant des étapes ci-dessous.

Étape 1

Accédez à un objet, Incidents dans ce cas.

Étape 2

Effacez les filtres et créez un nouveau filtre. Dans notre cas, nous recherchons tous les incidents dont le numéro se termine par la chaîne « 100 ».

Étape 3 :

Copiez la requête à l'aide de l'élément de menu Copier la requête (Copy Query). Il ressemblera au numéroENDSWITH100.

Étape 4

Collez-le dans l’activité Search ServiceNow Records (Search ServiceNow Records). Vous pouvez le faire dans la fenêtre Tester la requête, comme indiqué ci-dessous, ou dans la propriété de requête de l'activité.

Assurez-vous de pré- ajouter sysparm_query= devant afin qu'il ressemble à sysparm_query=numberENDSWITH100, sinon cela ne fonctionnera pas correctement.

Option B : copie de la chaîne de requête à partir du navigateur.

Dans cette option, vous n'avez pas à vous rappeler d'ajouter quoi que ce soit en tant qu'étape en attente. Vous pouvez copier et coller la chaîne de requête si vous utilisez l'option Ouvrir une nouvelle fenêtre comme ci-dessous :

Étape 1:

Créez le filtre que vous souhaitez utiliser comme précédemment dans l'option A.

  Étape 2 : cliquez avec le bouton droit et choisissez l' option de menuOuvrir une nouvelle fenêtre (Open new window).

Étape 3 : copiez la chaîne de requête dans son intégralité (tout ce qui suit le point d’interrogation « ? »). Collez-la ensuite directement dans la boîte de dialogue « Test Query » (Requête de test) de l’activité Search ServiceNow Records, comme indiqué ci-dessous.