Insérer l'enregistrement ServiceNow

UiPath.ServiceNow.Activities.InsertRecord

L’activité Insérer un enregistrement ServiceNow ( Insert ServiceNow Record ) utilise l’API POST de la table ServiceNow pour insérer un nouvel objet d’enregistrement.

Après avoir insé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 la valeur sys_id du nouvel objet d'enregistrement. Par exemple, si vous souhaitez insérer un objet d' incident ServiceNow, vous pouvez générer la valeur sys_id en ajoutant une variable String dans l'assistant d'objet (voir l' exemple ci-dessous).

Astuce :

Ce package d'activités propose trois méthodes différentes pour insérer un enregistrement : Insert ServiceNow Record,Upsert Recordsou Insert ImportSet Records.

Les activités Insérer un enregistrement ServiceNow (Insert ServiceNow Record ) 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'insérer des enregistrements directement dans les tables de production, il est recommandé d'utiliser l'activité Upsert ServiceNow Record pour 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 de 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é Insérer un enregistrement ServiceNow (Insert ServiceNow Record) à l’intérieur de l’activité Étendue ServiceNow (ServiceNow Scope) .
4. Cliquez sur le bouton Configurer à l'intérieur de l'activité Insérer un enregistrement ServiceNow ( Insert ServiceNow Record ) (cela ouvre l ' Assistant Objet).
5. Sélectionnez l' objet que vous souhaitez insérer et ajoutez les champs (avec des valeurs) que vous souhaitez remplir.
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 - POST .
   • 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é Insérer un enregistrement ServiceNow ( Insert 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 créé. Saisissez une variable String . Le sys_id est généré automatiquement par ServiceNow lorsque vous insérez votre nouvel enregistrement. Pour récupérer cette valeur afin de l'utiliser dans d'autres activités, créez et entrez une variable String dans l'assistant d'objet (exemple ci-dessous).

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 », 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.

Avancé

• AdditionalFields - Un DataRow qui inclut les colonnes et les valeurs que vous souhaitez insé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 .