KEZ Schnittstelle

Hinweis für den Umstieg auf EDP 2023

Bitte beachten Sie die folgenden Hinweise für den Umstieg von EDP 4.9 auf EDP2023 mit MariaDB:

Titel Hinweis
Neue Schnittstellenversion Laden Sie die aktuelle Version der Schnittstelle hier herunter. Entpacken Sie das ZIP-Archiv und kopieren Sie die Dateien „kezservice.exe“, „libmysql.dll“, „libeay32.dll“ und „ssleay32.dll“ aus dem ZIP-Archiv in das Verzeichnis der KEZ-Schnittstelle. Falls noch nicht geschehen muss der Dienst „kezsrv“ vorher beendet werden.
Ini-Datei anpassen Öffnen Sie die Ini-Datei „kez.ini“ und ändern Sie die Verbindungsdaten zur Datenbank (127.0.0.1 als Host, root als Benutzer, das von Ihnen vergebene Passwort für den Root-Benutzer sowie „EDPdb“ als Name der Datenbank.
ELDIS_ID der Einsatzmittel Mit Umstieg auf EDP2023 wird zur Identifikation der Einsatzmittel nicht mehr länger das Datenbankfeld ELDIS_ID verwendet. Stattdessen steht in EDP nun ein allgemeines Feld EXTERNAL_ID zur Verfügung, das auch im Editor angezeigt wird. Beim Ausführen des DBUpdates werden diese Daten automatisch übernommen.

Funktionen

Die KEZ Schnittstelle dient zur Datenübertragung zwischen ILS und KEZ sowie KEZ und Einsatznachbearbeitung (MGM Server). Dabei werden Daten von der ILS an die KEZ übergeben sowie von der KEZ an den MGM Server der Einsatznachbearbeitung.

Folgende Aktionen sind vorhanden:

Einsatzweiterleitung

Die ILS leitet einen Einsatz zur Weiterbearbeitung an die KEZ weiter. Die KEZ Schnittstelle meldet eine entsprechende Statusmeldung an den Einsatznachbearbeitungsserver, wenn der Einsatz disponiert wurde und wenn der Einsatz abgeschlossen wurde. Dabei werden auch die weiter erfassten Daten (Einsatzmittel, Rückmeldungen, usw.) mit übermittelt.

EinsatzInfoweiterleitung

Ein Einsatz wird zur Information von der ILS an die KEZ weitergeleitet. Der Einsatz wird in der ILS weiter bearbeitet und von Seiten der KEZ findet keine Datenübermittlung an die Einsatznachbearbeitung statt.

Einsatzmittelübergabe

Ein Einsatzmittel wird von der ILS an die KEZ übergeben. Die KEZ kann dieses Einsatzmittel nun eigenständig disponieren. Über die KEZ-Schnittstelle wird das Einsatzmittel hierzu nur in den Status 2 gesetzt. Hintergrund ist die Absprache, dass alle Einsatzmittel der KEZ standardmäßig im Status 6 stehen.

Datenübermittlung KEZ -> ILS

Statusmeldung Einsatzweiterleitung

Die KEZ-Schnittstelle übermittelt automatisch die Statusmeldung „Disponoiert“ an den Server der Einsatznachbearbeitung, wenn der entsprechende Einsatz den Status „Disponiert“ in EDP erhalten hat.

Nach Abschluss des Einsatzes wird der Status „Fertiggestellt“ automatisch an den MGM Server übermittelt.

Bei beiden Wegen werden jeweils der aktuell Stand der Maßnahmen, Rückmeldungen, Patientendaten und Einsatzmittel / Statusdaten übermittelt.

Einsatzmeldung KEZ -> ILS

Ein in der KEZ angelegter Einsatz kann über die KEZ Schnittstelle an den Server der Einsatznachbearbeitung übergeben werden. Hierzu ist ein Klick auf den Button „An MGM Server senden“ im Reiter „KEZ“ der Ribbonleiste erforderlich.

Konfiguration

Die Konfiguration der KEZ-Schnittstelle erfolgt über die zugehörige Ini-Datei mit dem Namen „kez.ini“.

Folgende Daten werden in der Ini-Datei konfiguriert.

Datenbank

Hier geben Sie die Verbindungsdaten zur Datenbank an.

[Database]
Hostname=127.0.0.1
Database=EDPdb
User=root
Passwort=IhrPasswort

EDP Server

Geben Sie die Verbindungsdaten zum EDP-Server an:

[EDP-Server]
Host=localhost
Port=2200

Webserver

Definieren Sie den Port, auf dem der Webserver erreichbar sein soll.

[Server]
WS-Port=443

Webserver ILS

[ILS]
Host=https://1.2.3.4:443

Statusübermittlung an MGM aktivieren

Die Übermittlung des Status „Disponiert“ und „Abgeschlossen“ an den MGM Server kann deaktiviert werden. Wenn der Wert für Wiederholen auf 1 gesetzt wird, wird eine fehlgeschlagene Übermittlung bei jedem Anlauf erneut versucht. Dies kann bei einer Vielzahl Einsätzen zu Performance-Problemen führen.

[Funktionen]
Status=1
Wiederholen=0

Einsatznummer KEZ

Die Grunddaten für die Einsatznummer KEZ werden automatisch geschrieben. Die ILS Kennung muss angegeben werden.

[KEZ-NR]
Lfd.-Nr.=1
ILS Kennung=1.3
KEZ-ID=1

Lizenz

Die Lzenz enthält den Namen der KEZ, mit dem sie in ELDIS angelegt ist (z.B. 1.2.3 KEZ Musterstadt). Da dieser Namen bei der Kommunikation mit der ILS übermittelt werden muss, ist der richtig KEZ Name für die korrekte Datenübermittlung erforderlich.

Weiterleitung intern

Funktionweise

Wenn in einem Landkreis mehrere Abschnittsführungsstellen / Kreiseinsatzzentralen aktiv sein sollen, müssen die Einsätze auf Kreisebene intern weiterverteilt werden, da in ELDIS nur eine Übergabe an eine KEZ pro Landkreis vorgesehen ist.

Die Weiterleitungsfunktion sieht für die primäre KEZ des Landkreises eine Prüfung der Postleitzahl eines Einsatzes im Rahmen der Datenübernahme vor. Die Schnittstelle kann so konfiguriert werden, dass Einsätze mit bestimmten Postleitzahlen an eine andere KEZ-Schnittstelle weitergeleitet werden. Eine Weiterleitung von Einsatzmittelfreigaben erfolgt nicht.

Wurde ein Einsatz erfolgreich weitergeleitet, so wird er zwar in der primären KEZ als Einsatz erstellt, allerdings mit der Info versehen, dass er erfolgreich weitergeleitet wurde.

Schlägt die Übertragung fehl, wird der Einsatz in der primären KEZ als unerledigter Einsatz angelegt.

Rückübermittlung zum MGM Server

Die Rückübermittlung der Daten von EDP zu ELDIS / MGM Server erfolgt über die KEZ-Schnittstelle der jeweils bearbeitenden AFüSt. Daher ist es erforderlich, dass die Abschnittsführungsstellen auch die Bezeichnung der KEZ als Namen in der Lizenz eingetragen hat.

Wenn Sie die Weiterleitung an eine andere KEZ nutzen, müssten Sie eine Datei „Weiterleitung.ini“ erstellen.

[Weiterleitung]
12345=https://1.2.3.4:443

SSL Zertifikate

Der Webservice der KEZ ist über HTTPS (SSL Verschlüsselung) erreichbar. Die zugehörigen Zertifikate (kez.cer und kez.key) liegen im Hauptverzeichnis der KEZ Schnittstelle und sollten gegen eigene Zertifikate ausgetauscht werden.

Ein Zertifikat kann auch selbst erstellt werden: Anleitung zum Erstellen eines Zertifikats

Datenimport

Einsatzmittel

Da die Einsatzmittel in der KEZ-Schnittstelle über die ID des Einsatzmittels in ELDIS zugeordnet werden, müssen die Einsatzmittel mit der jeweiligen ID in EDP hinterlegt werden. Diese ID wird im Feld EXTERNAL_ID hinterlegt, das auch über den Editor in der Liste der Einsatzmittel sichtbar ist.

Zu empfehlen ist hier eine CSV-Datei entsprechend des üblichen CSV Formats zum Datenimport im EDP Editor. Der Name des Feldes für die Eldis-ID lautet „EXTERNAL_ID“.

Zusätzliche Datenbankfelder

Folgende Datenbankfelder werden für die KEZ-Schnittstelle zusätzlich angelegt:

ALTER TABLE EINSAETZE ADD EINSATZSTICHWORT1 VARCHAR(100);
ALTER TABLE EINSAETZE ADD EINSATZSTICHWORT2 VARCHAR(100);
ALTER TABLE EINSAETZE ADD EINSATZSTICHWORT3 VARCHAR(100);
ALTER TABLE EINSAETZE ADD EINSATZSTICHWORT4 VARCHAR(100);
ALTER TABLE EINSAETZE ADD FREITEXT VARCHAR(500);
ALTER TABLE EINSAETZE ADD ABSCHLUSSWORT VARCHAR(100);
ALTER TABLE EINSAETZE ADD EINSATZNR VARCHAR(25);
ALTER TABLE EINSAETZE  ADD KEZ_CREATED INTEGER DEFAULT 1;
ALTER TABLE EINSAETZE  ADD BACKTOILS INTEGER;
ALTER TABLE EINSAETZE ADD  KEZ_STATUS VARCHAR(1);

ALTER TABLE RUECKMELDUNGEN  ADD ELDIS_ID BIGINT;
ALTER TABLE PATIENTEN  ADD ELDIS_ID BIGINT;
INSERT INTO OPTIONEN (NAME,WERT,VISIBLE) VALUES ('KEZ_VERSION','0.9',0)

FAQs

Intern