Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Karte Regeln: Aktionen („Dann“)

Alle Aktionen der Regelkarte – Befehle, Einstellungen, Personen benachrichtigen, Alarme, Warten, Warten bis, Auswahlen und andere Regeln, dazu die Laufoptionen.

Der Block Then legt fest, was eine Regel tut, „In dieser Reihenfolge“. Eine Regel hat 1 bis 20 Aktionen, wobei die Aktionen innerhalb von Auswahlen mitgezählt werden. Klicken Sie auf Aktion hinzufügen, wählen Sie die Art und ordnen Sie die Aktionen mit Nach oben / Nach unten.

ArtFunktion
Befehl sendenSendet einen Befehl aus dem Katalog des Geräteprofils.
Einstellung ändernSchreibt eine Einstellung auf das Gerät.
Personen benachrichtigenSendet eine Benachrichtigung.
Alarm auslösen oder aufhebenÖffnet oder hebt einen Alarm mit dem üblichen Lebenszyklus auf.
WartenPausiert vor dem nächsten Schritt.
Warten, bis etwas zutrifftPausiert, bis eine Bedingung erfüllt ist, mit einer Zeitgrenze.
Nach einer Bedingung wählenFührt je nach Bedingungen unterschiedliche Schritte aus.
Andere Regel ein- oder ausschalten bzw. startenSchaltet eine andere Regel des Standorts ein oder aus oder startet sie.

Befehl senden

Wählen Sie das Gerät (ein einzelnes Gerät oder alle Geräte eines Profils) und einen Befehl 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 („Dieser Gerätetyp hat keinen solchen Befehl.“, „Die Werte des Befehls passen nicht dazu.“). Das Speichern wird abgelehnt, wenn Sie diesen Befehl selbst nicht senden dürfen (Befehle haben Stufen mit eigenen Berechtigungen).

Der Befehl wird wie jeder andere Befehl gesendet, mit seinem Timeout und Verlauf in den Befehlen des Geräts. Ein Gerät im Modus Manuell wird übersprungen: „übersprungen: Gerät ist im Modus Manuell“. Siehe Befehle an Geräte senden.

Einstellung ändern

Wählen Sie das Gerät, geben Sie die Einstellung (ein Schlüssel, bis zu 128 Zeichen) und nach auf den Wert ein. Ein Wert, der wie eine Zahl aussieht, wird als Zahl gesendet, alles andere als Text.

Die Einstellung wird als gemeinsames Attribut jedes Geräts geschrieben, sodass das Gerät sie wie jedes gemeinsame Attribut erhält, das es abonniert. Ein Gerät im Modus Manuell wird übersprungen. Siehe Attribute.

Personen benachrichtigen

FeldBedeutung
WerMarkieren Sie Eigentümer, Administratoren und/oder Mitglieder (die Rollen Ihrer Organisation).
NachrichtDer 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. Die Karte bietet Rollen an; die Regel-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 zu informieren. Wiederholungen derselben Mitteilung an dieselbe Person werden für eine Abkühlzeit zurückgehalten, 10 Minuten, sofern Ihr Tarif keinen anderen Wert vorsieht. Details: Benachrichtigungen aus Regeln und Flows.

Alarm auslösen oder aufheben

FeldBedeutung
Auslösen / AufhebenÖffnet oder aktualisiert einen Alarm oder hebt ihn auf.
GerätEin Gerät, alle Geräte eines Profils oder (auf einer Gerätekarte) an diesem Standort.
AlarmtypDer Typ, zum Beispiel pump_dry_run.
SchweregradFür Auslösen: Critical, Major, Minor, Warning oder Info (Standard: Warning).

Diese Alarme verhalten sich wie Regelalarme: ein aktiver Alarm pro Gerät und Typ, dieselben Benachrichtigungen, Drosselung und Sturmschutz. Ein ausgelöster Alarm bleibt offen, bis eine Aktion Aufheben, ein Flow oder eine Person ihn aufhebt; er hat keine eigene Bedingung.

Warten

Warten für eine Anzahl von Sekunden oder Minuten, 1 Sekunde bis 24 Stunden. Nach der Wartezeit prüft die Regel, ob der Standort noch im Modus Auto ist („Noch im Auto-Modus?“); ist der Standort inzwischen in den Modus Manuell gewechselt, endet der Lauf an dieser Stelle.

Warten, bis etwas zutrifft

Eine Bedingung (jede Art aus Bedingungen), für höchstens eine Zeit (1 Sekunde bis 24 Stunden, Standard 10 Minuten) und was bei Zeitüberschreitung geschieht: dann weitermachen oder dann beenden.

Die Bedingung wird alle 5 Sekunden erneut gegen die gespeicherten Werte geprüft. Trifft sie zu, läuft der Lauf sofort weiter. Anders als bei „bleibt so für“ überlebt ein wartender Lauf keinen Neustart der Plattform nicht.

Nach einer Bedingung wählen

Bis zu 5 Zweige, jeweils Wenn eine Bedingung dann einige Aktionen, und ein optionales Sonst. Der erste Zweig, dessen Bedingung zutrifft, wird ausgeführt; trifft keine zu, wird Sonst ausgeführt. Auswahlen können Auswahlen enthalten, 2 Ebenen tief. Die Aktionen innerhalb zählen zu den 20.

Andere Regel ein- oder ausschalten bzw. starten

Wählen Sie eine Regel desselben Standorts und:

AuswahlFunktion
Einschalten / AusschaltenSchaltet diese Regel ein oder aus, so wie es ihr Schalter täte.
Starten (muss der letzte Schritt sein)Übergibt den Lauf an diese Regel. Er muss der letzte Schritt der Regel sein oder der Zweige der letzten Auswahl: „Das Starten einer anderen Regel übergibt ihr den Lauf, daher muss es der letzte Schritt sein.“

Eine Regel kann sich nicht selbst ein- oder ausschalten oder starten. Für die gestartete Regel gelten deren eigene Optionen für Manuell und Überlappung.

Mehrere Geräte

Eine Aktion auf Jedes Profil wird einmal für jedes Gerät dieses Profils am Standort ausgeführt, bis zu 200 Geräte; darüber hinaus werden Geräte nicht angesprochen, und das Laufprotokoll vermerkt dies. Geräte im Modus Manuell werden bei Befehlen und Einstellungen ausgelassen.

Optionen

OptionAuswahl
Wenn er ausgelöst wird, während er noch läuftDen neuen ignorieren (Standard), Auf den laufenden warten, dann ausführen, Nebeneinander ausführen, Neu beginnen: den laufenden beim nächsten Warten beenden
HöchstensFür „Warten“ und „Nebeneinander“: 1 bis 10 Läufe, die gleichzeitig warten oder laufen.
Läuft auch im Modus Manuell„Nur für eine Regel, die nur Personen benachrichtigt oder Alarme auslöst.“

Hinweise:

  • Auf den laufenden warten hält wartende Läufe im Speicher; ein Neustart der Plattform verwirft sie.
  • Neu beginnen kann einen laufenden Schritt nicht abbrechen: ältere Läufe enden beim nächsten Warten mit „beendet: ein neuerer Lauf dieser Regel wurde gestartet“. Was sie bereits gesendet haben, bleibt gesendet.
  • Läuft auch im Modus Manuell wird für eine Regel abgelehnt, die Befehle sendet, Einstellungen ändert oder Regeln schaltet: „Nur eine Regel, die nur benachrichtigt oder Alarme auslöst, darf im Modus Manuell laufen“.

Fehler

Schlägt ein Befehl, eine Einstellung oder ein Alarm für ein Gerät fehl (ein Befehl abgelehnt, eine Geräteobergrenze erreicht), protokolliert der Lauf den fehlgeschlagenen Schritt dieses Geräts unter Verlauf und läuft weiter: die übrigen Geräte werden weiterhin angesprochen und die nächsten Aktionen laufen weiter. Ein Fehler bei einem anderen Schritt (eine Benachrichtigung, eine Bedingung, die nicht gelesen werden kann) beendet den Lauf an dieser Stelle, und Verlauf nennt den Schritt, der nicht erfolgreich war.

Im 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" }