Der Block Then listet auf, was eine Regel tut, „In this order“ („In dieser Reihenfolge“). Eine Regel hat 1 bis 20 Aktionen, wobei Aktionen innerhalb von Auswahlen mitgezählt werden. Klicken Sie auf Add an action, wählen Sie die Art und ordnen Sie die Aktionen mit Move up / Move down.
| Art | Funktion |
|---|---|
| Send a command | Sendet einen Befehl aus dem Katalog des Gerätprofils. |
| Change a setting | Schreibt eine Einstellung auf das Gerät. |
| Tell people | Sendet eine Benachrichtigung. |
| Raise or clear an alarm | Öffnet oder löscht einen Alarm mit dem üblichen Lebenszyklus. |
| Wait | Pausiert vor dem nächsten Schritt. |
| Wait until something holds | Pausiert, bis eine Bedingung erfüllt ist, mit einer Zeitgrenze. |
| Choose by a condition | Führt je nach Bedingungen unterschiedliche Schritte aus. |
| Switch or start another rule | Schaltet eine andere Regel des Standorts ein oder aus oder startet sie. |
Send a command
Wählen Sie das Device (ein Gerät oder alle Geräte eines Profils) und einen Command aus dem Katalog des Profils, danach dessen Parameter. Beim Speichern wird geprüft, ob der Befehl für jedes erreichte Gerät existiert und ob die Werte passen („This device type has no such command.“, „The command’s values do not fit it.“). Das Speichern wird abgelehnt, wenn Sie diesen Befehl selbst nicht senden dürfen, denn Befehle haben Stufen mit eigenen Berechtigungen.
Der Befehl wird wie jeder andere Befehl gesendet, mit seinem Timeout und dem Verlauf in den Befehlen des Geräts. Ein Gerät im Modus Manual wird übersprungen: „skipped: device is in Manual“. Siehe Sending commands to devices.
Change a setting
Wählen Sie das Device, geben Sie die Setting ein (ein Schlüssel, bis zu 128 Zeichen) und den Wert nach to. Ein Wert, der wie eine Zahl aussieht, wird als Zahl gesendet, alles andere als Text.
Die Einstellung wird als shared attribute jedes Geräts geschrieben, sodass das Gerät sie wie jedes shared attribute erhält, das es abonniert. Ein Gerät im Modus Manual wird übersprungen. Siehe Attributes.
Tell people
| Feld | Bedeutung |
|---|---|
| Who | Markieren Sie Owners, Admins und/oder Members (die Rollen Ihrer Organisation). |
| Message | Der Text, bis zu 1.000 Zeichen. |
Der Titel der Benachrichtigung ist der Name der Regel. Sie erreicht jede Person über die Kanäle, die sie erlaubt hat. Die Karte bietet Rollen an; die Rules-API akzeptiert zusätzlich einzelne Benutzer und Teams, bis zu 20 Empfänger. Eine Rolle mit mehr als 20 aktiven Mitgliedern wird abgelehnt, statt nur teilweise benachrichtigt zu werden. Wiederholungen derselben Meldung an dieselbe Person werden für eine Abklingzeit von 10 Minuten zurückgehalten, sofern Ihr Tarif keine andere festlegt. Details: Notifications from rules and flows.
Raise or clear an alarm
| Feld | Bedeutung |
|---|---|
| Raise / Clear | Öffnet oder aktualisiert einen Alarm oder löscht ihn. |
| Device | Ein Gerät, alle Geräte eines Profils oder (auf einer Gerätekarte) on this place. |
| Alarm type | Die Art, zum Beispiel pump_dry_run. |
| Severity | Für Raise: Critical, Major, Minor, Warning oder Info (Standard: Warning). |
Diese Alarme verhalten sich wie Regelalarme: ein aktiver Alarm pro Gerät und Art, dieselben Benachrichtigungen, Drosselung und Sturmschutz. Ein ausgelöster Alarm bleibt offen, bis eine Aktion Clear, ein Flow oder eine Person ihn löscht; er hat keine eigene Bedingung.
Wait
Wait for eine Anzahl von seconds oder minutes, von 1 Sekunde bis 24 Stunden. Nach der Wartezeit prüft die Regel, ob der Standort noch in Auto ist („Still in Auto?“); ist der Standort inzwischen in Manual gewechselt, endet der Lauf an dieser Stelle.
Wait until something holds
Eine Bedingung (jede Art aus Conditions), for at most eine Zeit (1 Sekunde bis 24 Stunden, Standard 10 Minuten) und was bei Zeitüberschreitung geschieht: then go on oder then stop.
Die Bedingung wird alle 5 Sekunden gegen die gespeicherten Werte erneut geprüft. Sobald sie erfüllt ist, läuft der Lauf sofort weiter. Anders als bei „stays so for“ übersteht ein wartender Lauf keinen Neustart der Plattform nicht.
Choose by a condition
Bis zu 5 Zweige, jeweils If eine Bedingung then einige Aktionen, und optional ein Otherwise. Der erste Zweig, dessen Bedingung erfüllt ist, läuft; ist keine erfüllt, läuft Otherwise. Auswahlen können Auswahlen enthalten, 2 Ebenen tief. Die Aktionen innerhalb zählen zu den 20.
Switch or start another rule
Wählen Sie eine Rule desselben Standorts und:
| Auswahl | Funktion |
|---|---|
| Switch on / Switch off | Schaltet diese Regel ein oder aus, so wie es ihr Schalter täte. |
| Start it (must be the last step) | Übergibt den Lauf an diese Regel. Sie muss der letzte Schritt der Regel sein oder der Zweige ihrer letzten Auswahl: „Starting another rule hands the run over to it, so it has to be the last step.“ |
Eine Regel kann sich nicht selbst schalten oder starten. Für die gestartete Regel gelten ihre eigenen Optionen für Manual und Überlappung.
Mehrere Geräte
Eine Aktion auf Every profile läuft einmal für jedes Gerät dieses Profils am Standort, bis zu 200 Geräte; Geräte darüber hinaus werden nicht bedient, und das Laufprotokoll vermerkt dies. Geräte im Modus Manual bleiben bei Befehlen und Einstellungen außen vor.
Optionen
| Option | Auswahl |
|---|---|
| If it fires while it is still running | Ignore the new one (Standard), Wait for the one running, then run, Run them side by side, Start over: stop the one running at its next wait |
| At most | Für „wait“ und „side by side“: 1 bis 10 Läufe, die gleichzeitig warten oder laufen. |
| Also runs in Manual | „Nur für eine Regel, die nur Personen benachrichtigt oder Alarme auslöst.“ |
Hinweise:
- Wait for the one running hält wartende Läufe im Speicher; ein Neustart der Plattform verwirft sie.
- Start over kann einen laufenden Schritt nicht abbrechen: ältere Läufe enden an ihrer nächsten Wartezeit mit „stopped: a newer run of this rule started“. Was sie bereits gesendet haben, bleibt gesendet.
- Also runs in Manual wird für eine Regel abgelehnt, die Befehle sendet, Einstellungen ändert oder Regeln schaltet: „Only a rule that just notifies or raises alarms may run in Manual“.
Fehler
Schlägt ein Befehl, eine Einstellung oder ein Alarm für ein Gerät fehl (ein Befehl wird abgelehnt, eine Geräteobergrenze ist erreicht), protokolliert der Lauf den fehlgeschlagenen Schritt dieses Geräts in History und läuft weiter: die übrigen Geräte werden weiterhin bedient und die nächsten Aktionen laufen trotzdem. Ein Fehler bei einem anderen Schritt (eine Benachrichtigung, eine Bedingung, die nicht gelesen werden kann) beendet den Lauf an dieser Stelle, und History nennt den Schritt, der nicht erfolgreich war.
In 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" }