Grundlagen zur COBRA4 Schnittstelle

Die Schnittstelle von FE2 zu COBRA4 basiert auf der WDX3 Schnittstelle und setzt eine C4 Version 4.18.4 voraus. Folgende Daten können über die Schnittstelle abgerufen werden:

• Übertragung von Einsatzdaten

• Übertragung von Einsatzmitteldaten (Ressourcen)

• Übertragung von Gerätedaten

Folgende Voraussetzungen müssen für den Betrieb erfüllt werden:

• FE2 ab Version 2.19
• COBRA 4 ab Version 4.18.4
• Freischaltung und Erwerb der WDX3-Alamos-FE2 Schnittstelle bei ISE
• Server Zertifikat des WDX3 Servers
• Generiertes Client Zertifikat für FE2
• Zugriffsdaten für Alarm Schnittstelle (für Zugriff auf Einsatzdaten)
• Zugriffsdaten für Ressourcen Schnittstelle (für Zugriff auf Einsatzmittel und Status)

Die Zertifikate erhalten Sie bei ISE direkt. Diese werden nicht mit FE2 ausgeliefert.

Wie werden Alarmierungen in FE2 generiert?

Grundsätzlich gibt es drei Möglichkeiten, wie Einheiten bei einem Alarm direkt aus COBRA4 angesteuert werden können.

• Möglichkeit 1: Einheit mit Client-ID als Einheiten-Code

• Möglichkeit 2: Alarmierung einer zugewiesenen Ressource

• Möglichkeit 3: Alarmierung eines Gerätes

Möglichkeit 1: Alarmierung anhand einer Standardeinheit

Einheiten-Code: Client-ID

• Diese Einheit wird bei jeder Alarmierung über Geräte oder Fahrzeuge mit ausgelöst

• Diese Variante kann als zentrale Verteilung von Alarmen innerhalb des Alarmablaufes verwendet werden

• Bevorzugte Variante

Möglichkeit 2: Alarmierung anhand zugewiesener Ressourcen

Einheiten-Code: ID der Ressource

• Nach Anlegen eines Einsatzes werden Ressourcen für den entsprechenden Einsatz disponiert. Diese Ressourcen können Fahrzeugen entsprechen oder sonstige Ressourcen abbilden

• Jede Ressource hat in C4 eine eindeutige ID. Sobald eine Einheit mit genau dieser ID als Einheiten-Code gefunden wird, wird diese Einheit automatisch mit allen Einsatzdaten alarmiert.

Möglichkeit 3: Alarmierung anhand alarmierter Geräte

Einheiten-Code: Gerätename oder ID des Gerätes

Diese Funktion setzt FE2 und das WDX3 Update ab Januar 2022 voraus. Sollten diese Voraussetzungen erfüllt sein, so kann FE2 aus alarmierten Geräten automatisch Einheiten alarmieren.

Hierbei muss eine Einheit mit folgendem Einheiten-Code erstellt werden:

• Name des Gerätes oder

• Kennung des Gerätes (ID)

Die Auflistung entspricht auch die Reihenfolge, in welcher eine passende Einheit gesucht wird. Dies bedeutet, dass zunächst versucht wird, Geräte anhand ihrer Bezeichnung zu alarmieren. Sollte hier keine Einheit gefunden werden, wird die Geräte ID als Rückfallebene verwendet.

Verhalten der Schnittstelle

Alarmdaten über COBRA 4

Die Daten eines Alarms werden schrittweise aktualisiert. So kann es sein, dass im initialen Alarm die Datensätze noch nicht vollständig vorliegen.

Automatisches Schließen eines Einsatzes

Sobald in C4 ein Einsatz geschlossen wird, werden alle Alarme in FE2 geschlossen, welche von diesem Einsatz ausgelöst worden sind.

Einsatzaktualisierung

Die eingehenden Einsätze werden auf Änderungen überprüft. Änderungen in folgenden Parametern lösen hierbei Änderungen bzw. Aktualisierungen aus:

• Patientendaten (siehe Einstellungen)

• COBRA_keyword_code_1

• COBRA_keyword_code_2

• COBRA_keyword_code_3

• COBRA_keyword_code_4

• Koordinaten (lat, lng)

• Adresse (location_dest)

• Zieladresse (target_dest)

• Schlüsselwort (keyword)

• Priorität und Sonderrechte (COBRA_ADDITIONAL_priority, COBRA_ADDITIONAL_special_rights)

• Geräte (COBRA_DEVICE_alerted)

• Stationen (COBRA_current_station_with_vehicle)

Einstellungen vom Eingang

Patientendaten

Benutzername (Patienten Schnittstelle) 

Wenn Sie Zugriff auf die Patienten Schnittstelle haben möchten, so müssen Sie hier den entsprechenden Benutzernamen angeben

Passwort (Patienten Schnittstelle)

Geben Sie das entsprechende Passwort für den oben eingegebenen Benutzername an.

Bei Einsatzaktualisierung Patienten überprüfen

Ist diese Option aktiviert, werden Änderungen der Patientendaten bei der Überprüfung auf Aktualisierung berücksichtigt.

Ressourcen/Fahrzeugdaten

Benutzername (Ressourcen Schnittstelle) 

Wenn Sie Zugriff auf die Ressourcen Schnittstelle haben möchten, so müssen Sie hier den entsprechenden Benutzernamen angeben

Passwort (Ressourcen Schnittstelle)

Geben Sie das entsprechende Passwort für den oben eingegebenen Benutzername an.

Gerätedaten

Benutzername (Maßnahmen Schnittstelle)

Wenn Sie Zugriff auf die Maßnahmen Schnittstelle haben möchten, so müssen Sie hier den entsprechenden Benutzernamen angeben

Passwort (Maßnahmen Schnittstelle)

Geben Sie das entsprechende Passwort für den oben eingegebenen Benutzername an.

Benutzername (Geräte Schnittstelle)

Wenn Sie Zugriff auf die Geräte Schnittstelle haben möchten, so müssen Sie hier den entsprechenden Benutzernamen angeben. Für die Verwendung dieser Schnittstelle wird zusätzlich die Maßnahmen Schnittstelle benötigt.

Passwort (Geräte Schnittstelle)

Geben Sie das entsprechende Passwort für den oben eingegebenen Benutzername an.

Alarmdaten

Benutzername (Alarm Schnittstelle) 

Wenn Sie Zugriff auf die Alarm Schnittstelle haben möchten, so müssen Sie hier den entsprechenden Benutzernamen angeben

Passwort (Alarm Schnittstelle)

Geben Sie das entsprechende Passwort für den oben eingegebenen Benutzername an.

Benutzername (Nachrichten Schnittstelle) 

Wenn Sie Zugriff auf die Nachrichten Schnittstelle haben möchten, so müssen Sie hier den entsprechenden Benutzernamen angeben. Relevant für das Ausgangsplugin COBRA Rückmeldungen .

Passwort (Nachrichten Schnittstelle)

Geben Sie das entsprechende Passwort für den oben eingegebenen Benutzername an.

Server

Geben Sie die Adresse und den Port des WDX3-C4 Servers an

Client-ID

Geben Sie hier Ihre zugewiesene Client-ID an. Achten Sie dabei auf Groß- und Kleinschreibung

Zertifikate und Schlüssel: Alle nachfolgenden Dateien müssen in folgendem Ordner platziert werden:

/FE2/Config/cobra

Server-Zertifikat

Damit Verbindungen zum Server akzeptiert werden, müssen Sie das Server-Zertifikat im .pem Format importieren. Geben Sie hier den entsprechenden Dateinamen an. 

Client-Zertifikat

Geben Sie den Dateinamen Ihres Client-Zertifikates an.

Client-Schlüssel

Geben Sie den Dateinamen Ihres geheimen Zertifikatsschlüssels an.

Erstellung Parameter 'keyword'

Hier können Sie den Modus wählen, wie der Parameter keyword erstellt wird.

Ersetzung von Schlüsselcodes

Zielparameter in FE2 für Ersetzung der Schlüsselcodes

In diesem Feld können Sie die gewünschten Parameter angeben, auf denen die Ersetzungen durchgeführt werden soll. Die Angabe muss zwingend in folgender Form gemacht werden:

COBRA_keyword_code_1
COBRA_keyword_code_2
COBRA_keyword_code_3
COBRA_keyword_code_4

Achten Sie bitte hierbei darauf, die Parameter in jeweils eine Zeile zu schreiben und auf deren Schreibweise. Die Definition der Ersetzungen erfolgt, wie im Abschnitt darunter beschrieben.

Dateiname der CSV-Datei mit den Übersetzungen der Schlüsselcodes

Optional kann hier eine Datei angegeben werden, um eine Übersetzung zu importieren. Es werden die angegebenen Parameter im Feld darüber für eine Übereinstimmung des Schlüsselcode verwendet.

Das Format der Datei muss wie eines der folgenden aussehen und die Kopfzeile identisch enthalten:

ohne Einsatzart:

Code-Nr.;Klartext

Beispiel:

Code-Nr.;Klartext
001;Übersetzung 1
002;Übersetzung 2
001;Übersetzung 3

mit Einsatzart:

Code-Nr.;Klartext;Einsatzart

Die Einsatzart kann für die Codes angegeben werden, wenn sich die Übersetzungen für die Schlüsselcodes unterscheiden.

Beispiel:

Code-Nr.;Klartext;Einsatzart
001;Übersetzung 1;B
002;Übersetzung 2;B
001;Übersetzung 3;H

Diese Datei muss in den folgenden Ordner platziert werden:

/FE2/Config/cobra

Einheiten für Status-Übermittlung

Ab Version können Sie hier Einheit auswählen, welche bei jeder Statusänderung (egal ob Sie hierfür ein Fahrzeug angelegt haben oder nicht) auslöst. Diese Funktion kann nützlich sein, falls Sie den Status via Connect weiterleiten möchten.