Outil de chargement multi-fichiers

You can select and upload multiple files using the Multi File Uploader control, which sets the value as an IResource list.

Remarque :

Public Apps do not support the Multi File Uploader control.

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 :

The following functions have been deprecated and you should no longer use them:

• .toLocalResource
• .toAppsFile

Général

• Max file size - The maximum file size of each file you can upload. The recommended maximum file size is 10 MB.

  Remarque :

  You can upload a maximum of 10 files.

• Allowed file types - The file types you can upload. Use a comma , to separate file extensions. For example, if you write .jpg, .png, .svg, you can only upload these file types. The dot . symbol is not mandatory when listing the file types.

• 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.

• Required - If set to true, app users must provide data in the control. To mark the control as mandatory at runtime, an asterisk (*) is added after the label text.

• 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.

• Hidden - If set to true, hides the control at runtime.

Events

• Value Changed - Configure what happens when a file is added or removed from the selection.

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 :

The alignment is dependent on the layout selected for the parent, such as Vertical or Horizontal.

• Label Placement - By default, the label is displayed on top of the control, aligned to the left. You can place it to the left of the control on the same line. The Label Width property configures how wide the label should be, and the Space between property sets the distance between the label and the control.
• Font - The font attributes for both the label and the input text, such as font family, size, color, or style, such as bold, italic, and underline. By default, the control inherits the font family of the immediate parent container, indicated by the keyword Inherited.
• Margin - The margin of the control. By default, a margin of 4px is set. Top/Bottom and Left/Right margin properties are combined. These properties can be detached using the Link button on the right side of the Margin section.
• Size - The width and height of the control. By default, the size is set to auto. To set minimum or maximum values, select the three-dot icon (...).

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	Determines the visibility of the File Uploader control. If set to true, hides the control at 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	Checks validity of the File Uploader value. If true, indicates it is valid.

Utilisation du téléchargeur de fichiers

This example shows how you can use the Multi File Uploader with a storage bucket:

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

• Add a Multi File Uploader control.
• Select Events. In Value Changed, select Define automation.

2. Add a For Each activity that iterates over the file selection.
   • You can use the expression Controls.MainPage.MultiFileUploader.Value.
   • Add an Upload Storage File activity in For Each.
     • 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.

When you run the app and add multiple files in the Multi File Uploader, the app uploads the storage file to the storage bucket.