Upsert Records

UiPath.ServiceNow.Activities.UpsertRecords

L'activité Mettre à jour et insérer des enregistrements utilise l'API ServiceNow Batch pour mettre à jour ou insérer un ou plusieurs enregistrements.

After completing the operation, the activity outputs the result of the insert in a DataTable object (Result) and the operation status (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 quatre méthodes différentes pour mettre à jour et/ou insérer un enregistrement: Mettre à jour l'enregistrement ServiceNow, Insérer l'enregistrement ServiceNow, Mettre à jour les enregistrements ou Insérer ImportSet Records Les activités Mettre à jour l'enregistrement ServiceNow, Insérer l'enregistrement ServiceNow et Mettre à jour l'enregistrement 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 d'écrire directement dans les tables de production, il est recommandé d'utiliser l'activité Insérer ImportSet Records pour mettre à jour ou insérer 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 la section Importer des ensembles de 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 Upsert Records activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Upsert Records activity (this opens the Object Wizard).
5. Sélectionnez l' objet que vous souhaitez utiliser pour votre ensemble d'importation et saisissez vos propriétés d'entrée .
6. Créez et entrez une variable DataTable et une variable ResponseStatus pour les propriétés Sortie .

   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API Batch - POST .

   • L'API renvoie les valeurs DataTable et ResponseStatus à vos variables de propriété de sortie.

     

Configurer

To select your object, 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 .

• Object - The type of record that you want to insert or update. This will be set and appear in the design-time canvas but not the property panel. Use the Object Wizard to select your object.

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 Ajouter plusieurs champs , il se peut que vous ne disposiez pas d’autorisations suffisantes dans ServiceNow pour voir 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.

Commun

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

Entrée

• DataTable - The record data that you want to insert or update. Enter a DataTable variable.
  • To update an existing record, add the sys_Id value to the data row that contains the updates you want to make.
  • Data rows without a sys_id value are inserted as new records (the sys_id of the new record is returned in the Results DataTable object).
  • Le nombre maximum d’enregistrements que vous pouvez mettre à jour ou insérer par exécution d’activité est de 200. Si vous souhaitez insérer/mettre à jour plus de 200 enregistrements, vous pouvez ajouter une boucle for ou ajouter une activité Mettre à jour ou insérer une activité UiPath pour chaque DataTable contenant 200 enregistrements (par exemple, si vous avez un total de 4 000 enregistrements, vous pouvez diviser les enregistrements en 20 enregistrements distincts activités). Pour plus d'informations, consultez la section API par lots dans la documentation 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

• Status - 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.
• Result - The result of the inserted or updated record(s). The Results DataTable has the same structure as the input DataTable, with the following exceptions:
  • New records that were inserted successfully now include a sys_id value.
  • A new "ActionType" column is appended and includes a value of either Add or Update to indicate whether a record was updated or added to the table.
  • Une nouvelle colonne « Erreur » est ajoutée et inclut des informations sur l'erreur si l'opération a échoué.