Der Block When listet die Auslöser einer Regel auf: „Jeder dieser Auslöser startet die Regel.“ Eine Regel hat 1 bis 10 Auslöser. Klicken Sie auf Add a trigger und wählen Sie die Art unter What.
| Art (What) | Startet die Regel, wenn |
|---|---|
| A value changes | Ein gespeicherter Wert eines Geräts ändert sich auf die von Ihnen gewählte Weise. |
| A device connects or disconnects | Ein Gerät geht online, geht offline oder meldet sich nicht mehr. |
| An alarm | Ein Alarm wird ausgelöst oder aufgehoben. |
| A time of day | Eine Uhrzeit ist erreicht, an gewählten Wochentagen. |
| Every so often | Alle N Minuten. |
| Sunrise or sunset | Die Sonne geht am Ort auf oder unter, mit einem Versatz. |
| Days of the month | Eine Uhrzeit ist an gewählten Tagen des Monats und/oder Monaten erreicht. |
| Only when I press Run now | Nie von selbst; Sie starten sie mit Run now. |
Nachdem ein Auslöser ausgelöst hat, werden die Bedingungen Only if geprüft; danach laufen die Aktionen Then. Siehe Conditions und Actions.
A value changes
Wählen Sie das Device (ein Gerät oder jedes Gerät eines Profils am Ort), den Value (einen Schlüssel) und How it changes:
| Auswahl | Löst aus, wenn |
|---|---|
| changes | Der Wert ist anders als der letzte (der erste Wert zählt ebenfalls). |
| rises above x | Der Wert geht von nicht über x auf über x. |
| falls below x | Der Wert geht von nicht unter x auf unter x. |
| becomes x | Der Wert wird gleich x. |
| stops being x | Der Wert wird ungleich x. |
| comes into the range x and y | Der Wert tritt in [x, y] ein (beide Grenzen eingeschlossen). |
| leaves the range x and y | Eine Zahl außerhalb von [x, y] kommt nach einer innerhalb an. |
Vergleiche folgen den Alarmregeln: Zahlen (und zahlenähnlicher Text) werden als Zahlen verglichen, becomes / stops being vergleichen alles andere als Text, und „above“/“below“ trifft bei einem Nicht-Zahlwert nie zu.
It fires on the edge, der Moment, in dem die Bedingung wahr wird, nicht bei jeder Nachricht, solange sie wahr bleibt. Eine Temperatur, die über 28 steigt, löst einmal aus; erneut erst, wenn der Wert zuvor höchstens 28 war und wieder steigt.
and stays so for
Stellen Sie and stays so for auf eine Anzahl Minuten (oder at once). Die Regel startet dann nur, wenn die Bedingung nach dieser Zeit noch wahr ist. Eine Nachricht, die die Bedingung beendet, bricht das Warten ab. Das Warten übersteht einen Neustart der Plattform. Maximum: 24 Stunden (1.440 Minuten).
Beispiel: rises above 28 and stays so for 5 Minuten: Der Lüfter startet nur, wenn der Raum 5 Minuten lang heiß bleibt.
Welche Nachrichten zählen
Der Auslöser reagiert, nachdem der Wert gespeichert wurde: gespeicherte Telemetrie und Attribut-Aktualisierungen, die den Schlüssel enthalten. Ein Gerät des Profils zählt für sich selbst: Bei Every profile hat jedes Gerät eigene Flanke und eigenes „stays so for“.
A device connects or disconnects
| Auswahl | Löst aus, wenn |
|---|---|
| comes online | Das Gerät verbindet sich (nach der Online-Regel des Profils). |
| goes offline | Das Gerät geht offline. |
| goes quiet | Das Gerät hat für den Inactivity timeout des Profils nichts gesendet. |
Siehe Connection status and activity. Um nur zu handeln, wenn ein Gerät offline bleibt, verwenden Sie goes offline, dann Wait, dann eine Auswahl „if the device is offline“ (die fertige Regel Tell people when a device stays offline macht genau das).
Ein Alarm
| Feld | Bedeutung |
|---|---|
| Device | Ein Gerät oder jedes Gerät eines Profils. Bei einer Karte, deren Ort ein Gerät ist, außerdem on this place (das Gerät selbst). |
| is raised / is cleared | Ein neuer Alarm wird eröffnet oder ein Alarm wird aufgelöst. Eine Änderung des Schweregrads oder eine Quittierung löst nicht aus. |
| at least | Ein Mindestschweregrad oder any severity. |
| Alarm type (optional) | Nur Alarme dieses Typs, zum Beispiel high_temperature. |
Eine Uhrzeit
At eine Uhrzeit (HH:MM, 24 Stunden) On gewählten Wochentagen oder Every day. Siehe Time, sunrise/sunset, dates and holidays, welche Zeitzone gilt.
Every so often
Every 1 bis 1.440 minutes, gezählt ab dem Start des Ablaufs der Regel, nicht ab der vollen Stunde. Kombinieren Sie es mit einer Zeitfenster-Bedingung für „alle 15 Minuten während der Arbeitszeit“ (die fertige Regel Do something every so often during working hours).
Sunrise or sunset
Sunrise oder Sunset, ein Versatz in minutes after (negative: before) von −180 bis 180 und optional Wochentage. Der Ort benötigt einen Standort: „Sunrise and sunset need this place’s location: set it on the place first.“ Für einen Geräte-Ort wird der Standort des nächstgelegenen Assets über dem Gerät verwendet. Details: Time, sunrise/sunset, dates and holidays.
Days of the month
Eine Uhrzeit (At) an gewählten days of the month (1 bis 31) und/oder In gewählten Monaten, oder an Wochentagen. „Choose days of the month or days of the week, not both.“ Beispiel: um 06:00 am 1. jedes Monats; um 08:00 jeden Tag im Juni, Juli und August.
Mindestens ein Monat, Tag des Monats oder Wochentag muss gewählt sein.
Only when I press Run now
Die Regel startet nie von selbst. Verwenden Sie sie für Abläufe, die Sie von Hand über die Karte starten, zum Beispiel ein Spülprogramm. Eine Regel mit diesem Auslöser prüft weiterhin ihre Bedingungen Only if.
Mehrere Auslöser
Jeder Auslöser startet die Regel. Jeder löst einzeln aus; wenn zwei kurz nacheinander auslösen, entscheiden die Options, ob der zweite Lauf wartet, parallel läuft oder ignoriert wird. Siehe Actions.
Grenzen
| Grenze | Wert |
|---|---|
| Auslöser pro Regel | 10 |
| „stays so for“ | bis zu 24 Stunden |
| Every so often | 1 bis 1.440 Minuten |
| Sonnenversatz | −180 bis 180 Minuten |
| Geräte, für die eine Profilzeile steht | 200 |
In JSON
Die API speichert Auslöser so (IDs sind kurze Zeilennamen):
"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" }
]Wochentage sind 1 (Montag) bis 7 (Sonntag). Regel-Schweregrade werden in Kleinbuchstaben geschrieben (critical … info).