🟦 Sélection de fichier
🟦 Sélection de fichier
Le bloc Sélection de fichier permet de déclencher l'ouverture de l'explorateur de fichiers système (navigateur ou OS natif) pour permettre à l'utilisateur d'importer un fichier depuis son appareil local vers le graphe Celestory.
Ce composant 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
- filtre_extension (Texte, optionnel) : Permet de restreindre les types de fichiers acceptés (ex:
.pdf,.jpg). Si non spécifié, tous les types de fichiers sont autorisés. - Aucune entrée obligatoire : Le bloc s'active via le flux courant et utilise les paramètres système pour lancer la sélection.
📤 Sorties
- fichier (Ressource Fichier/Image) : Objet représentant le fichier sélectionné par l'utilisateur, exploitable dans le graphe.
- terminé (Stream) : Signal indiquant que la sélection et le chargement du fichier sont finalisés, permettant de poursuivre le flux en toute sécurité.
💡 Exemple d'utilisation
Scénario : Import d'une photo de profil utilisateur
- L'application affiche un écran demandant à l'utilisateur de choisir une photo de profil.
- Un bouton "Sélectionner une image" est cliqué, déclenchant le passage du flux vers le bloc Sélection de fichier.
- L'explorateur de fichiers système s'ouvre, permettant à l'utilisateur de naviguer et de choisir un fichier (ex:
profil.jpg). - Une fois le fichier sélectionné, le bloc génère la sortie fichier contenant la ressource, et la sortie terminé signale la fin du processus.
- 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).
- Types MIME : Le filtre d'extensions utilise les types MIME pour valider les fichiers acceptés (ex:
application/pdfpour les PDF).
Mis à jour le : 04/03/2026
Merci !
