Le bloc Then énumère ce que fait une règle, « In this order » (dans cet ordre). Une règle comporte de 1 à 20 actions, en comptant les actions contenues dans les choix. Cliquez sur Add an action, choisissez le type, puis utilisez Move up / Move down pour les ordonner.
| Type | Fait |
|---|---|
| Envoyer une commande | Envoie une commande du catalogue du profil d’appareil. |
| Modifier un paramètre | Écrit un réglage sur l’appareil. |
| Prévenir les personnes concernées | Envoie une notification. |
| Déclencher ou acquitter une alarme | Ouvre ou efface une alarme avec le cycle de vie habituel. |
| Attendre | Marque une pause avant l’étape suivante. |
| Attendre qu’une condition soit remplie | Marque une pause jusqu’à ce qu’une condition soit remplie, avec une limite de temps. |
| Choisir selon une condition | Exécute différentes étapes selon des conditions. |
| Basculer ou démarrer une autre règle | Active ou désactive une autre règle du site, ou la démarre. |
Envoyer une commande
Choisissez le Device (un appareil ou tous les appareils d’un profil) et une Command du catalogue du profil, puis ses paramètres. À l’enregistrement, on vérifie que la commande existe pour chaque appareil atteint et que ses valeurs conviennent (« This device type has no such command. », « The command’s values do not fit it. »). L’enregistrement est refusé si vous n’êtes pas autorisé à envoyer cette commande vous-même (les commandes ont des niveaux avec leurs propres autorisations).
La commande part comme toute autre commande, avec son délai d’attente et son historique dans les commandes de l’appareil. Un appareil en Manual est ignoré : « skipped: device is in Manual ». Voir Sending commands to devices.
Modifier un paramètre
Choisissez le Device, saisissez le Setting (une clé, jusqu’à 128 caractères) et la valeur après to. Une valeur qui ressemble à un nombre est envoyée comme nombre, toute autre comme texte.
Le réglage est écrit comme shared attribute de chaque appareil, si bien que l’appareil le reçoit comme tout attribut partagé auquel il est abonné. Un appareil en Manual est ignoré. Voir Attributes.
Informer les utilisateurs
| Champ | Signification |
|---|---|
| Qui | Cochez Owners, Admins et/ou Members (les rôles de votre organisation). |
| Message | Le texte, jusqu’à 1 000 caractères. |
Le titre de la notification est le nom de la règle. Elle parvient à chaque personne par les canaux qu’elle autorise. La carte propose des rôles ; l’API des règles accepte aussi des utilisateurs individuels et des équipes, jusqu’à 20 destinataires. Un rôle comptant plus de 20 membres actifs est refusé plutôt que d’informer à moitié. Les répétitions de la même notification à la même personne sont retenues pendant un délai de 10 minutes, sauf si votre forfait en prévoit un autre. Détails : Notifications from rules and flows.
Déclencher ou acquitter une alarme
| Champ | Signification |
|---|---|
| Déclencher / Acquitter | Ouvre ou met à jour une alarme, ou l’efface. |
| Équipement | Un appareil, tous les appareils d’un profil, ou (sur la carte d’un appareil) on this place. |
| Type d’alarme | Le type, par exemple pump_dry_run. |
| Gravité | Pour Raise : Critical, Major, Minor, Warning ou Info (par défaut Warning). |
Ces alarmes se comportent comme les alarmes de règle : une seule alarme active par appareil et par type, les mêmes notifications, le même anti-rebond et la même protection contre les rafales. Une alarme ouverte reste ouverte jusqu’à une action Clear, un flux ou une personne qui l’efface ; elle n’a pas de condition propre.
Attente
Wait for un nombre de seconds ou de minutes, de 1 seconde à 24 heures. Après l’attente, la règle vérifie que le site est toujours en Auto (« Still in Auto? ») ; si le site est passé en Manual entre-temps, l’exécution s’arrête à cet endroit.
Attendre qu’une condition soit remplie
Une condition (tout type issu de Conditions), for at most une durée (de 1 seconde à 24 heures, par défaut 10 minutes), et ce qu’il faut faire en cas de dépassement : then go on ou then stop.
La condition est vérifiée de nouveau toutes les 5 secondes sur les valeurs stockées. Lorsqu’elle est remplie, l’exécution se poursuit immédiatement. Contrairement à « reste ainsi pendant », une exécution en attente ne survit pas à un redémarrage de la plateforme.
Choisir selon une condition
Jusqu’à 5 branches, chacune If une condition then certaines actions, et un Otherwise facultatif. La première branche dont la condition est remplie s’exécute ; si aucune ne l’est, Otherwise s’exécute. Les choix peuvent contenir des choix, sur 2 niveaux. Les actions contenues comptent dans les 20.
Activer ou démarrer une autre règle
Choisissez une Rule du même site et :
| Choix | Fait |
|---|---|
| Activer / Désactiver | Active ou désactive cette règle, comme le ferait son interrupteur. |
| La démarrer (doit être la dernière étape) | Transmet l’exécution à cette règle. Elle doit être la dernière étape de la règle, ou des branches de son dernier choix : « Starting another rule hands the run over to it, so it has to be the last step. » |
Une règle ne peut pas s’activer, se désactiver ou se démarrer elle-même. Les options Manual et de chevauchement de la règle démarrée s’appliquent.
Plusieurs appareils
Une action sur Every profile s’exécute une fois pour chaque appareil de ce profil dans le site, jusqu’à 200 appareils ; les appareils au-delà ne sont pas concernés, et le journal d’exécution le signale. Les appareils en Manual sont exclus des commandes et des réglages.
Options
| Option | Choix |
|---|---|
| S’il se déclenche alors qu’il est encore en cours d’exécution | Ignore the new one (par défaut), Wait for the one running, then run, Run them side by side, Start over: stop the one running at its next wait |
| Au maximum | Pour « wait » et « side by side » : de 1 à 10 exécutions en attente ou simultanées. |
| Fonctionne aussi en mode Manual | « Only for a rule that just tells people or raises alarms. » |
Remarques :
- Attendre celle en cours conserve les exécutions en attente en mémoire ; un redémarrage de la plateforme les supprime.
- Start over ne peut pas annuler une étape en cours : les exécutions plus anciennes s’arrêtent à leur prochaine attente, avec « stopped: a newer run of this rule started ». Ce qu’elles ont déjà envoyé reste envoyé.
- Also runs in Manual est refusé pour une règle qui envoie des commandes, modifie des réglages ou active des règles : « Only a rule that just notifies or raises alarms may run in Manual ».
Échecs
Si une commande, un réglage ou une alarme échoue pour un appareil (commande refusée, limite d’appareils atteinte), l’exécution enregistre l’étape en échec de cet appareil dans History et se poursuit : les autres appareils sont toujours concernés et les actions suivantes s’exécutent. Un échec de toute autre étape (une notification, une condition illisible) arrête l’exécution à cet endroit, et History indique l’étape qui n’a pas abouti.
Au format JSON
"then": [
{ "id": "a1", "kind": "command", "target": { "deviceType": "<profileId>" }, "command": "fan.set", "params": { "on": true } },
{ "id": "a2", "kind": "setting", "target": { "device": "<id>" }, "key": "setpoint", "value": 21 },
{ "id": "a3", "kind": "notify", "recipients": [ { "kind": "role", "role": "ADMIN" } ], "text": "Fans switched on" },
{ "id": "a4", "kind": "alarm", "op": "raise", "target": { "device": "<id>" }, "alarmType": "fan_forced", "severity": "warning" },
{ "id": "a5", "kind": "wait", "sec": 600 },
{ "id": "a6", "kind": "wait_until", "condition": { "kind": "value", "target": { "device": "<id>" }, "key": "door_open", "op": "==", "value": false }, "timeoutSec": 900, "onTimeout": "stop" },
{ "id": "a7", "kind": "choose", "branches": [ { "if": { "kind": "sun", "is": "night" }, "then": [ { "id": "a8", "kind": "rule", "op": "enable", "rule": "<ruleId>" } ] } ] }
],
"options": { "overlap": "ignore" }

