Download Activity Attachment

UiPath.MicrosoftDynamics.Activities.DownloadActivityAttachment

L’ activité Download Activity Attachment (Télécharger l’activité de pièce jointe) utilise l’opération Web API GET pour télécharger une pièce jointe spécifiée (AttachmentId) vers un emplacement spécifié (Folder), sous un nom nouveau ou existant (Filename).

Après avoir téléchargé la pièce jointe, 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 un identifiant d'annotation (par exemple, Insert Record, Upload Activity Attachment, Search Records).
4. Ajoutez l’ activité Download Activity Attachment (Télécharger l’activité de pièce jointe) à l’intérieur de l’activité Microsoft Dynamics Application Scope .
5. Entrez les valeurs des propriétés d' entrée .
6. 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 <a href=https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/webapi/retrieve-entity-using-web-api?view= dynamics-ce-odata-9 target="_blank">Demande d'opération GET.
   • L'opération renvoie la valeur ResponseStatus à votre variable de propriété de sortie.
     
     

     

     
     

Propriétés

Commun

• DisplayName : le nom complet de l'activité. Ce champ ne prend en charge que les chaînes ou les variables String .

Entrée

• AttachmentId : l'identifiant affecté à la pièce jointe que vous souhaitez télécharger. Ce champ prend uniquement en charge les variables Strings ou String . Pour obtenir la valeur AttachmentId , utilisez une activité ou exécutez un processus externe qui génère un identifiant de pièce jointe (par exemple, Insert Record, Upload Activity Attachment, Search Records).
• Dossier (Folder ) : le chemin d'accès local complet au dossier dans lequel vous souhaitez télécharger le fichier. Ce champ prend en charge uniquement les variables Strings ou String .
• Nom de fichier (Filename ) : le nouveau nom du fichier téléchargé. Ce champ ne prend en charge que les chaînes ou les variables String .
  • Par défaut, le fichier est enregistré à l'aide du nom de fichier de la pièce jointe. Si un fichier portant le même nom existe dans le Dossier, le fichier existant est écrasé.
  • Pour renommer le fichier (et éviter les écrasements indésirables), utilisez cette propriété pour saisir un nouveau nom de fichier avec l'extension de type (par exemple, DemoFile_Download.docx)

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.

Pour obtenir des instructions étape par étape et des exemples, consultez le guide de démarrage rapide .