Télécharger le fichier de stockage

Activité Télécharger le fichier de stockage qui télécharge un fichier dans un compartiment de stockage spécifié dans Orchestrator.

UiPath.Core.Activities.Storage.UploadStorageFile

Description

Charge un fichier dans un compartiment de stockage spécifié dans Orchestrator.

Remarque :

Autorisations d'Orchestrator

Cette activité s'exécute sous le compte Orchestrator du robot qui l'exécute. Il doit disposer des autorisations de rôle Orchestrator suivantes sur le dossier cible:

• Compartiments de stockage.Afficher: permet de résoudre le compartiment de stockage
• Fichiers de stockage.Créer: permet de télécharger ou d’écrire des fichiers dans le compartiment
• Folders.View (Dossiers).Afficher: permet de parcourir et de sélectionner le dossier Orchestrator

Dans les projets Windows et multiplate-forme avec le système 26.10.0 ou version ultérieure, l'activité stocke le fichier téléchargé avec son type de contenu (type MIME). Le type de contenu est extrait de l'extension du nom du fichier téléchargé, puis du type signalé par la ressource de fichier, puis de l'extension du fichier local.

Les compartiments suivants ne conservent pas le type de contenu, car Orchestrator le supprime:

• Compartiments système de fichiers locaux
• Compartiments chiffrés sur site
• Compartiments MinIO

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Configuration multiplateforme

• Chemin du dossier Orchestrator : le chemin du dossier Orchestrator que vous souhaitez utiliser avec cette activité. Si ce champ est laissé vide, le dossier Orchestrator actuel est utilisé. Ce champ ne prend en charge que les chaînes et les variables String . Utilisez / comme séparateur de sous-dossiers pour spécifier le dossier souhaité.
• Nom du compartiment de stockage : le nom du compartiment de stockage dans lequel vous souhaitez télécharger le fichier. Ce champ est obligatoire. Ce champ prend uniquement en charge les chaînes et les variables String.
• Fichier : le chemin complet du fichier que vous souhaitez télécharger vers le compartiment de stockage mentionné. Vous pouvez utiliser le basculement entre l'utilisation d'un chemin local ou d'une variable de type IResource . Si vous utilisez un chemin local, il est recommandé d'utiliser des chemins de dossier relatifs afin de tenir compte de la structure de fichier différente entre les machines Windows et Linux lors de l'exécution d'un projet. Exemple : newFolder/newFileName.txt.
• Chemin de destination : le chemin dans le compartiment de stockage où le fichier est téléchargé, y compris le nom du fichier. Une valeur qui se termine par / est utilisée comme dossier, comme toute valeur lorsque Nom du fichier chargé est défini, et le nom du fichier provient alors du nom du fichier chargé ou du fichier source. Une valeur vide charge le fichier à la racine du compartiment.
• Nom du fichier téléchargé— Le nom du fichier dans le compartiment de stockage. Lorsque ce paramètre est défini, il est ajouté au Chemin de destination, qui est ensuite utilisé comme dossier. S’il est laissé vide, le nom provient du chemin de destination ou, lorsqu’il s’agit d’un dossier ou vide, du fichier source.

Remarque :

Dans le concepteur, le chemin de destination propose une liste consultable des dossiers de compartiments, avec des entrées se terminant par /, telle que archive/, et l'actualise lorsque le dossier Orchestrator ou le compartiment change. Vous pouvez toujours saisir une valeur ou une expression. Dans les solutions Studio Web, le champ est en texte brut sans liste.

¹Pour les projets multiplateformes créés dans Studio Web dans le cadre d'une solution, le champ Chemin d'accès au dossier Orchestrator n'est pas disponible. Si l’activité disposait d’un chemin de dossier avant de faire partie de la solution, le champ s’affiche en lecture seule, et ce dossier remplace la ressource de la solution. La sélection à nouveau de la ressource supprime le dossier.

²Pour les projets multiplate-forme créés dans Studio Web dans le cadre d'une solution, le champ Nom propose des options pour Définir de nouvelles ressources Orchestrator, telles que des files d'attente, des ressources ou des compartiments de stockage, au moment de la conception, ou pour Ouvrir Orchestrator pour la gestion des ressources.

Options avancées

Autres

• Délai d'attente (millisecondes) : indique le délai d'attente (en millisecondes) pour la réponse d'Orchestrator ou pour la progression du transfert de fichier avant qu'une erreur soit générée. Il ne limite pas le temps de transfert total, de sorte que les fichiers volumineux utilisant des connexions lentes soient toujours terminés. La valeur par défaut est de 30 000 millisecondes (5 minutes). L'ouverture d'une connexion est toujours limitée à 30 secondes.

  Remarque :

  Sur un délai d'expiration, l'activité échoue avec une TimeoutException portant le code d'erreur Orchestrator_Sys_Timeout, de sorte que Continuer en cas d'erreur et Étendue de nouvelle tentative s'appliquent comme elles le font à toute autre erreur. Une valeur de 0 ou un nombre négatif est remplacé par 30 secondes, et l'annulation de la tâche est signalée comme une annulation plutôt qu'un délai d'expiration.

  Lorsqu'Orchestrator sert le contenu du fichier lui-même au lieu de transmettre une URL de fournisseur, ce qui est le cas sur le stockage géré par Orchestrator avec la fonctionnalité Features.Buckets.StorageOffloadRequiresAuth activée, le téléchargement doit également se terminer au total dans cette valeur.

• Continuer en cas d’erreur : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

  Remarque :

  Si cette activité est incluse dans Essayer de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

Windows - Héritage, configuration Windows

• Chemin de destination- Projets Windows uniquement. Le chemin d’accès dans le compartiment de stockage où le fichier est chargé, y compris le nom du fichier. Une valeur qui se termine par / est utilisée comme dossier, comme toute valeur lorsque Nom du fichier chargé est défini, et le nom du fichier provient alors du nom du fichier chargé ou du fichier source. Une valeur vide charge le fichier à la racine du compartiment. Ce champ prend uniquement en charge les chaînes et les variables String .
• Nom du fichier téléchargé— Projets Windows uniquement. Nom du fichier dans le compartiment de stockage. Lorsque ce paramètre est défini, il est ajouté au Chemin de destination, qui est ensuite utilisé comme dossier. S’il est laissé vide, le nom provient du chemin de destination ou, lorsqu’il s’agit d’un dossier ou vide, du fichier source. Si le fichier de destination existe déjà, il est écrasé.
• Destination- Projets Windows - Héritage uniquement. Le chemin dans le compartiment de stockage où vous souhaitez télécharger le fichier. Le séparateur de répertoire est \. Si le fichier de destination existe déjà, il est écrasé. Ce champ prend uniquement en charge les chaînes et les variables String .
• Fichier : le chemin complet du fichier que vous souhaitez charger dans le compartiment de stockage indiqué dans le champ Nom du compartiment de stockage . Ce champ prend en charge les variables de type IResource . Utilisez ce champ lorsque le fichier a été obtenu dynamiquement au cours de l’exécution, par exemple s’il s’agit de la pièce jointe d’un e-mail.
• Chemin : le chemin d’accès local complet au fichier que vous souhaitez télécharger vers le compartiment de stockage spécifié. Les chemins correspondants sont résolus à partir du répertoire d’exécution du runtime. Ce champ prend uniquement en charge les chaînes et les variables String. Utilisez ce champ lorsque le fichier se trouve dans le dossier du projet.
• Nom du compartiment de stockage : le nom du compartiment de stockage dans lequel vous souhaitez télécharger le fichier. Ce champ est obligatoire. Ce champ prend uniquement en charge les chaînes et les variables String.
  Important :

  Vous devez utiliser l’un ou l’autre de ces champs, car ils s’excluent mutuellement. Lorsque vous spécifiez un chemin local, utilisez toujours des chemins de dossier relatifs afin de garantir la compatibilité entre différentes structures de fichiers sur les systèmes Windows et Linux. Par exemple : newFolder/newFileName.txt.

Panneau propriétés

Commun

• Continuer en cas d’erreur : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

  Remarque :

  Si cette activité est incluse dans Essayer de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• NomAffichage : le nom affiché de l’activité.

• Délai d'attente (millisecondes) : indique le délai d'attente (en millisecondes) pour la réponse d'Orchestrator ou pour la progression du transfert de fichier avant qu'une erreur soit générée. Il ne limite pas le temps de transfert total, de sorte que les fichiers volumineux utilisant des connexions lentes soient toujours terminés. La valeur par défaut est de 30 000 millisecondes (5 minutes). L'ouverture d'une connexion est toujours limitée à 30 secondes.

  Remarque :

  Sur un délai d'expiration, l'activité échoue avec une TimeoutException portant le code d'erreur Orchestrator_Sys_Timeout, de sorte que Continuer en cas d'erreur et Étendue de nouvelle tentative s'appliquent comme elles le font à toute autre erreur. Une valeur de 0 ou un nombre négatif est remplacé par 30 secondes, et l'annulation de la tâche est signalée comme une annulation plutôt qu'un délai d'expiration.

  Lorsqu'Orchestrator sert le contenu du fichier lui-même au lieu de transmettre une URL de fournisseur, ce qui est le cas sur le stockage géré par Orchestrator avec la fonctionnalité Features.Buckets.StorageOffloadRequiresAuth activée, le téléchargement doit également se terminer au total dans cette valeur.

De (From)

• Fichier : le chemin complet du fichier que vous souhaitez charger dans le compartiment de stockage indiqué dans le champ Nom du compartiment de stockage . Ce champ prend en charge les variables de type IResource . Utilisez ce champ lorsque le fichier a été obtenu dynamiquement au cours de l’exécution, par exemple s’il s’agit de la pièce jointe d’un e-mail.
• Chemin : le chemin d’accès local complet au fichier que vous souhaitez télécharger vers le compartiment de stockage spécifié. Les chemins correspondants sont résolus à partir du répertoire d’exécution du runtime. Ce champ prend uniquement en charge les chaînes et les variables String. Utilisez ce champ lorsque le fichier se trouve dans le dossier du projet.
  Important :

  Vous devez utiliser l’un ou l’autre de ces champs, car ils s’excluent mutuellement. Lorsque vous spécifiez un chemin local, utilisez toujours des chemins de dossier relatifs afin de garantir la compatibilité entre différentes structures de fichiers sur les systèmes Windows et Linux. Par exemple : newFolder/newFileName.txt.

Divers

• Chemin du dossier Orchestrator : le chemin du dossier Orchestrator que vous souhaitez utiliser avec cette activité. Si ce champ est laissé vide, le dossier Orchestrator actuel sera utilisé. Ce champ prend uniquement en charge les chaînes et les variables String. Utilisez / comme séparateur de sous-dossiers pour spécifier le dossier souhaité.
• Privé : si cette option est sélectionnée, les valeurs des variables et des arguments ne seront plus enregistrées au niveau Détaillé.

Stockage

• Chemin de destination- Projets Windows uniquement. Le chemin d’accès dans le compartiment de stockage où le fichier est chargé, y compris le nom du fichier. Une valeur qui se termine par / est utilisée comme dossier, comme toute valeur lorsque Nom du fichier chargé est défini, et le nom du fichier provient alors du nom du fichier chargé ou du fichier source. Une valeur vide charge le fichier à la racine du compartiment. Ce champ prend uniquement en charge les chaînes et les variables String .
• Nom du fichier téléchargé— Projets Windows uniquement. Nom du fichier dans le compartiment de stockage. Lorsque ce paramètre est défini, il est ajouté au Chemin de destination, qui est ensuite utilisé comme dossier. S’il est laissé vide, le nom provient du chemin de destination ou, lorsqu’il s’agit d’un dossier ou vide, du fichier source. Si le fichier de destination existe déjà, il est écrasé.
• Destination- Projets Windows - Héritage uniquement. Le chemin dans le compartiment de stockage où vous souhaitez télécharger le fichier. Le séparateur de répertoire est \. Si le fichier de destination existe déjà, il est écrasé. Ce champ prend uniquement en charge les chaînes et les variables String .
• Nom du compartiment de stockage : le nom du compartiment de stockage dans lequel vous souhaitez télécharger le fichier. Ce champ est obligatoire. Ce champ prend uniquement en charge les chaînes et les variables String.