Get ServiceNow Record

UiPath.ServiceNow.Activities.GetRecord

L'activité Obtenir l'enregistrement ServiceNow utilise l'API ServiceNow Table - GET{sys_id} pour récupérer un enregistrement spécifique.

After retrieving the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (ServiceNowStatus) that you can use in subsequent activities (e.g., conditional logic).

Cette activité renvoie également les données de champ associées à la variable sys_id. Par exemple, si vous souhaitez récupérer un objet d'incident ServiceNow, vous pouvez générer les données short_description et contact_type en ajoutant les champs (avec variables) dans l' assistant d'objet (voir l'exemple ci-dessous).

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 Get ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Get ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object that you want to retrieve and enter, at a minimum, the sys_id of the record.
6. Créez et entrez une variable ResponseStatus pour la propriété Output .

   • Les valeurs de vos propriétés d'entrée sont envoyées à la table - API GET{sys_id} .

   • L'API renvoie la valeur ResponseStatus à votre variable de propriété de sortie.

     

Dans le corps de l’activité

To enter your Get ServiceNow Record property values, you must 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 .

• sys_id - The id of the ServiceNow record that you want to retrieve. Enter a String or String variable.
  • Pour obtenir la valeur sys_id , vous pouvez suivre l'une des méthodes affichées dans la documentation de l'identificateur d'enregistrement unique ServiceNow ou cliquer avec le bouton droit sur l'enregistrement dans l'interface utilisateur de ServiceNow et sélectionner l'option Copier sys_id dans le menu contextuel.

Propriétés

Remarque :

Si vous ne voyez pas de liste de propriétés pour l'objet que vous choisissez, même en choisissant l'option « Ajouter plusieurs champs», vous ne disposez peut-être pas des autorisations suffisantes dans ServiceNow pour afficher les métadonnées des objets et modifier les données. Veuillez consulter Résolution des problèmes d'autorisation pour plus de détails.

Avancé

• AdditionalFields - A DataRow that includes the columns and values that you want to retrieve. The column names must match the names as they appear in the ServiceNow database table for the selected object type.

Commun

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

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

• 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 le Guide de démarrage rapide .