Alarmierung
Funktionsbeschreibung
Die HOOC-Alarmierung ist eine Anwendung, welche es erlaubt, auf einfachste Weise Regeln zur Überwachung einer Anlage zu definieren. Dabei spielt es keine Rolle, ob die Bedingungen eine Überprüfung von Werten aus dem Secure Remote Control (SERC) Dienst beinhalten oder ob eine Meldung gesendet werden soll im Falle einer Verbindung auf die Anlage mittels Secure Remote Access (SERA). Bedingungen können miteinander verknüpft und direkt getestet werden. Empfänger und Benachrichtigungskanle (Voice, SMS, Push, E-Mail) der Alarmmeldungen können im HOOC Notification Center konfiguriert werden.
Konfiguration
Der Dienst kann bei der Anlage unter Dienste -> Alarmierung konfiguriert werden.
Eine Regel kann getestet werden. Das Ergebnis wird in der Spalte Letzter Zustand dargestellt.
- Klick auf das Symbol zum manuellen Aktualisieren der Regel
- Klick auf das Symbol zum Testen der Regel mit Weiterleitung an Notification Center
Folgende Operationen stehen je nach Konfiguration der Regel zur Verfügung:
| Operationen | Beschreibung |
|---|---|
| Verarbeitung pausieren | |
| Verarbeitung starten | |
| Explizite Meldung an Benachrichtigungskanal Kollaboration via Notification Center senden | |
| Alarm quittieren |
Weiter stehen folgende Aktionen zur Verfügung:
| Aktion | Beschreibung |
|---|---|
| Regel editieren | |
| Regel kopieren | |
| Logs Alarmevents anzeigen | |
| Regel entfernen |
Regeln erstellen
Durch einen Klick auf das Symbol kann eine neue Regel hinzugefügt werden. Folgende Einstellungen können getätigt werden:
Allgemein
| Eigenschaft | Beschreibung |
|---|---|
| Regelname | Name der Regel (wird auch in der HOOC-App für die Funktion Meldung empfangen verwendet) |
| Mehrsprachig … | Übersetzter Regelname, welcher anhand der eingestellten Sprache in der HOOC-App dargestellt werden (optional) |
| Kategorie | Kategorie der Regel (Information, Warung, Alarm) |
| Regel aktiv | Falls aktiv, wird die Regel überprüft, ansonsten nicht |
Falls die Option Melde, falls das Ergebnis der Regel… aus den allgemeinen Einstellungen gesetzt wird, erfolgt die Benachrichtigung mit dem Status OK.
Meldungen
Alarmmeldungen können für die unterschiedlichen Zustände (Alarm, Quittierung und Recovery) individuell erfasst werden.
| Eigenschaft | Beschreibung |
|---|---|
| Titel | Titel der Meldung |
| Nachricht | Nachricht der Meldung |
| Mehrsprachig … | Übersetzte Elmente, welche anhand der benutzerdefinierten Sprache für die Benachrichtigung verwendet werden (optional) |
Es können Platzhalter verwendet werden. Diese werden beim Erstellen der Meldungen durch die entsprechenden Werte ersetzt.
| Platzhalter Beispiel | Beschreibung |
|---|---|
| {{1}}, {{2}}, {{3}} | Wert der entsprechenden Bedingung |
| {{ACKED_BY}} | Name der Person, welche den Alarm quittiert hat (nur bei Quittierung) |
| {{ESCALATION_LEVEL}} | Aktuelle Eskalationsstufe |
Bedingungen
Um eine Regel anzulegen wird im minimum eine Bedingung benötigt. Es können jedoch mehrere Bedingungen miteinander verknüpft werden.
- Klick auf zum anfügen einer neuen Bedingung
- Klick auf zum entfernen der Bedingung
- Die Bedingungen können via Drag and Drop verschoben werden
Logischer Operator
Die erste Bedingung startet immer mit dem logischen Operator WENN. Falls mehrere Bedingungen verwendet werden, stehen mehrere logische Operatoren zur Verfügung:
| logischer Operator | Beschreibung |
|---|---|
| AND | UND Verknüpfung |
| NAND | NICHT-UND Verknüpfung |
| NOR | NICHT-ODER Verknüpfung |
| OR | ODER Verknüpfung |
| XNOR | EXKLUSIV-NICHT-ODER Verknüpfung |
| XOR | EXKLUSIV-ODER Verknüpfung |
Die Bedingungen werden nacheinander miteinander verknüpft. Bedingung_01 verknüpft mit Bedingung_02. Dieses Ergebnis wird dann verknüpft mit Bedingung_03 u.s.w.
Verwendung Datenquelle HOOC Gateway (Secure Remote Access)
Bei der Verwendung der Datenquelle HOOC Gateway kann ausgewählt werden, ob als Bedingung der Verbindungsstatus des HOOC-Gateways einer Zeitperiode verwenden möchte, oder ob eine Abfrage auf die Anzahl Benutzerverbindungen zur Anlage gemacht werden soll.
Verwendung Datenquelle Datenpunkt (Secure Remote Control)
Bei der Verwendung der Datenquelle Datenpunkt kann mittels Drop-Down der gewünschte Datenpunkt ausgewählt werden.
Falls der Datenpunktname im Dienst Secure Remote Control geändert wird, wird diese Einstellung nicht automatisch in diesen Dienst übernommen. Dies wird dazu führen, dass das Resultat der entsprechenden Regel nicht mehr korrekt sein wird.
Die Abfragedefinitionen sind wie folgt unterteilt:
| Abfragedefinition | Beschreibung |
|---|---|
| Mittelwert | Summe aller Messwerte des Zeitraums geteilt durch Anzahl Messwerte des Zeitraums (Arithmetisches Mittel) |
| Median | Messwerte werden aufsteigend sortiert und derjenige Wert “in der Mitte” wird verwendet |
| Wertgültigkeit | Falls der Datenpunktwert eines ereignisgesteuerten Protokolls (Bspw. KNX) für den gesamten Zeitraum als ungültig markiert ist (Letzter bekannter Wert), wird der Wert 0 (nicht in Ordnung) zugewiesen |
Nach der Auswahl der Abfragedefinitionen des Datenpunkts können Vergleichsoperator und die entsprechenden Grenzwerte erfasst werden.
Bei nicht Ereignisgesteuerten Protokollen (Bspw. Modbus) wird falls keine Werte des Datenpunktes vorhanden sind, der Wert null zugewiesen. Bei Ereignisgesteuerten Protokollen (Bspw. KNX) kann die Gültigkeit des Datenpunkts mit der Abfragedefinition Wertgültigkeit überprüft werden.
Verwendung Datenquelle KNX Endgerät (Secure Remote Control)
Bei der Verwendung der Datenquelle KNX Endgerät kann die Verbindung zum KNX-Gateway/Router oder die Busauslastung überwacht werden.
Verwendung Datenquelle LoRa Endgerät (Secure Remote Control)
Bei der Verwendung der Datenquelle LoRa Endgerät kann die Verbindung zu einem bestimmten LoRA Endgerät überwacht werden. Die Verbindung ist getrennt falls vom LoRa Endgerät in der angegebenen Zeitperiode keine Daten empfangen werden konnten.
Vergleichsoperationen
Aus untenstehender Tabelle können die möglichen Verglichsoperationen entnommen werden.
| Beschreibung | Operation | Information |
|---|---|---|
| gleich | Trifft zu wenn (Wert == Feld0) | |
| grösser | Trifft zu wenn (Wert > Feld0) | |
| kleiner | Trifft zu wenn (Wert < Feld0) | |
| innerhalb | Trifft zu wenn ((Wert >= Feld0) && (Wert <= Feld1)) | |
| ausserhalb | Trifft zu wenn ((Wert < Feld0) && (Wert > Feld1)) | |
| null | Trifft zu wenn (Wert == null) | Trifft zu, wenn kein Wert vorhanden ist |
| nur Bits | Trifft zu wenn ((Wert > 0) && ((Wert & Bitmaske) == Wert)) | Falls Resultat vom Wert nicht Ganzzahl ist das Ergebnis FALSCH |
| ein Bit | Trifft zu wenn ((Wert & Bitmaske) > 0) | Falls Resultat vom Wert nicht Ganzzahl ist das Ergebnis FALSCH |
| alle Bits | Trifft zu wenn ((Wert & Bitmaske) == Bitmaske) | Falls Resultat vom Wert nicht Ganzzahl ist das Ergebnis FALSCH |
| kein Bit | Trifft zu wenn ((Wert & Bitmaske) == 0) | Falls Resultat vom Wert nicht Ganzzahl ist das Ergebnis FALSCH |
Testen der Bedingungen
Die erfassten Bedingungen der Regel können mittels Klick auf “Teste Bedingungen” getestet werden, ohne das Meldungen gesendet werden. Nach dem Test kann bei jeder Bedingung folgendes sichtbar sein:
- Der Wert der Datenquelle wird im Tooltip angezeigt
- Resultat Bedingung WAHR
- Resultat Bedingung FALSCH
Das Ergebnis der Regel wird links neben dem Button “Teste Bedingungen” dargestellt.
Eskalation
Im Konfigurationstab Eskalation können die Eskalationsregeln erfasst werden. Mittels Eskalationsregeln wird die Meldung bei anstehendem Ereignis im Meldungsinterval ausgelöst, solange keine Quittierung erfolgte. Es können auch übergeordnete Eskalationsregeln erfasst und zugeordnet werden.
| Eigenschaft | Beschreibung |
|---|---|
| Start Eskalation nach | Zeit nachdem das entsprechende Meldungsinterval verwendet wird |
| Meldungsinterval | In diesem Interval wird die Nachricht bei anstehendem Ereignis versendet |
| Option Eskalation neu starten… | Nach Erreichen der letzten Eskalationsstufe wird wieder bei der ersten Eskalationsstufe begonnen |
| Zeitverzögerung Neustart Eskalation | Zeitverzögerung bis der Neustart der Eskalation erfolgen soll (Wechsel von letzer Eskalationsstufe zur ersten Eskalationsstufe) |
Ein anstehendes Ereignis bzw. Alarm kann mittels Klick auf das Symbol quittiert werden.
Die Eskalationsstufe 0 tritt unmittelbar nach dem eintreten der Bedingungen ein. Falls bei einer Regel Eskalationsregeln erfasst sind, tritt die Eskalationsstufe 1 nach dem eintreten der ersten Bedingung ein.
Kollaboartion
Im Konfigurationstab Kollaboration können die individuellen Einstellungen im Zusammenhang mit dem Dienst HOOC Kollaboration konfiguriert werden. Falls Empfänger von HOOC Kollaboration benachrichtigt werden sollen, muss zwingend die Option Verwendung im Dient Kollaboration aktiviert werden.
Je Alarmregel können individuelle Meldungstexte für diesen Benachrichtigungskanal definiert werden.
Weiteres
Die Benachrichtigung kann auch an bspw. externe E-Mail Empfänger gesendet werden. Diese Funktionalität steht im HOOC Notification Center zur Verfügung.
Verwendung in der HOOC-App
Die Funktionalitäten für die Benachrichtigungskanäle, Konfiguration zum Empfangen von Meldungen und die Mitteilungszentrale stehen in der HOOC-App zur Verfügung. Weiter können folgende Eisntellungen getätigt werden:
- Alarme können im Menü Alarmierung quittiert werden, indem das entsprechende Element nach Rechts gewischt wird.
- Die Einstellungen für die Optionen Benachrichtigungskanäle können je Anlage im Menü Mehr vorgenommen werden.