Téléchargeur de fichiers

Les applications UiPath prennent désormais en charge le format IResource pour la gestion des fichiers.

Remarque :

Les applications publiques ne prennent pas en charge la commande Téléchargeur de fichiers .

Utilisation d’IResource

Si vous obtenez un fichier en tant que ILocalResource, il est automatiquement converti en IResource à l'aide de :

JobAttachment.fromResource(file) // file is a ILocalResource

Important :

Les fonctions suivantes sont obsolètes et ne doivent plus être utilisées :

• .toLocalResource
• .toAppsFile

Général

• Taille maximale du fichier (Max file size) : la taille maximale du fichier que les utilisateurs peuvent télécharger. La taille de fichier maximale recommandée est de 10 Mo.
• Types de fichiers autorisés : les types de fichiers que les utilisateurs peuvent télécharger. Utilisez « ,» pour séparer les extensions de fichiers. Par exemple, si vous saisissez .jpg, .png, .svg, seuls ces types de fichiers sont autorisés à être chargés. Le symbole . n'est pas obligatoire lors de l'énumération des types de fichiers.
• Texte d'aide (Helper Text) : texte d'aide à afficher au moment du runtime.
• Info-bulle (Tooltip) : le texte à afficher lorsqu'un utilisateur de l'application pointe sur la commande. Utilisez cette option pour fournir des informations supplémentaires sur la commande.
• Libellé (Label) : le texte affiché de la commande.
• Obligatoire : si la valeur est true, les utilisateurs de l'application doivent fournir des données dans la commande. Pour marquer la commande comme obligatoire au moment du runtime, un astérisque * est ajouté après le texte du libellé.
• Message d'erreur personnalisé (Custom error message) : le texte à afficher si la propriété Requis (Required) est définie sur true et que la commande est laissée vide.
• Masqué (Hidden) : si la valeur est true, masque la commande au moment du runtime.
• Désactivé (Disabled) : si la valeur est true, désactive la commande au moment du runtime.
  Remarque :

  • La commande Téléchargeur de fichiers ne peut télécharger qu'un seul fichier à la fois.
  • Les applications d'un navigateur mobile ne prennent pas en charge les téléchargements de photos natifs basés sur une caméra. Au lieu de cela, enregistrez la photo sur votre appareil, puis téléchargez le fichier enregistré à l'aide de la commande Téléchargeur de fichiers (File Uploader).

Events

• Fichier ajouté : configure ce qui se passe lorsqu'un fichier est ajouté.
• Fichier supprimé : configure ce qui se passe lorsqu'un fichier est supprimé.

Style

• Alignement de commande (Control Alignment) : hérite de l'alignement parent par défaut. Un autre alignement que le parent peut être défini. Pour revenir par défaut à l'alignement parent, désélectionnez les options remplacées.

  Remarque :

  L'alignement dépend de la mise en page sélectionnée pour le parent.

• Emplacement du libellé (Label Placement) : par défaut, le libellé est configuré pour être affiché en haut de la commande, sur le côté gauche. Vous pouvez la placer à gauche de la commande, sur la même ligne. La propriété Largeur du libellé (Label Width) configure la largeur du libellé, et la propriété Espace intermédiaire (Space between) définit la distance entre le libellé et la commande.

• Police (Font) : attributs de police du libellé et du texte d'entrée, tels que la famille de polices, la taille, la couleur ou le style (gras, italique et souligné). Par défaut, la commande hérite de la famille de polices de son conteneur parent immédiat, qui est indiqué par le mot-clé « Inherited ».

• Marge (Margin) : la marge de la commande. Par défaut, une marque de 4px est définie. Les propriétés des marges Haut/Bas (Top/Bottom)et Gauche/Droite (Left/Right) sont combinées. Ces propriétés peuvent être dissociées à l'aide du bouton Lier (Link) sur le côté droit de la section Marge (Margin).

• Taille : largeur et hauteur de la commande. Par défaut, la taille est définie sur auto. Pour définir des valeurs minimales ou maximales, cliquez sur l'icône à trois points (*).

Propriétés VB

Propriété VB	Type de données	Description
Tooltip	Chaîne de caractères (string)	Texte d'information qui apparaît lorsque l'utilisateur survole le Téléchargeur de fichiers.
Label	Chaîne de caractères (string)	Le libellé du Téléchargeur de fichiers, généralement affiché avant la commande.
Value	IResource	Nom du fichier actuellement téléchargé.
Required	Booléen	Spécifie si le téléchargement du fichier est obligatoire.
RequiredErrorMessage	Chaîne de caractères (string)	Message affiché lorsque le téléchargement de fichier est requis, mais n'a pas été fourni.
Hidden	Booléen	Détermine la visibilité de la commande Téléchargeur de fichiers . Si défini sur Vrai, masque la commande au moment du runtime.
Disabled	Booléen	Détermine si la commande Téléchargeur de fichiers est interagissante. S’il est défini sur Vrai, désactive l’interaction avec le Téléchargeur de fichiers au moment de l’exécution.
IsValid	Booléen	Vérifie la validité de la valeur du Téléchargeur de fichiers. Si la valeur est définie sur true, indique qu'elle est valide.

Utilisation du téléchargeur de fichiers

Cet exemple montre comment vous pouvez utiliser le Téléchargeur de fichiers avec un compartiment de stockage.

1. Ouvrez une application existante ou créez-en une nouvelle.
   • Ajoutez une commande Téléchargeur de fichiers .
   • Sélectionnez Événements. Dans Fichier ajouté, sélectionnez Définir l'automatisation.
2. Ajoutez une activité Télécharger le fichier de stockage à votre workflow.
   • Spécifiez le chemin d'accès au dossier Orchestrator et le nom du compartiment de stockage.
   • Dans le champ Fichier , sélectionnez l'expression Controls.MainPage.FileUploader.Value.
   • Dans le champ Où télécharger , sélectionnez l'expression Controls.MainPage.FileUploader.Value.FullName.
3. Testez ou exécutez votre application.

Lorsque vous exécutez l'application et ajoutez un fichier dans le Téléchargeur de fichiers, l'application télécharge le fichier de stockage dans le compartiment de stockage.