Insérer l'enregistrement ServiceNow

UiPath.ServiceNow.Activities.InsertRecord

L'activité Insérer un enregistrement ServiceNow utilise l'API ServiceNow Table - POST pour insérer un nouvel objet d'enregistrement.

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

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: Insérer l'enregistrement ServiceNow,Mettre à jour les enregistrements ou Insérer l'enregistrement ImportSet Records Les activitésInsérer l'enregistrement ServiceNow et Mettre à jour les 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 d'insérer des enregistrements directement dans les tables de production, il est recommandé d'utiliser l'activité Mettre à jour l'enregistrement ServiceNow pour 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 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 Insert ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Insert ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object you want to insert and add the fields (with values) you want to populate.
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 à la Table - API POST .

   • L'API renvoie la valeur ResponseStatus à votre variable de propriété de sortie.

     

Dans le corps de l’activité

To enter your Insert 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 - The id of the ServiceNow record that gets created. Enter a String variable. The sys_id is auto-generated by ServiceNow when you insert your new record. To retrieve this value for use in other activities, create and enter a String variable in the object wizard (example shown below).

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 insert. 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 .