Get ServiceNow Record

UiPath.ServiceNow.Activities.GetRecord

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

Après avoir récupéré l'enregistrement, l'activité génère le statut de la demande (informations de réussite/échec) dans un objet ResponseStatus (ServiceNowStatus) que vous pouvez utiliser dans les activités suivantes (par exemple, la logique conditionnelle).

Cette activité renvoie également les données de champ associées à 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é ServiceNow Scope à votre projet.
3. Ajoutez l’activité Get ServiceNow Record à l’intérieur de l’activité ServiceNow Scope .
4. Cliquez sur le bouton Configurer (Configure) à l'intérieur de l'activité Obtenir l'enregistrement ServiceNow ( Get ServiceNow Record ) (cela ouvre l ' Assistant Objet).
5. Sélectionnez l' objet que vous souhaitez récupérer et entrez, au minimum, le sys_id de l'enregistrement.
6. Créez et entrez une variable ResponseStatus pour la propriété Sortie (Output).
   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API Table - GET{sys_id} .
   • L'API renvoie la valeur ResponseStatus à votre variable de propriété de sortie.
     
     

     

     
     

Dans le corps de l’activité

Pour saisir les valeurs de votre propriété Obtenir l'enregistrement ServiceNow ( Get ServiceNow Record ), vous devez 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) .

• sys_id : l'ID de l'enregistrement ServiceNow que vous souhaitez récupérer. Saisissez une variable String ou String .
  • Pour obtenir la valeur sys_id , vous pouvez suivre l'une des méthodes indiquées dans la documentation ServiceNow unique record identifier (sys_id) 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 regardant l'option "Add Multiple Fields", il se peut que vous ne disposiez pas des autorisations suffisantes dans ServiceNow pour afficher les métadonnées des objets et modifier les données. Veuillez consulter Dépannage des problèmes d'autorisation pour plus de détails.

Avancé

• AdditionalFields - Un DataRow qui inclut les colonnes et les valeurs que vous souhaitez récupérer. Les noms de colonnes doivent correspondre aux noms tels qu'ils apparaissent dans la table de base de données ServiceNow pour le type d'objet sélectionné.

Commun

• NomAffichage (DisplayName) : nom affiché de l'activité. Ce champ prend uniquement en charge les variables Strings et 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 : 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 le guide de démarrage rapide .