Une règle dit : When (Quand) quelque chose se produit, Only if (Seulement si) certaines conditions sont réunies, Then (Alors) exécuter des actions dans l’ordre. Exemple : « allumer le ventilateur quand la pièce dépasse 28 °C pendant cinq minutes pendant les heures de travail ». Vous écrivez les règles dans la carte Rules d’un tableau de bord, en phrases, sans dessiner de diagramme. Chaque règle s’exécute en arrière-plan sous forme de flux.
Ajouter la carte
- Ouvrez un tableau de bord en mode édition et ajoutez la carte Rules.
- Dans ses paramètres, verrouillez-la sur un lieu (un actif ou un appareil), ou laissez-la suivre la page (par exemple une page de site qui n’affiche qu’un site à la fois).
- Enregistrez le tableau de bord.
Une carte sans lieu affiche « Cette carte ne concerne pas encore un lieu. Choisissez un actif ou un appareil dans ses paramètres, ou laissez-la suivre la page. » Voir Widgets.
La carte affiche :
- le commutateur Auto / Manual du lieu (voir Modes Manual et Auto),
- la liste des règles du lieu avec leur état,
- Commands (Commandes) : les commandes que vous pouvez envoyer aux appareils du lieu depuis la carte.
Lieu d’origine et périmètre
Chaque règle a un seul lieu d’origine : l’actif ou l’appareil de la carte où vous l’avez créée. Une règle ne peut nommer que des appareils dans le périmètre de son lieu d’origine :
| Lieu d’origine | Périmètre |
|---|---|
| Un actif (site, bâtiment, pièce, ligne …) | Chaque appareil placé sous l’actif ou sous un actif situé en dessous. Au maximum 2 000 appareils ; un lieu plus grand est refusé, donc placez la règle sur un lieu plus petit. |
| Un appareil | L’appareil lui-même. |
Une ligne peut nommer un appareil ou tous les appareils d’un profil d’appareil du périmètre (affiché sous la forme « Every profile in place »). Une référence à un profil peut désigner au maximum 200 appareils. Si les appareils d’un profil du périmètre changent par la suite, la règle continue de fonctionner avec les appareils enregistrés avec elle, jusqu’à ce qu’on l’enregistre à nouveau.
La liste des règles
Chaque règle affiche son nom, un commutateur On / Off, son état et sa dernière exécution (« Last run when : text », ou « Has not run yet »). Une règle avec un déclencheur d’heure, de date ou de lever/coucher de soleil affiche aussi Next when.
| État | Signification |
|---|---|
| Idle (Inactive) | En attente de son déclencheur. |
| Waiting time | Une exécution est à une étape d’attente. |
| Running (En cours) | Une exécution est en cours. |
| Stopped: Manual (Arrêtée : Manual) | Le lieu est en mode Manual. |
| Paused by a guard (Suspendue par une protection) | Le moteur d’automatisation a suspendu son flux (par exemple parce qu’il s’exécute trop souvent). Voir Protections et messages en échec. |
| Needs attention (Action requise) | Un appareil qu’elle nomme a été supprimé. Elle est désactivée jusqu’à ce que quelqu’un la modifie. |
| Off (Désactivée) | Désactivée. |
Le menu d’une règle contient Edit (Modifier), Duplicate (Dupliquer), History (Historique), Run now (Exécuter maintenant) et Delete (Supprimer). La suppression demande d’abord confirmation : « The rule stops for good. Its history stays in the activity log. »
Rédiger une règle
- Cliquez sur Add rule (Ajouter une règle). L’éditeur s’ouvre sous le nom New rule (Nouvelle règle).
- Vous pouvez choisir Start from a ready rule (Partir d’une règle prête) : Turn something on when a value is high, Turn something off when a value is low, Tell people when a device stays offline, Do something at sunset, Turn something off after it has been on for a while ou Do something every so often during working hours. La règle est remplie avec des valeurs raisonnables ; vous choisissez les appareils.
- Saisissez un Name (Nom) (120 caractères au maximum).
- Remplissez les blocs :
- When (Quand) : « Any of these starts the rule. » (N’importe lequel de ceux-ci démarre la règle.) Jusqu’à 10 déclencheurs. Voir Déclencheurs.
- Only if (Seulement si) : « All of these must hold. » (Tous ceux-ci doivent être vrais.) Facultatif. Voir Conditions.
- Then (Alors) : « In this order. » (Dans cet ordre.) Jusqu’à 20 actions. Voir Actions.
- Options : ce qui se passe lorsqu’elle se déclenche alors qu’elle est encore en cours, et Also runs in Manual (S’exécute aussi en Manual). Voir Actions.
- Cliquez sur Test now (Tester maintenant) pour la vérifier avec les valeurs enregistrées maintenant (ci-dessous).
- Cliquez sur Save rule (Enregistrer la règle).
Les problèmes sont listés sous « Fix these before saving » (Corrigez ceci avant d’enregistrer), chacun à côté de sa ligne, par exemple « Type the value to compare with. » ou « Sunrise and sunset need the place’s location: set it on the place first. »
Confirmation pour les règles qui agissent
Une règle qui envoie des commandes, modifie des réglages ou notifie des personnes demande une fois : « This rule acts on its own. Saving it lets the rule send commands, change settings or notify people by itself. » Cochez Yes, let this rule act on its own (Oui, laisser cette règle agir seule) pour enregistrer. L’enregistrement est aussi refusé si vous n’avez pas vous-même le droit d’envoyer l’une de ses commandes.
Tester maintenant
Test now exécute la règle avec les valeurs enregistrées maintenant et n’envoie rien. Le Result (Résultat) affiche :
- chaque déclencheur : Holds now (Vrai maintenant), Does not hold (Non vrai), ou Starts by itself (Démarre seul) (déclencheurs liés à l’heure),
- la règle : Would run now (Serait exécutée maintenant), Would not run (Ne serait pas exécutée) ou Manual would stop it (Manual l’arrêterait), avec la raison en toutes lettres (par exemple « Room 1 · temperature is 26.4, not above 28 »),
- It would (Elle ferait) : les actions qu’elle effectuerait.
Exécuter maintenant et Historique
- Run now starts the rule at once, skipping its triggers. Its conditions still apply. If its first step moves equipment, it asks « Run name now? It moves equipment at once. » A rule whose only trigger is Only when I press Run now runs only this way.
- History (Historique) affiche les dernières exécutions, les plus récentes en premier : quand, Done (Terminée) ou Failed (Échouée), et une ligne en toutes lettres. Les 30 dernières exécutions sont conservées.
Autorisations
| Action | Autorisation | Rôle par défaut |
|---|---|---|
| Voir les règles et leurs exécutions | View the rules of places and devices and their runs (Voir les règles des lieux et appareils et leurs exécutions) | Utilisateur |
| Exécuter une règle maintenant | Run a rule now (Exécuter une règle maintenant) | Utilisateur |
| Basculer Manual / Auto | Switch a place between Manual and Auto (Basculer un lieu entre Manual et Auto) | Utilisateur |
| Ajouter, modifier, activer ou désactiver et supprimer des règles | Add, change, switch on or off and delete rules (Ajouter, modifier, activer ou désactiver et supprimer des règles) | Administrateur |
La modification nécessite aussi l’accès à l’actif ou à l’appareil d’origine. La création, la modification, l’activation et l’exécution des règles, ainsi que chaque bascule de mode, sont journalisées.
Lorsqu’un appareil est supprimé
Une règle qui nomme un appareil supprimé passe en Needs attention (Action requise) et est désactivée. Les personnes sont averties (« Rule name needs attention ») et l’événement webhook rules.needs_attention est envoyé. Modifiez la règle, choisissez un autre appareil et enregistrez. Une suppression n’est jamais bloquée par une règle.
Règles et flux
Le flux d’une règle apparaît dans Automation (Automatisation) avec un badge Rules, et s’ouvre en lecture seule, avec l’indication de le modifier dans la carte Rules. Si vous avez besoin de plus que ce que peut faire une règle, utilisez Detach into an ordinary flow (Détacher en flux ordinaire) dans l’éditeur de flux. Cette action est irréversible : la règle est supprimée et le flux devient un flux ordinaire que vous modifiez dans l’éditeur de flux.
Les règles ne comptent pas dans la limite de flux de votre forfait.
Limites
| Limite | Valeur |
|---|---|
| Déclencheurs par règle | 10 |
| Conditions par groupe | 16 |
| Imbrication des groupes de conditions | 4 niveaux |
| Actions par règle (y compris celles à l’intérieur des choix) | 20 |
| Branches d’un choix | 5 |
| Imbrication des choix | 2 niveaux |
| Appareils concernés par une ligne | 200 |
| Appareils dans le périmètre d’un lieu d’origine | 2,000 |
| Attente la plus longue, wait-until ou « stays so for » | 24 heures |
| Exécutions simultanées ou en file d’attente (At most : Au maximum) | 1 à 10 |
| Historique d’exécution conservé | 30 exécutions |
| Formule | 500 caractères, 12 valeurs |
| Destinataires de la notification | 20 |
| Message de notification | 1 000 caractères |