Alarmfusion

Das Alarmfusion-Plugin ermöglicht die automatische Zusammenführung (“Fusion”) von zwei Alarmen aus unterschiedlichen Eingangsquellen zu einem einzigen, kombinierten Alarm. Dies ist insbesondere dann nützlich, wenn für denselben Einsatz Alarmdaten über verschiedene Wege eingehen (z.B. TETRA-Funk und externe Schnittstelle) und diese zu einem vollständigen Datensatz vereint werden sollen.

Voraussetzungen

Es werden immer genau zwei Plugin-Instanzen benötigt: eine mit der Rolle "Primär" und eine mit der Rolle "Sekundär".
Beide Instanzen müssen dieselbe Merge-Gruppen-ID und denselben Matching-Parameter verwenden.

Hinweis:

Die Merge-Gruppen-ID ist ein Identifizierungsmerkmal für FE2, um zusammengehörige Alarmfusion-Plugins zu erkennen. Man kann es sich vorstellen wie eine Hausnummer an einem Mehrparteienhaus - alle mit dieser Hausnummer gehören zum selben Haus.

Zusätzlich gibt es den Matching-Parameter, der dazu dient, die einzelnen Alarme als zusammengehörig zu identifizieren. Technisch ist es natürlich möglich, dass sich Alarme zeitlich überschneiden, während auf den Fusions-Partner gewartet wird (Duplizitätseinsätze). Durch den Matching-Parameter, der z.B. die externalId vergleicht, finden sich so die korrekten Fusions-Paare zusammen.

Einrichtung

Das Plugin wird als Ausgabe-Plugin in der Einheitenkonfiguration eingerichtet. Für eine funktionierende Alarmfusion müssen zwei Einheiten jeweils eine Instanz des Plugins konfiguriert haben:

Einheit A (z.B. TETRA-Eingang):

Rolle: Primär
Merge-Gruppen-ID: z.B. "wache_1"
Matching-Parameter: z.B. "externalId"

Einheit B (z.B. externe Schnittstelle):

Rolle: Sekundär
Merge-Gruppen-ID: z.B. "wache_1" (identisch zu Einheit A)
Matching-Parameter: z.B. "externalId" (identisch zu Einheit A)

Hinweis: sollten sich die Zieleinheiten unterscheiden (wenn z.B. Alarme organisationsübergreifend zusammengeführt werden sollen und jede Organisation eigene Zieleinheiten verwenden will), dann wird der fusionierte Alarm an alle definierten Zieleinheiten weitergeleitet.

Konfigurationsparameter

Rolle	Legt fest, ob diese Plugin-Instanz den primären oder sekundären Alarm empfängt. Bei Konflikten (gleicher Parameter in beiden Alarmen) hat der primäre Alarm Vorrang.
Merge-Gruppen-ID	Eindeutiger Bezeichner, der die zusammengehörigen Plugin-Instanzen gruppiert. Beide Instanzen (Primär und Sekundär) müssen dieselbe ID verwenden. Pflichtfeld
Matching-Parameter	Der Alarm-Parameter, anhand dessen die beiden Alarme einander zugeordnet werden (z.B. "externalId"). Beide Plugin-Instanzen müssen denselben Wert verwenden. Pflichtfeld
Alarm-Karenzzeit (Sekunden)	Wartezeit in Sekunden, wie lange auf den zweiten Alarm gewartet wird, bevor ein Timeout ausgelöst wird. Wertebereich: 0 bis 300 Sekunden. Standardwert: 30 Sekunden Hinweis: die Karenzzeit ist möglichst niedrig zu wählen, da bei fehlendem Partner die Alarmverarbeitung entsprechend verzögert wird!
Update-Karenzzeit (Sekunden)	Wartezeit in Sekunden, wie lange auf das zweite Update gewartet wird, bevor ein Timeout ausgelöst wird. Wertebereich: 0 bis 300 Sekunden. Standardwert: 10 Sekunden Hinweis: die Karenzzeit ist möglichst niedrig zu wählen, da bei fehlendem Partner die Updateverarbeitung entsprechend verzögert wird!
Updates einbringen	Ja: dieses Plugin/diese Pipeline bringt Updates in die Fusion mit ein Nein: dieses Plugin/diese Pipeline bringt Updates in die Fusion mit ein Standardwert: Nein Wenn beide Plugins Nein verwenden, werden keine Updates verarbeitet. Wenn nur ein Plugin Ja verwendet, sollte die Karenzzeit möglichst niedrig gewählt sein.
(Einseitige) Updates in alle Zieleinheiten senden	Wenn aktiviert, werden alle eintreffenden Updates (bei Fusion oder nach Ablauf der eingestellten Karenzzeit) an alle ausgewählten Zieleinheiten (primär und sekundär) weitergeleitet. Wenn deaktiviert, greift die reguläre Logik: Updates warten auf Ehepartner und gehen bei Timeout nur an die ausgewählten Zieleinheit(en) des aktuellen Plugins (primär oder sekundär) Standardwert: Nein
Parameter aus diesem Alarm priorisieren	Hier können Parameter aus einer der beiden Pipelines priorisiert werden. Angabe der Parameter-Namen als kommaseparierte Liste. Beispiel: es sollen aus dem primären Plugin die Alarmdaten, aber aus dem sekundären Plugin die Adresse verwendet werden
Alarmtexte zusammenführen	Wenn aktiviert, werden beide Alarmtexte zusammengeführt und als ein Text an die Zieleinheit(en) weitergeleitet. Wen deaktiviert, ist der sekundäre Alarmtext als zusätzlicher Parameter am Alarm enthalten und kann manuell verwendet werden. Standardwert: Ja
Rückmeldungen übernehmen	Gibt an, ob die Rückmeldungen an nachfolgende Zieleinheiten übergeben werden sollen und welche Pipeline als Quelle verwendet werden soll. Gilt für die Zieleinheiten des aktuellen Plugins! Standardwert: nach Rollen getrennt
Bei Timeout weiterleiten	Wenn aktiviert, wird der bereits eingegangene Alarm auch dann an die ausgewählten Zieleinheit(en) des aktuellen Plugins (primär oder sekundär) weitergeleitet, wenn der zweite Alarm nicht innerhalb der Karenzzeit eintrifft. Standardwert: Ja
Bei Fehler weiterleiten	Wenn aktiviert, wird der Alarm auch bei einem Fehler während der Zusammenführung an die ausgewählten Zieleinheit(en) des aktuellen Plugins (primär oder sekundär) weitergeleitet. Standardwert: Ja
Zieleinheit	Die Einheit(en), an die der zusammengeführte Alarm weitergeleitet wird. Wenn eine Einheit in beiden Plugins ausgewählt wurde, werden alle Einstellungen vom primären Plugin verwendet! Pflichtfeld

Funktionsweise

Der erste Alarm (Primär oder Sekundär) trifft ein. Das Plugin registriert ihn im Merge-Manager und startet einen Timer entsprechend der konfigurierten Karenzzeit.
Trifft der zweite Alarm innerhalb der Karenzzeit ein, wird der Timer gestoppt und beide Alarme werden zusammengeführt. Der kombinierte Alarm wird an die Zieleinheit(en) weitergeleitet.
Trifft der zweite Alarm nicht rechtzeitig ein (Timeout), wird je nach Konfiguration der bereits eingetroffene Alarm an die Zieleinheit(en) weitergeleitet oder verworfen.

Zusammenführungs-Regeln

Bei der Zusammenführung gelten folgende Regeln:

Bei gleichen Parametern in beiden Alarmen hat der primäre Alarm Vorrang
Parameter, die nur im sekundären Alarm vorhanden sind, werden entsprechend ergänzt
Die Alarmzeit des verheirateten Alarms wird im Rahmen der Fusion erneuert. Die originalen Alarmzeiten sind als eigene Parameter am Alarm enthalten
Fahrzeuglisten werden zusammengeführt (Duplikate entfernt)
TETRA-Rückmeldungen und -Verfügbarkeiten werden aus beiden Alarmen übernommen
Drohnen-Streams werden aus beiden Alarmen übernommen
Rückmeldungen beider Alarme werden nach der im Plugin ausgewählten Regel zusammengeführt

Fehlerbehebung

Alarme werden nicht zusammengeführt:
Prüfen, ob beide Plugin-Instanzen dieselbe Merge-Gruppen-ID und denselben Matching-Parameter verwenden. Prüfen, ob der konfigurierte Matching-Parameter tatsächlich in den eingehenden Alarmdaten vorhanden ist.
Timeout tritt regelmäßig auf:
Die Karenzzeit erhöhen, damit beide Alarmquellen genügend Zeit haben, ihre Daten zu liefern.
Alarm wird weitergeleitet, aber nicht zusammengeführt:
Wenn der Matching-Parameter im eingehenden Alarm leer ist, kann keine Zuordnung erfolgen. Der Alarm wird je nach Konfiguration direkt weitergeleitet. Prüfen, ob die Alarmquelle den erwarteten Parameter liefert.