Benachrichtigung

Benötigt: IP-Symcon >= 5.1

Dieses Modul ermöglicht eine mehrstufige Benachrichtigung, wobei die Stufe sich nach einer definierten Zeit erhöht und bei einer Quittierung zurückgesetzt wird. Beim Erreichen einer neuen Stufe können verschiedene Aktionen ausgeführt werden.

Funktionsumfang

• Starten einer mehrstufigen Benachrichtigungskette durch eine Variable
• Auf jeder Stufe können individuell Aktionen festgesetzt werden:
  • Skripte ausführen
  • Push-Nachrichten, E-Mails oder SMS verschicken
  • Telefonanruf mit Ansage durchfügen (sofern "Telefonansage" Modul installiert)
  • Durchsage über Lautsprecher durchführen (sofern "Durchsage" Modul installiert)
  • Nachricht über Telegram versenden (sofern "TelegramBot" Modul installiert)
  • Nach bestimmter Zeit auf nächste Stufe erhöhen
• Quittierung über beigefügtes Skript oder Push-Nachricht beendet Benachrichtigungen
• Einzelne Stufen können bei Bedarf deaktiviert werden

Software-Installation

Über den Modul Store das Modul Benachrichtigung installieren.

Einrichten der Instanzen in IP-Symcon

• Unter "Instanz hinzufügen" kann das 'Benachrichtigung'-Modul mithilfe des Schnellfilters gefunden werden.
  • Weitere Informationen zum Hinzufügen von Instanzen in der Dokumentation der Instanzen
• Bei 'Auslöser' eine Variable auswählen
  • Nimmt diese Variable einen Wert an, der nicht neutral ist (false bei Boolean, 0 bei Integer und Float, '' bei String), wird die Benachrichtigungskette auf Stufe 1 gestartet
• Der Liste Benachrichtigungsstufen beliebig viele Stufen hinzufügen und konfigurieren
  • Dauer definiert die Zeit bis die nächste Stufe aktiviert wird
  • Aktionen werden beim Erreichen einer Stufe ausgeführt
  • Aktiv definiert, ob die Stufe ausgeführt werden soll. Nicht aktive Stufen werden übersprungen
  • 'Status' beinhaltet Fehlermeldungen, falls bei der Konfiguration der Stufe etwas nicht korrekt ist, ansonsten "OK"

Aktionen einrichten

Jede Aktion besitzt Parameter für den Aktionstyp, ein Empfängerobjekt, eine Empfängeradresse, einen Titel, eine Nachricht und eine Nachrichtvariable. Die "Aktion" definiert was aufgerufen werden soll. (z.B. Ein Skript oder eine Email versendet)
Dabei werden weitere Informationen wie "Titel" und "Nachricht" an das eingestellte "Empfängerobjekt" geschickt. Der Inhalt der Nachricht wird definiert durch den Text im Konfigurationsfeld "Nachricht". Dieser wird mit dem Text in der "Nachrichtenvariable" verkettet.
Für generische Nachrichten steht der Inhalt der Nachrichtenvariable als '{variable}' zur Verfügung. Ebenso können durch '\n' Zeilenumbrüche eingefügt werden. Die Empfängeradresse hat je nach Aktion eine andere Funktionalität.

Skript

Das als Empfängerobjekt ausgewählte Skript wird ausgeführt. Während dieses Aufrufs können folgende Systemvariablen verwendet werden:

Push

Eine Pushnachricht wird an alle Geräte des gewählten Webfronts geschickt. Diese Nachricht verlinkt das Quittierungsskript. Durch Tippen auf die Pushnachricht kann also die Benachrichtigung quittiert werden. Die Empfängeradresse hat bei diesem Aktionstyp keinen Effekt. Die Nachricht hat eine Maximallänge von 256 Zeichen.

E-Mail (SMTP)

Eine E-Mail wird über die gewählte SMTP-Instanz verschickt. Ist eine Empfängeradresse angegeben, so wird die E-Mail an diese Adresse verschickt. Ist keine Empfängeradresse angegeben, so wird die E-Mail an den angegebenen Empfänger der SMTP-Instanz geschickt. Wenn die Option 'Erweiterte Antwort' aktiviert ist kann mit dem Stichwort '{actions}' ein Block mit Links eingefügt werden, über welche die verfügbaren Aktionen ausgeführt werden können.

SMS

Eine SMS wird über die gewählte SMS-Instanz an die in der Empfängeradresse angegebene Telefonnummer geschickt. Wenn die Option 'Erweiterte Antwort' aktiviert ist kann mit dem Stichwort '{actions}' ein Link eingefügt werden, über den die verfügbaren Aktionen ausgeführt werden können. Ist eine Nachricht länger als 160 Zeichen (Begrenzung durch SMS), wird diese auf bis zu 2 weitere SMS aufgeteilt (maximal 459 Zeichen).

Telefonansage (nur verfügbar, wenn das Modul Telefonansage installiert ist)

Die in der Empfängeradresse angegebene Telefonnummer wird angerufen und der Titel sowie die Nachricht vorgelesen. Wenn die Option 'Erweiterte Antwort' aktiviert ist kann mit den Tasten 0-9 die Dazugehörige Aktion ausgeführt werden. Wenn gewünscht können mit dem Stichwort '{actions}' die verfügbaren Aktionen in die Nachricht eingebunden werden.

Durchsage (nur verfügbar, wenn das Modul Durchsage installiert ist)

Der Titel und die Nachricht werden mithilfe der ausgewählten Instanz vorgelesen. Die Empfängeradresse hat bei diesem Aktionstyp keinen Effekt.

Telegram (nur verfügbar, wenn das Modul TelegramBot installiert ist)

Der Titel und die Nachricht werden mithilfe der ausgewählten Instanz an den Empfänger gesendet. Die Empfängeradresse kann entweder der Name oder die UserID vom Telegram Empfänger sein. Sofern die Empfängeradresse leer gelassen wird, werden alle Empfänger, die im Telegram Bot hinterlegt sind, benachrichtigt.

Erweiterte Antwort

Wenn erweiterte Antwort aktiviert ist, können verschiedene Aktionen in der entsprechenden Liste definiert werden. Um festzulegen was bei einer Aktion zusätzlich ausgeführt wird kann ein ausgelöstes Ereignis erstellt werden. Als auslösende Variable wird die Variable 'Antwortaktion' und als Auslöser 'Bei bestimmtem Wert' gewählt. Als Wert kann nun die gewünschte Aktion ausgewählt werden.

Statusvariablen

Visualisierung

• Über die Visualisierung kann "Antwortaktion" ausgeführt werden um die Benachrichtigung zu reseten.
• Über die Visualisierung kann über "Benachrichtigung aktiv" die Benachrichtigung An/Aus geschaltet werden.
• Die aktuelle Benachrichtigungsstufe wird angezeigt.