Outil de chargement multi-fichiers

Vous pouvez sélectionner et télécharger plusieurs fichiers à l'aide de la commande Téléchargeur multi-fichiers , qui définit la valeur sous la forme d'une liste IResource .

Remarque :

Les Apps publiques ne prennent pas en charge la commande Téléchargeur multi-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 an ILocalResource

Important :

Les fonctions suivantes sont obsolètes et vous ne devez plus les utiliser :

• .toLocalResource
• .toAppsFile

Général

• Taille maximale du fichier : la taille maximale du fichier de chaque fichier que vous pouvez télécharger. La taille de fichier maximale recommandée est de 10 Mo.

  Remarque :

  Vous pouvez charger un maximum de 10 fichiers.

• Types de fichiers autorisés - les types de fichiers que vous pouvez télécharger. Utilisez une virgule , pour séparer les extensions de fichier. Par exemple, si vous écrivez .jpg, .png, .svg, vous ne pouvez charger que ces types de fichiers. Le symbole point . 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 définie sur 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é : si défini sur Vrai, masque la commande au moment du runtime.

Events

• Valeur modifiée - Configurez ce qui se passe lorsqu’un fichier est ajouté ou supprimé de la sélection.

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, par exemple verticale ou horizontale.

• Emplacement du libellé : par défaut, le libellé s'affiche en haut de la commande, aligné sur la gauche. Vous pouvez la placer à gauche de la commande sur la même ligne. La propriété Largeur du libellé configure la largeur du libellé, et la propriété Espace intermédiaire définit la distance entre le libellé et la commande.
• Police : attributs de police du libellé et du texte d'entrée, tels que la famille de polices, la taille, la couleur ou le style, tels que gras, italique et soulignement. Par défaut, la commande hérite de la famille de polices de son conteneur parent immédiat, indiqué par le mot-clé Hérité.
• Marge : la marge de la commande. Par défaut, une marque de 4px est définie. Les propriétés des marges Haut/Bas et Gauche/Droite sont combinées. Ces propriétés peuvent être dissociées à l'aide du bouton Lier sur le côté droit de la section Marge .
• 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, sélectionnez 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 utiliser le Téléchargeur multi-fichiers avec un compartiment de stockage :

1. Ouvrez une application existante ou créez-en une nouvelle.

• Ajoutez une commande Téléchargeur multi-fichiers .
• Sélectionnez Événements. Dans Valeur modifiée, sélectionnez Définir l'automatisation.

2. Ajoutez une activité Pour chaque qui va parcourir la sélection de fichiers.
   • Vous pouvez utiliser l'expression Controls.MainPage.MultiFileUploader.Value.
   • Ajoutez une activité Télécharger le fichier de stockage dans Pour chaque.
     • 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 currentIResource.
     • Dans le champ Où télécharger , sélectionnez l'expression currentIResource.FullName.
3. Testez ou exécutez votre application.

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