Trigger (Auslöser) legen fest, wann ein Ereignis eintritt. Aktionen führen aus, was dann geschehen soll, zum Beispiel eine E-Mail senden oder einen Wert schreiben. Beides wird getrennt konfiguriert und über die Aktion verknüpft.
Wie Trigger und Aktionen zusammenwirken
- Ein Trigger führt selbst nichts aus. Er prüft nur seine Bedingung.
- Eine Aktion enthält eine Liste von Triggern. Sie wird ausgeführt, sobald einer davon auslöst.
- Eine Aktion kann von mehreren Triggern ausgelöst werden. Beispiel: Eine Kamera-Aufzeichnung startet bei der Türklingel und beim Bewegungsmelder.
- An einen Trigger können beliebig viele Aktionen gebunden werden.
- Einige Controls können ebenfalls eine Aktion ausführen.
So gehen Sie vor
- Legen Sie in der Trigger-Verwaltung mit + einen Trigger an und wählen Sie den Typ.
- Legen Sie in der Aktionsverwaltung mit + eine Aktion an und wählen Sie den Typ.
- Fügen Sie in der Aktion mit Trigger hinzufügen den Trigger hinzu. Dort können Sie auch einen neuen Trigger anlegen.
- Bestätigen Sie den Dialog. Eine Kopie einer Aktion wird erst gespeichert, wenn Sie den Dialog bestätigen.
Sie können Trigger und Aktionen nur löschen, wenn sie nirgends verwendet werden. Die Listen lassen sich nach Name filtern, die Aktionsliste zusätzlich nach Typ.
Gemeinsame Felder
| Feld | Gilt für | Bedeutung |
|---|---|---|
| Id | Trigger, Aktion | Interne Nummer. Nur zur Ansicht. Bei Aktionen zeigt Id/Typ auch den Typ, der sich nicht nachträglich ändern lässt |
| Name | Trigger, Aktion | Name in Auswahllisten |
| Kommentar | Trigger, Aktion | Freie Dokumentation, ohne Funktion |
| Totzeit | Trigger | Zeitspanne, in der der ganze Trigger nach einer Auslösung gesperrt ist. Verhindert Mehrfachauslösung, zum Beispiel bei mehrfachem Klingeln |
| Verzögerte Ausführung | Aktion | Zeitspanne, die nach der Auslösung vergeht, bevor die Aktion läuft |
Triggertypen
| Typ | Löst aus bei | Artikel |
|---|---|---|
| Flanke | Wechsel eines Channels auf wahr oder falsch | Flanken-Trigger |
| Wert-Änderung | Änderung oder Aktualisierung eines Channel-Werts | Value-Change-Trigger |
| Uhrzeit | Uhrzeit, optional eingeschränkt auf Wochentage, Tage und Monate | Zeitbasierter Trigger |
| Wert-Vergleich | Vergleich eines Channels mit einem Grenzwert | Value-Limit-Trigger |
| Zyklisch | Ablauf eines Intervalls | Zyklischer Trigger |
| System-Ereignis | Systemereignis, zum Beispiel Boot | System-Ereignis-Trigger |
| ekey | Nachricht eines ekey-Interfaces | ekey-Trigger |
| Channel-Wert/Alter | Wert eines Channels zu lange nicht aktualisiert | Wert-Alter-Trigger |
| Datei-Ereignis | Datei-Ereignis eines Interfaces | Datei-Ereignis-Trigger |
| Formel | Formelausdruck wird wahr | Formel-Trigger |
Aktionstypen
| Typ | Wirkung | Artikel |
|---|---|---|
| EMail Senden | Sendet eine E-Mail | E-Mail senden |
| Wert kopieren | Kopiert den Wert eines Channels in andere Channels | Wert kopieren |
| Wert schreiben | Schreibt einen Festwert in Channels | Wert schreiben |
| SMS senden | Sendet eine SMS | SMS senden |
| Kamera aufzeichnen | Zeichnet Bilder einer Kamera auf | Kamera aufzeichnen |
| Kamera Aufzeichnungen löschen | Löscht die Aufzeichnungen einer Kamera | Kamera-Aufzeichnungen löschen |
| Benachrichtigung einfügen | Erzeugt eine interne Benachrichtigung | Benachrichtigung |
| Werte schreiben (mehrere) | Schreibt bis zu 10 Festwerte in je einen Channel | Werte schreiben |
| Sequenz | Schreibt Werte zeitlich gestaffelt | Sequenz-Aktion |
| OCPP-Action | Sendet eine OCPP-Nachricht an eine Ladestation | OCPP-Aktion |
| Channel-Leseanforderung | Fordert ein explizites Lesen von Channels an | Channel-Leseanforderung |
Im Code gibt es zusätzlich eine Sonos-Durchsage-Aktion, die in der Hilfe nicht beschrieben ist.
Text und Variablen in Nachrichten
In Aktionen mit Textfeld (E-Mail, SMS, Benachrichtigung) können Sie Werte einfügen. Der Button Channel fügt den Wert eines Channels ein, die Buttons Quelle, Ursache und Typ fügen Angaben zum Auslöser ein:
| Variable | Bedeutung |
|---|---|
| Channel | Wert des gewählten Channels |
| Quelle | Name des auslösenden Objekts, zum Beispiel Trigger oder Control |
| Ursache | Name des verursachenden Objekts, zum Beispiel Channel |
| Typ | Art des auslösenden Ereignisses, zum Beispiel Flanke |
Hinweise und Grenzen
Hinweis: Die Kombination aus Trigger und Aktion ist mächtig, wird aber schnell unübersichtlich. Nutzen Sie das Feld Kommentar, damit Sie und andere Integratoren später nachvollziehen können, was eine Konfiguration bewirkt.
- Die Totzeit sperrt alle Auslösearten des Triggers, nicht nur die zuletzt eingetretene Bedingung.
- Für komplexere Abläufe bietet X2B den Flow-Editor.