Update ServiceNow Record

Activité de mise à jour d’un enregistrement ServiceNow spécifique par sys_id à l’aide de l’API PUT de table

UiPath.ServiceNow.Activities.UpdateRecord

L'activité Mettre à jour un enregistrement ServiceNow utilise l'API ServiceNow Table - PUT pour mettre à jour un enregistrement spécifique.

After updating 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).

Astuce :

Ce package d'activités propose trois méthodes différentes pour mettre à jour un enregistrement: Mettre à jour l'enregistrement ServiceNow,Mettre à jour les enregistrements ou Insérer ImportSet Records. Les activitésMettre à jour l'enregistrement ServiceNow et Mettre à jour et insérer des enregistrements utilisent les API REST pour écrire directement dans une table de production. L'activité Insert ImportSet Records utilise l'API REST Import Set pour écrire dans une table d'ensemble d'importation à partir de laquelle les données sont transformées dans la table de production cible. Pour éviter de mettre à jour les enregistrements directement dans les tables de production, il est recommandé d'utiliser l'activité Insérer ImportSet Records pour mettre à jour un nouvel enregistrement. Pour obtenir des informations détaillées, y compris la résolution des problèmes de performances des ensembles d’importation, consultez Ensembles d’importation dans la documentation ServiceNow. Pour en savoir plus sur l'utilisation des ensembles d'importation, consultez Ensemble d'importation de services Web et Importation de données à l'aide d'ensembles d'importation dans la documentation ServiceNow.

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 Update ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Update ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object that you want to update and enter, at a minimum, the sys_id of the record.
6. Créez et entrez une variable ResponseStatus pour la propriété Output (Sortie).
   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API Table - PUT .
   • L'API renvoie la valeur ResponseStatus à votre variable de propriété de sortie.

Dans le corps de l’activité

To enter your Update 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 : l'identifiant de l'enregistrement ServiceNow que vous souhaitez mettre à jour. 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 update. 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 .