Rechercher les enregistrements ServiceNow

UiPath.ServiceNow.Activities.SearchRecords

L’activité Rechercher dans les enregistrements ServiceNow ( Search ServiceNow Records ) utilise l’API GET Table ServiceNow pour récupérer des enregistrements spécifiques (Object) à l’aide de votre chaîne de requête encodée (Query).

Après avoir récupéré les enregistrements, l'activité génère le résultat de la requête sous la forme d'un objet DataTable (Result) et le statut de la demande (informations de réussite/échec) dans un objet ResponseStatus (ServiceNowStatus). Ces deux sorties peuvent être utilisées comme variables d'entrée dans les activités suivantes (par exemple, la logique conditionnelle).

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Terminez les étapes de configuration .
2. Ajoutez l'activité ServiceNow Scope à votre projet.
3. Ajoutez l’activité Rechercher dans les enregistrements ServiceNow (Search ServiceNow Records) à l’intérieur de l’activité Étendue ServiceNow .
4. Cliquez sur le bouton Configurer (Configure) à l'intérieur de l'activité Rechercher dans les enregistrements ServiceNow ( Search ServiceNow Records ) (cela ouvre l ' Assistant Objet).
5. Sélectionnez l' objet que vous souhaitez récupérer et entrez des valeurs pour les propriétés d' entrée .
6. Créez et entrez les variables DataTable et ResponseStatus pour les propriétés de sortie .
   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API Table - GET .
   • L'API renvoie les valeurs DataTable et ResponseStatus à vos variables de propriété de sortie.
     
     

     

     
     

Dans le corps de l’activité

Pour saisir les valeurs de votre propriété Rechercher dans les enregistrements ServiceNow ( Search ServiceNow Records ) et/ou tester vos entrées de requête , vous pouvez utiliser l' Assistant Objet en cliquant sur le bouton Configurer (Configure).

Pour en savoir plus sur l ' Assistant Objet, consultez la page Cadres d'activité métier (Business Activity Frameworks) .

• Objet : le type d'objet ServiceNow que vous souhaitez récupérer. Utilisez l' Assistant Objet pour sélectionner un objet ou entrez une variable String ou String valide. Si vous utilisez l' Assistant Objet pour sélectionner votre objet, vous devez également l'utiliser pour modifier votre sélection. Les modifications apportées sans utiliser l'assistant d'objet entraînent l'échec normal de l'activité.

Propriétés

Commun

• NomAffichage (DisplayName) : nom affiché de l'activité. Ce champ prend uniquement en charge les variables Strings et String.

Entrée

• Requête : les paramètres du filtre. Saisissez une variable String ou String .
  • Saisissez votre requête en suivant le format de chaîne de requête encodée ServiceNow (par exemple, "sysparm_query=short_descriptionLIKEUiPath&sysparm_fields=number,short_description").
  • Pour créer votre requête, il est recommandé de suivre les étapes de génération d'une chaîne de requête codée via un filtre dans la documentation ServiceNow.
  • Pour tester votre requête, ouvrez l ' Assistant Objet, entrez votre String (sans les guillemets ("")) et cliquez sur le bouton Tester la requête pour voir les résultats.
  • La requête String que vous entrez dans l' Assistant Objet renseigne également la propriété Requête dans le panneau Propriétés.

    Pour en savoir plus sur la façon de créer facilement des requêtes, consultez la section Comment utiliser la recherche dans les enregistrements ServiceNow.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

• Résultat (Result ) : les résultats de la requête. Saisissez une variable DataTable .
• ServiceNowStatus : le statut de la demande (informations de réussite/échec). Saisissez une variable ResponseStatus (UiPath.BAF.Models.ResponseStatus). L'objet ResponseStatus comprend trois propriétés que vous pouvez utiliser dans d'autres activités.
  • Success - Boolean - Spécifie si la requête API a réussi.
  • Code d'erreur - String - L'erreur de réponse si la requête API échoue (Success=False).
  • Message - String - Le message d'erreur.

Exemple

L'image suivante montre un exemple de la relation de dépendance d'activité et des valeurs de propriété d'entrée/sortie.

Pour obtenir des instructions étape par étape et des exemples, consultez les guides de démarrage rapide .