Téléchargeur de fichiers

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 (Allowed file types) : 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 (Required) : 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 ( File Uploader) ne peut télécharger qu'un seul fichier à la fois.

• Les applications Web d'un navigateur mobile ne prennent pas en charge les téléchargements de photos en mode natif. 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 (Vertical vs Horizontal).

• 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 (Size) : 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 (...).

Utilisation du téléchargeur de fichiers

Cet exemple montre comment vous pouvez utiliser le Téléchargeur de fichiers (File Uploader) avec un compartiment de stockage et avec un champ de fichier d'une entité.

1. Dans votre application, ajoutez un compartiment de stockage et une entité Data Service contenant des champs de fichier.
2. Ajoutez un Téléchargeur de fichiers (File Uploader) et une commande Bouton (Button).
3. Créez une variable de type FichierApps et nommez-la « SB_file_var ». Utilisez cette variable pour stocker le fichier téléchargé à partir du compartiment de stockage.
4. Ajoutez la règle Télécharger le fichier dans le compartiment de stockage (Upload file to Storage Bucket) à l'événement Cliqué (Clicked on) de la commande de bouton.
   1. Dans le champ Fichier à télécharger (File to upload), référencez le fichier téléchargé via la commande Téléchargeur de fichiers (File Uploader), comme suit :

      MainPage.FileUploader.Value

   2. Dans le champ Compartiment de stockage (Storage bucket), référencez le compartiment de stockage Orchestrator que vous avez précédemment ajouté à votre application.
   3. Dans le champ Une fois terminé (When completed), vous pouvez également ajouter une règle Afficher le message (Show Message) pour vous informer que le téléchargement s'est terminé avec succès.
5. Ajoutez la règle Télécharger un fichier depuis un compartiment de stockage (Dowload file from Storage Bucket) à l'événement Cliqué (Clicked on) de la commande de bouton.
   1. Dans le champ Compartiment de stockage (Storage bucket), référencez le compartiment de stockage Orchestrator que vous avez précédemment ajouté à votre application.
   2. Dans le champ Nom de fichier (avec extension) (File Name (with extension), écrivez le nom du fichier que vos utilisateurs doivent télécharger.
   3. Dans Attribuer un fichier à la variable d'application (Assign file to app variable), référencez la variable précédemment créée « SB_file_var ».
   4. Dans le champ Une fois terminé (When completed), vous pouvez également ajouter une règle Afficher le message (Show Message) pour vous informer que le téléchargement s'est terminé avec succès.
6. Ajoutez une commande Libellé (Label) à votre application.
   1. Dans le champ Texte (Text) de la commande, référencez le nom du fichier téléchargé, comme suit :

      SB_file_var.Name

      - où « SB_file_var » est la variable utilisée pour stocker les données relatives au fichier téléchargé.

7. Exécutez votre application et téléchargez un fichier à l'aide de la commande Téléchargeur de fichiers (File Uploader). Cliquez sur le bouton.

Un message de réussite devrait apparaître en haut de votre écran pour vous informer que le chargement/téléchargement a été effectué avec succès. Vérifiez maintenant le compartiment de stockage dans Orchestrator et vous devriez voir le fichier que vous avez téléchargé à l'aide de la commande Téléchargeur de fichiers (File uploader).

Simultanément, en cliquant sur le bouton, vous téléchargez le fichier indiqué dans la règle Télécharger un fichier depuis un compartiment de stockage (Download file from Storage Bucket) sur votre appareil local et vous enregistrez ses données dans une variable. La commande Libellé (Label) affiche le nom du fichier téléchargé.

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 ( File Uploader), généralement le texte affiché avant la commande.
Value	AppsFile	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 ( File Uploader ). Si défini sur true, masque la commande au moment du runtime.
Disabled	Booléen	Détermine si la commande Téléchargeur de fichiers ( File Uploader) peut avoir une interaction. S’il est défini sur Vrai, désactive l’interaction avec le téléchargeur de fichiers au moment du runtime.
IsValid	Booléen	Vérifie la validité de la valeur du Téléchargeur de fichiers (File Uploader). Si True, indique qu'il est valide.