Update Record

UiPath.MicrosoftDynamics.Activities.UpdateRecord

L'activité Mettre à jour l'enregistrement ( Update Record ) utilise l'opération Web API PATCH pour mettre à jour un enregistrement.

Après la mise à jour de l'enregistrement, l'activité génère le statut de la demande (informations de réussite/échec) dans un objet ResponseStatus (MicrosoftDynamicsStatus) que vous pouvez utiliser dans les activités suivantes (par exemple, la logique conditionnelle).

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 de l'application Microsoft Dynamics ( 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. Ajoutez l’activité Mettre à jour l’ enregistrement (Update Record ) à l’intérieur de l’activité Étendue de l’application Microsoft Dynamics .
5. Cliquez sur le bouton Configurer (Configure) à l'intérieur de l'activité Mettre à jour l'enregistrement ( Update Record ) (cela ouvre l ' Assistant Objet).
6. Sélectionnez l' objet que vous souhaitez mettre à jour, entrez l'identifiant de l'enregistrement et ajoutez les champs (avec les valeurs) que vous souhaitez mettre à jour.
7. Créez et entrez une variable ResponseStatus pour la propriété Sortie (Output).
   • Vos valeurs de propriété d'entrée sont envoyées dans la demande 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

Pour saisir les valeurs de votre propriété Mettre à jour l'enregistrement ( Update Record ), vous devez utiliser l' Assistant Objet en cliquant sur le bouton Configurer (Configure).

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 Web API EntityType Reference dans la documentation Microsoft.

Propriétés

Avancé

• AdditionalFields - Un DataRow qui inclut les colonnes et les valeurs que vous souhaitez insérer. Saisissez une variable DataRow .
  • Pour déterminer/valider les noms de vos colonnes DataRow , cliquez sur le bouton Configurer (Configure), sélectionnez votre objetet examinez les noms affichés dans la colonne Champ ; vos noms de colonne DataRow doivent correspondre à la valeur affichée.
  • Si vous entrez une valeur pour un champ à la fois dans l' Assistant Objet et dans la propriété AdditionalFields , la valeur saisie dans l' Assistant Objet prévaut (en remplaçant la valeur AdditionalFields ).

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

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

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 .