Insert ImportSet Records

UiPath.ServiceNow.Activities.InsertImportSetRecords

L'activité Insert ImportSet Records utilise l'API ServiceNow Import Set - GET pour mettre à jour les enregistrements existants ou insérer de nouveaux 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ésMettre à 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 des informations détaillées, y compris la résolution des problèmes d'importation, consultez les ensembles d'importation dans la documentation de ServiceNow.

Pour en savoir plus sur l'utilisation des ensembles d'importation, consultez Ensemble d'importations de service Web ( Web service import set) et Importation de données à l'aide d'ensembles d'importation (Import data using import sets ) 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é Insérer des enregistrements d’importation (Insert ImportSet Records) à l’intérieur de l’activité Étendue de ServiceNow .
4. Cliquez sur le bouton Configurer (Configure) à l’intérieur de l’activité Insérer des enregistrements d’un ensemble d’importations ( Insert ImportSet 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 Ensemble d'importations - OBTENIR .
   • L'API renvoie les valeurs DataTable and ResponseStatus` à vos variables de propriété de sortie.
     
     

     

     
     

Dans le corps de l’activité

Pour sélectionner votre ensemble d'importations, vous devez utiliser l' Assistant Objet en cliquant sur le bouton Configurer (Configure).

• Objet : l'ensemble d'importation que vous souhaitez utiliser. Utilisez l' Assistant Objet pour sélectionner votre ensemble d'importation. La liste déroulante Assistant d'objet comprend les ensembles d'importation que vous avez dans votre application ServiceNow.

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 « Ajouter plusieurs champs », vous ne disposez peut-être pas des autorisations suffisantes dans ServiceNow pour afficher les métadonnées d'objet et modifier les données. Veuillez voir Dépannage pour plus de détails.

Commun

• DisplayName : le nom complet de l'activité. Saisissez une variable String ou String .

Entrée

• TableDonnées (DataTable ) : les données que vous souhaitez insérer. Saisissez une variable DataTable .

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

• Résultat (Result ) : les données de résultat de l'insertion. Saisissez une variable DataTable .
• 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.