Rechercher les enregistrements ServiceNow

UiPath.ServiceNow.Activities.SearchRecords

L'activité Rechercher des enregistrements ServiceNow utilise la table ServiceNow - API GET pour récupérer des enregistrements spécifiques (Objet) à l'aide de votre chaîne de requête encodée (Requête).

After retrieving the records, the activity outputs the result of the query as a DataTable object (Result) and the status of the request (success/failure information) in a ResponseStatus object (ServiceNowStatus). Both of these outputs can be used as input variables in subsequent activities (e.g., conditional logic).

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é Étendue ServiceNow à votre projet.
3. Add the Search ServiceNow Records activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Search ServiceNow Records activity (this opens the Object Wizard).
5. Sélectionnez l' objet que vous souhaitez récupérer et saisissez 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 Output (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é

To enter your Search ServiceNow Records property values and/ test your Query inputs, you can use the Object Wizard by clicking the Configure button.

Pour en savoir plus sur l' Assistant d'objet, consultez la page Infrastructures d'activité métier .

• Object - The type of ServiceNow object that you want to retrieve. Use the Object Wizard to select an object or enter a valid String or String variable. If you use the Object Wizard to select your object, you must also use it to change your selection. Changes made without using the object wizard causes the activity to fail gracefully.

Propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité. Ce champ ne prend en charge que les variables Strings ou String.

Entrée

• Query - The filter parameters. Enter a String or String variable.

  • Saisissez votre requête en suivant le format de chaîne de requête encodé 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 pour générer une chaîne de requête encodée via un filtre dans la documentation ServiceNow.
  • To test your query, open the Object Wizard, enter your String (without quotes ("")) and click the Test Query button to see the results.
  • The query String that you enter in the Object Wizard also populates the Query property in the Properties Panel.

  Plus d'informations sur la façon de créer facilement des requêtes sont décrites dans la section Comment utiliser la fonction Rechercher 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

• Result - The results of the Query. Enter a DataTable variable.
• ServiceNowStatus - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.

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 et des exemples étape par étape, consultez les guides de démarrage rapide .