Upsert Records

UiPath.ServiceNow.Activities.UpsertRecords

L'activité Upsert Records utilise l'API ServiceNow Batch - POST pour mettre à jour ou insérer un ou plusieurs enregistrements.

Une fois l'opération terminée, l'activité génère le résultat de l'insertion dans un objet DataTable (Result) et le statut de l'opération (informations de réussite/échec) dans un objet ResponseStatus (ServiceNowStatus) que vous pouvez utiliser dans des activités ultérieures (par exemple , logique conditionnelle).

Astuce :

Ce package d'activités propose quatre méthodes différentes pour mettre à jour et/ou insérer un enregistrement : Mettre à jour un enregistrement ServiceNow ( Update ServiceNow Record), Insérer un enregistrement ServiceNow ( Insert ServiceNow Record), Upsert d'enregistrements ( Upsert Records) ou Insérer des enregistrements ImportSet ( Insert ImportSet Records)

Les activités Mettre à jour l'enregistrement ServiceNow (Upsert ServiceNow Record) , Insérer un enregistrement ServiceNow(Insérer un enregistrement ServiceNow) et Upsert Records (Upsert Records) utilisent des API REST pour écrire directement dans une table de production. L'activité Insérer des enregistrements d'un ensemble d'importations ( Insert ImportSet Records) utilise l'API REST Import Set pour écrire dans une table d'ensembles d'importations à partir de laquelle les données sont transformées en table de production cible.

Pour éviter d'écrire directement dans les tables de production, il est recommandé d'utiliser l'activité Insérer des enregistrements d'un ensemble d' importations (Insert ImportSet Records) pour mettre à jour ou insérer un nouvel enregistrement.

Pour plus d'informations, y compris le dépannage des performances des ensembles d'importation, consultez les ensembles d'importation dans la documentation ServiceNow.

Pour en savoir plus sur l'utilisation des ensembles d'importation, consultez Ensemble d'importation de service 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é ServiceNow Scope à votre projet.
3. Ajoutez l’activité Upsert Records à l’intérieur de l’activité Étendue ServiceNow .
4. Cliquez sur le bouton Configurer (Configure) à l'intérieur de l'activité Upsert Records (cela ouvre l' Assistant Objet).
5. Sélectionnez l' objet que vous souhaitez utiliser pour votre ensemble d'importation et entrez vos propriétés d'entrée .
6. Créez et entrez une variable DataTable et une variable ResponseStatus pour les propriétés de 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

Pour sélectionner votre objet, 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) .

• Objet : le type d'enregistrement que vous souhaitez insérer ou mettre à jour. Celui-ci sera défini et apparaîtra dans le canevas au moment de la conception, mais pas dans le panneau des propriétés. Utilisez l' Assistant Objet pour sélectionner votre objet.

Propriétés

Remarque : si vous ne voyez pas la liste des propriétés de l'objet que vous choisissez, même en consultant l'option Ajouter plusieurs champs ( Add Multiple Fields) , il est possible que vous ne disposiez pas des autorisations suffisantes dans ServiceNow pour afficher les métadonnées de l'objet et modifier les données. Veuillez consulter Dépannage des problèmes d’autorisation pour plus de détails.

Commun

• NomAffichage (DisplayName) : nom affiché de l'activité. Ce champ prend uniquement en charge les variables Strings et String.

Entrée

• TableDonnées : les données d'enregistrement que vous souhaitez insérer ou mettre à jour. Saisissez une variable DataTable .
  • Pour mettre à jour un enregistrement existant, ajoutez la valeur sys_Id à la ligne de données qui contient les mises à jour que vous souhaitez effectuer.
  • Les lignes de données sans valeur sys_id sont insérées en tant que nouveaux enregistrements (le sys_id du nouvel enregistrement est renvoyé dans l'objet Results DataTable ).
  • Le nombre maximal 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é Upsert 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 l' API Batch 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

• Statut (Status) - 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.
• Résultat (Result ) : le résultat du ou des enregistrements insérés ou mis à jour. Résultats DataTable a la même structure que l'entrée DataTable, avec les exceptions suivantes :
  • Les nouveaux enregistrements insérés avec succès incluent désormais une valeur sys_id .
  • Une nouvelle colonne « ActionType » est ajoutée et inclut une valeur Ajouter (Add) ou Mettre à jour ( Update ) pour indiquer si un enregistrement a été mis à jour ou ajouté à la table.
  • Une nouvelle colonne « Erreur » est ajoutée et inclut des informations sur l'erreur si l'opération a échoué.