Le bloc When liste les déclencheurs d’une règle : « N’importe lequel de ceux-ci démarre la règle. » Une règle compte de 1 à 10 déclencheurs. Cliquez sur Add a trigger et choisissez le type sous What.
| Type (What) | Démarre la règle quand |
|---|---|
| A value changes | Une valeur enregistrée d’un appareil change selon la modalité que vous choisissez. |
| A device connects or disconnects | Un appareil passe en ligne, hors ligne ou devient silencieux. |
| An alarm | Une alarme est levée ou effacée. |
| A time of day | Une heure de l’horloge arrive, certains jours de la semaine. |
| Every so often | Toutes les N minutes. |
| Sunrise or sunset | Le soleil se lève ou se couche à l’endroit, avec un décalage. |
| Days of the month | Une heure arrive certains jours du mois et/ou certains mois. |
| Only when I press Run now | Jamais seul ; vous le lancez avec Run now. |
Après le déclenchement d’un déclencheur, les conditions Only if sont vérifiées ; puis les actions Then s’exécutent. Voir Conditions et Actions.
A value changes
Choisissez le Device (un appareil, ou tous les appareils d’un profil dans le lieu), la Value (une clé) et How it changes :
| Choix | Se déclenche quand |
|---|---|
| changes | La valeur est différente de la précédente (la première valeur compte aussi). |
| rises above x | La valeur passe de non supérieure à x à supérieure à x. |
| falls below x | La valeur passe de non inférieure à x à inférieure à x. |
| becomes x | La valeur devient égale à x. |
| stops being x | La valeur devient différente de x. |
| comes into the range x and y | La valeur entre dans [x, y] (bornes incluses). |
| leaves the range x and y | Un nombre hors de [x, y] arrive après un nombre situé à l’intérieur. |
Les comparaisons suivent les règles d’alarme : les nombres (et le texte ressemblant à un nombre) se comparent comme des nombres, becomes / stops being comparent tout le reste comme du texte, et « above »/« below » sur une valeur non numérique ne correspondent jamais.
It fires on the edge, au moment où la correspondance devient vraie, et non à chaque message tant qu’elle reste vraie. Une température qui passe au-dessus de 28 se déclenche une fois ; elle se déclenche à nouveau seulement après être restée à 28 ou en dessous, puis remonter.
et reste ainsi pendant
Réglez and stays so for sur un nombre de minutes (ou at once). La règle ne démarre alors que si la correspondance est toujours vraie après ce délai. Un message qui met fin à la correspondance annule l’attente. L’attente survit à un redémarrage de la plateforme. Durée maximale : 24 heures (1 440 minutes).
Exemple : rises above 28 and stays so for 5 minutes : le ventilateur ne démarre que si la pièce reste chaude pendant 5 minutes.
Messages pris en compte
Le déclencheur réagit après l’enregistrement de la valeur : télémétrie sauvegardée et mises à jour d’attributs portant la clé. Un appareil du profil compte individuellement : avec Every profile, chaque appareil a son propre seuil et son propre « stays so for ».
Un appareil se connecte ou se déconnecte
| Choix | Se déclenche quand |
|---|---|
| comes online | L’appareil se connecte (selon la règle de connexion du profil). |
| goes offline | L’appareil passe hors ligne. |
| goes quiet | L’appareil n’a rien envoyé pendant le Inactivity timeout du profil. |
Voir Connection status and activity. Pour n’agir que lorsqu’un appareil reste hors ligne, utilisez goes offline, puis Wait, puis un choix « if the device is offline » (la règle prête à l’emploi Tell people when a device stays offline fait exactement cela).
Une alarme
| Champ | Signification |
|---|---|
| Device | Un appareil ou tous les appareils d’un profil. Sur une carte dont le lieu est un appareil, aussi on this place (l’appareil lui-même). |
| is raised / is cleared | Une nouvelle alarme s’ouvre, ou une alarme est résolue. Un changement de gravité ou un accusé de réception ne déclenche rien. |
| at least | Une gravité minimale, ou any severity. |
| Alarm type (optional) | Seulement les alarmes de ce type, par exemple high_temperature. |
Une heure de la journée
At une heure (HH:MM, format 24 heures) On certains jours de la semaine, ou Every day. Voir Time, sunrise/sunset, dates and holidays pour le fuseau horaire applicable.
Toutes les X minutes
Every de 1 à 1 440 minutes, comptées depuis le démarrage du flux de la règle, et non depuis l’heure pleine. Combinez-le avec une condition de fenêtre horaire pour « toutes les 15 minutes pendant les heures de travail » (la règle prête à l’emploi Do something every so often during working hours).
Lever ou coucher de soleil
Sunrise ou Sunset, un décalage en minutes after (negative: before) de −180 à 180, et éventuellement des jours de la semaine. Le lieu doit avoir une localisation : « Sunrise and sunset need this place’s location: set it on the place first. » Pour un appareil, la localisation de l’actif le plus proche au-dessus de l’appareil est utilisée. Détails : Time, sunrise/sunset, dates and holidays.
Jours du mois
Une heure (At) certains days of the month (1 à 31) et/ou In certains mois, ou certains jours de la semaine. « Choose days of the month or days of the week, not both. » Exemple : à 06:00 le 1er de chaque mois ; à 08:00 chaque jour de juin, juillet et août.
Au moins un des mois, jours du mois ou jours de la semaine doit être choisi.
Seulement quand j’appuie sur Run now
La règle ne démarre jamais d’elle-même. Utilisez-la pour les séquences que vous lancez à la main depuis la carte, par exemple un programme de rinçage. Une règle avec ce déclencheur vérifie toujours ses conditions Only if.
Plusieurs déclencheurs
N’importe quel déclencheur démarre la règle. Chaque déclencheur se déclenche séparément ; si deux se déclenchent de près, les Options décident si la seconde exécution attend, s’exécute en parallèle ou est ignorée. Voir Actions.
Limites
| Limite | Valeur |
|---|---|
| Déclencheurs par règle | 10 |
| « stays so for » | jusqu’à 24 heures |
| Toutes les X minutes | 1 à 1 440 minutes |
| Décalage solaire | −180 à 180 minutes |
| Appareils représentés par une ligne de profil | 200 |
En JSON
L’API enregistre les déclencheurs ainsi (les identifiants sont des noms de ligne courts) :
"when": [
{ "id": "t1", "kind": "value", "target": { "deviceType": "<profileId>" }, "key": "temperature", "change": "above", "value": 28, "forSec": 300 },
{ "id": "t2", "kind": "status", "target": { "device": "<deviceId>" }, "to": "offline" },
{ "id": "t3", "kind": "alarm", "target": { "home": true }, "event": "raised", "minSeverity": "major" },
{ "id": "t4", "kind": "time", "at": "07:30", "days": [1, 2, 3, 4, 5] },
{ "id": "t5", "kind": "every", "minutes": 15 },
{ "id": "t6", "kind": "sun", "event": "sunset", "offsetMin": 15 },
{ "id": "t7", "kind": "date", "at": "06:00", "daysOfMonth": [1] },
{ "id": "t8", "kind": "manual" }
]Les jours de la semaine vont de 1 (lundi) à 7 (dimanche). Les gravités des règles s’écrivent en minuscules (critical … info).