Insert Record

UiPath.MicrosoftDynamics.Activities.InsertRecord

L'activité Insérer un enregistrement utilise l'opération POST de l'API Web pour insérer un nouvel enregistrement.

After inserting the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (MicrosoftDynamicsStatus) that you can use in subsequent activities (e.g., conditional logic).

Si la requête réussit, l’activité renvoie l’identifiant String attribué au nouvel enregistrement. Par exemple, si vous souhaitez insérer un compte, vous pouvez générer la valeur ICompte en ajoutant une variable String à l'aide du bouton de configuration (voir l'exemple ci-dessous).

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é Microsoft Dynamics Application Scope à votre projet.
3. Add the Insert Record activity inside the Microsoft Dynamics Application Scope activity.
4. Click the Configure button inside the Insert Record activity (this opens the Object Wizard).
5. Select the Object you want to insert and add the fields (with values) that you want to populate.
6. Créez et entrez une variable ResponseStatus pour la propriété Output .

   • Les valeurs de vos propriétés d'entrée sont envoyées dans la demande d'opération POST .

   • L'opération renvoie l'identifiant String et les valeurs ResponseStatus à vos variables de propriété de sortie.

     

Configurer

To enter your Insert Record property values, you must use the Object Wizard by clicking the Configure button.

Lorsque vous sélectionnez un objet à l'aide de l' Assistant d'objet, vous pouvez ajouter les champs que vous souhaitez inclure dans le nouvel enregistrement. Pour obtenir la liste complète des champs disponibles pour chaque objet, consultez le guide de référence du type d'entité de l'API Web dans la documentation Microsoft.

Propriétés

Avancé

• AdditionalFields - A DataRow that includes the columns and values that you want to insert. Enter a DataRow variable.
  • To determine/validate your DataRow column names, click the Configure button, select your Object, and review the names shown in the Field column; your DataRow column names must match the shown value.
  • If you enter a value for a field in both the Object Wizard and the AdditionalFields property, the value entered in the Object Wizard takes precedent (overwriting the AdditionalFields value).

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

• ResponseStatus - 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 .