L’éditeur de flux sert à créer et modifier les flux. Vous placez des blocs sur un canevas, reliez leurs sorties aux entrées d’autres blocs, renseignez leurs paramètres et déployez. Le brouillon est enregistré au fil de votre travail ; rien ne s’exécute tant que vous n’avez pas déployé.
Créer un flux
- Ouvrez Automatisation. La liste affiche tous les flux de tous les hôtes, les flux racines en premier.
- Sélectionnez Nouveau flux.
- Remplissez la boîte de dialogue :
| Champ | Signification |
|---|---|
| Hôte | IoT ou Général. « Où le flux s’exécute et quels blocs il peut utiliser. Ce choix ne peut plus être modifié. » |
| Nom | Le nom du flux |
| Slug | Son identifiant court : lettres minuscules, chiffres, - et _, jusqu’à 32 caractères. Il ne peut plus être modifié. |
| Point de départ | Un flux vide, ou un modèle de l’hôte. Voir Modèles de flux. |
- Sélectionnez Créer. L’éditeur s’ouvre.
Chaque flux possède dès le départ un bloc Entrée du flux. C’est le point d’entrée des messages transmis par un autre flux et, pour un flux racine, le point d’entrée des messages de ses appareils. Il ne peut pas être supprimé ; laissez-le non connecté si aucun flux ne transmet de messages à celui-ci.
L’éditeur en un coup d’œil
| Zone | Contenu |
|---|---|
| Barre supérieure | Le nom et l’état du flux, l’état d’enregistrement (Enregistrement…, Enregistré, Pas encore enregistré), les indicateurs en temps réel (En direct ou Toutes les 5 s, messages par seconde, messages en attente, erreurs sur 24 h) et les boutons Activité, Webhooks, Test, Versions, Messages en échec, Abandonner le brouillon et Déployer |
| Palette | Types de blocs : tous les blocs de l’hôte, par ordre alphabétique, avec une zone de recherche |
| Canevas | Les blocs et leurs liaisons |
| Panneau latéral | Les paramètres du bloc sélectionné, ou le panneau Activité |
Webhooks apparaît dès qu’un flux déployé possède un déclencheur Webhook. Versions apparaît après le premier déploiement. Abandonner le brouillon apparaît tant que le brouillon diffère de la version déployée.
Ajouter des blocs
- Faites glisser un bloc depuis la palette vers le canevas, ou cliquez dessus.
- Ou faites un clic droit sur le canevas et choisissez Ajouter un bloc ici…, ou faites un clic droit sur une liaison et choisissez Ajouter un bloc entre…. Le sélecteur Ajouter un bloc recherche par nom, description ou type.
- Un bloc inutilisable apparaît grisé, avec la raison : « Votre offre ne comprend pas ce bloc. », « Ce bloc nécessite une configuration qui n’est pas encore définie. », « Le module auquel appartient ce bloc n’est pas installé. », « Ce bloc ne s’exécute pas sur l’hôte de ce flux. » ou « Vous avez besoin de l’autorisation … pour utiliser ce bloc. »
Relier les blocs
- Faites glisser depuis un port de sortie (côté droit d’un bloc) vers un port d’entrée (côté gauche d’un autre).
- Un bloc peut avoir plusieurs sorties, par exemple oui et non, ou une par règle d’un Switch. Survoler un port affiche son nom.
- La plupart des blocs ont aussi une sortie erreur. Reliez-la pour gérer vous-même les erreurs de ce bloc ; sinon, les erreurs vont aux déclencheurs Catch du flux. Voir Blocs déclencheurs.
- Pour déplacer l’extrémité d’une liaison, faites glisser sa poignée vers un autre port. Pour changer la sortie d’où part une liaison, faites un clic droit dessus et choisissez Changer le port….
- Sélectionnez une liaison et appuyez sur Supprimer, ou faites un clic droit dessus et choisissez Supprimer la connexion.
Une fois le flux exécuté, les liaisons affichent un nombre de messages (« 12 messages »).
Modifier un bloc
Cliquez sur un bloc. Le panneau latéral s’ouvre avec trois onglets :
| Onglet | Affiche |
|---|---|
| Paramètres | Libellé, Description (une note pour les personnes, sans effet) et les paramètres propres au bloc. « Les modifications s’appliquent pendant la saisie. Annulez avec Ctrl+Z. » |
| Messages | Les derniers messages ayant traversé le bloc, Entrée et Sortie, avec Tester avec cette entrée. Le contenu des messages n’est visible que pour les personnes autorisées à déboguer. |
| Aide | La référence du bloc : ce qu’il fait, ses ports et ses paramètres |
Les paramètres qui prennent une valeur permettent de choisir leur type : Nombre, Texte, Oui / non, JSON, Variable (un chemin tel que msg.payload.level ou flow.limit), Expression, Variable d’environnement ou Heure actuelle. Les paramètres qui choisissent une connexion (un courtier MQTT, un point de terminaison HTTP) listent vos connexions de ce type, avec Gérer les connexions. Voir Connexions et secrets.
Le bloc Script ouvre un éditeur de code avec recherche et remplacement, mise en forme, plein écran et Tester le script. Voir Le bloc script.
Travailler avec plusieurs blocs
| Action | Méthode |
|---|---|
| Sélectionner plusieurs blocs | Maj ou Ctrl + clic, ou maintenez Maj et faites glisser un cadre (Sélectionner les blocs avec un cadre) |
| Copier, couper, coller, dupliquer | Le menu du clic droit ou les raccourcis clavier habituels |
| Grouper | Sélectionnez, faites un clic droit, Grouper… ; donnez un nom et une couleur au groupe |
| Commenter | Faites un clic droit sur le canevas, Ajouter un commentaire ici. Les commentaires n’ont aucun effet à l’exécution du flux. |
| Ignorer un bloc | Clic droit, Ignorer : le bloc reste mais ne s’exécute pas |
| Ranger | Organiser les blocs dans la barre d’outils |
| Rechercher | Rechercher un bloc cherche dans les noms, types, descriptions et identifiants |
| Naviguer | Zoom avant et arrière, Ajuster à l’écran, Mini-carte, Plein écran |
Appuyez sur ? sur le canevas pour afficher les raccourcis clavier.
Problèmes
L’éditeur vérifie le flux au fur et à mesure de sa construction. Les problèmes sont signalés sur les blocs et listés sous Problèmes :
| Problème | Signification |
|---|---|
| « Paramètre est obligatoire. » | Renseignez le paramètre. |
| « Ce bloc n’est relié à rien. » / « Rien n’est relié à ce bloc. » | Reliez-le ou supprimez-le. |
| « Un flux ne peut avoir qu’un seul bloc Entrée du flux. » | Supprimez le bloc en trop. |
| « Ces blocs envoient des messages en boucle sans jamais attendre… » | Placez un bloc d’attente (un délai, une minuterie, un appel) dans la boucle, ou rompez-la. |
| « Un bloc Exécuter le flux ne peut pas exécuter son propre flux. » | Choisissez un autre flux. |
| « Ce bloc n’est pas disponible ici. Il conserve ses connexions mais ne peut pas s’exécuter. » | Le bloc provient d’un import et n’existe pas sur cet hôte. |
Un flux comportant des erreurs ne peut pas être déployé : « Corrigez d’abord les problèmes signalés sur le canevas. »
Enregistrement
Le brouillon est enregistré automatiquement sur le serveur au fil de vos modifications. L’état d’enregistrement affiche Enregistrement…, Enregistré ou « Non enregistré. Réessayer ». Les modifications non enregistrées sont aussi conservées dans votre navigateur : si vous quittez puis revenez, l’éditeur propose de les restaurer.
Si quelqu’un d’autre a enregistré le même flux entre-temps, l’éditeur affiche « Ce flux a été enregistré par quelqu’un d’autre » avec :
- Fusionner : conserve ce qu’un seul des deux côtés a modifié et enregistre le résultat comme brouillon. Vérifiez-le avant de déployer ; Annuler vous ramène à votre version.
- Écraser avec la mienne : conserve votre version.
Déploiement
- Sélectionnez Déployer. La boîte de dialogue « Déployer nom » indique : « Cela devient la version n du flux et démarre son exécution. »
- Lisez les avertissements et la liste des modifications, s’il y en a.
- Choisissez Ce qui redémarre : Seulement les blocs modifiés (par défaut), Chaque bloc des flux modifiés ou Chaque flux de cet hôte. Les blocs qui ne redémarrent pas conservent leur mémoire.
- Laissez Exécuter le flux après le déploiement coché pour l’exécuter, ou décochez-le pour le déployer désactivé.
- Vous pouvez éventuellement rédiger une Note (« Ce qui a changé »). Elle apparaît dans la liste des versions.
- Si le flux contient des blocs qui agissent hors de lui (risque Code, Contrôle, Externe ou Système), la boîte de dialogue les liste : cochez Je comprends ce que font ces blocs et saisissez le nom du flux.
- Sélectionnez Déployer (ou Confirmer et déployer).
Un déploiement peut être refusé : à cause d’un problème, d’une limite de forfait (« Votre forfait autorise n flux : … »), d’une autorisation manquante, ou parce que quelqu’un a déployé entre-temps. La boîte de dialogue indique la raison. Voir Limites de flux.
Un flux qui est une racine doit rester activé et approuvé : « Ce flux est une racine, il doit donc rester activé et approuvé : sinon, les données des appareils ne seraient pas stockées. »
Flux en lecture seule
Vous voyez « Vous pouvez consulter ce flux mais non le modifier. » lorsque vous n’avez pas l’autorisation de gérer l’automatisation, lorsque le flux est supprimé (restaurez-le d’abord), ou lorsqu’un module l’a créé (une règle de la carte Rules, badge Built by). Voir Hôtes, le flux racine et les flux racines de profil et Versions, tests et retour arrière.