Update Record

UiPath.MicrosoftDynamics.Activities.UpdateRecord

L’activité Mettre à jour un enregistrement utilise l’opération PATCH de l’API Web pour mettre à jour un enregistrement.

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

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. Ajoutez une activité ou exécutez un processus externe qui génère l'identifiant de l'enregistrement (par exemple, Insert Record, Search Records).
4. Add the Update Record activity inside the Microsoft Dynamics Application Scope activity.
5. Click the Configure button inside the Update Record activity (this opens the Object Wizard).
6. Select the Object you want to update, enter the record identifier, and add the fields (with values) that you want to update.
7. 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 requête d'opération PATCH .

   • L'opération renvoie les ResponseStatus et les valeurs à votre variable de propriété de sortie.

     

Propriétés

Les valeurs des propriétés suivantes sont spécifiées lors de l'ajout de cette activité à votre projet dans UiPath Studio.

Configurer

To enter your Update 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 mettre à jour. 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.

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 .