🟦 Sélection de fichier

Le bloc Sélection de fichier permet de déclencher l'ouverture du sélecteur de fichiers de l'appareil (navigateur ou système) pour permettre à l'utilisateur d'importer un ou plusieurs fichiers depuis son appareil vers le graphe Celestory.

Ce bloc est essentiel pour les fonctionnalités d'import de documents, comme l'envoi de CV, de pièces jointes, de sauvegardes ou de médias.

📥 Entrées

• multiple (Booléen, désactivé par défaut) : à activer pour permettre à l'utilisateur de choisir plusieurs fichiers en une seule fois. Si désactivé, un seul fichier peut être sélectionné.
• Aucune autre entrée obligatoire : le bloc s'active via le flux entrant et ouvre directement le sélecteur de fichiers.

📤 Sorties

• out (Flux) : Signal indiquant que la sélection (et le chargement) du ou des fichiers est terminée, permettant de poursuivre le flux en toute sécurité.
• file (Ressource Fichier) : Le fichier choisi par l'utilisateur, exploitable dans le graphe. Présent quand "multiple" est désactivé.
• files (Liste de fichiers) : La liste des fichiers choisis par l'utilisateur. Remplace la sortie "file" quand "multiple" est activé.

💡 Exemple d'utilisation

Scénario : Import d'une photo de profil utilisateur

1. L'application affiche un écran demandant à l'utilisateur de choisir une photo de profil.
2. Un bouton "Sélectionner une image" est cliqué, déclenchant le passage du flux vers le bloc Sélection de fichier.
3. L'explorateur de fichiers système s'ouvre, permettant à l'utilisateur de naviguer et de choisir un fichier (ex: profil.jpg).
4. Une fois le fichier sélectionné, le bloc génère la sortie file contenant la ressource, et la sortie out signale la fin du processus.
5. Le flux se poursuit vers un bloc de traitement d'image (ex: redimensionnement) ou d'enregistrement dans une base de données.

⚙️ Détails Techniques

• Contraintes de sécurité : Le bloc doit être déclenché par une action utilisateur explicite (ex: clic sur un bouton) pour éviter les blocages par les navigateurs ou les politiques CORS.
• Gestion des erreurs : Si l'utilisateur annule la sélection, le flux peut être redirigé vers une alternative (ex: message d'erreur ou retour en arrière).
• Sélection multiple : Activer "multiple" change aussi la sortie du bloc, qui passe de "file" (un seul fichier) à "files" (une liste de fichiers).

Version documentée : v2

Mis à jour le : 23/09/2026