KEZ-Schnittstelle

Die KEZ-Schnittstelle überträgt Daten zwischen ILS und KEZ sowie zwischen KEZ und der Einsatznachbearbeitung (MGM Server). Diese Seite beschreibt Installation, Funktionen und Konfiguration der KEZ-Schnittstelle in der Version 2.5.

Hinweis: Mit der Version 2.5 wurden einige relevante Änderungen an der KEZ-Schnittstelle vorgenommen. Wenn Sie ein Update von einer Vorgängerversion durchführen, lesen Sie bitte unbedingt die folgenden Hinweise zu den Neuerungen.

Downloadlink: KEZ-Schnittstelle Version 2.5 downloaden

In der Version 2.5 wurden in der KEZ-Schnittstelle folgende Änderungen vorgenommen:

Dieser Abschnitt beschreibt nur die Erstinstallation der KEZ-Schnittstelle. Für ein Update genügt es, den Dienst KEZ-Schnittstelle zu beenden und anschließend die Dateien auszutauschen. Die Ini-Datei darf dabei nicht überschrieben werden.

Anders als die übrigen Schnittstellen wird die KEZ-Schnittstelle als eigenständiger Dienst betrieben und verwaltet. Sie wird also nicht über die EDP-Konfiguration hinzugefügt, sondern als eigener Windows-Dienst registriert. Danach können Sie sie über die Dienstverwaltung von Windows oder in der EDP-Konfiguration einzeln starten und beenden.

Die aktuelle Version der KEZ-Schnittstelle erhalten Sie über den Downloadlink oben auf dieser Seite.

1. Entpacken Sie das ZIP-Archiv in einen eigenen Ordner, am besten in den Unterordner kezsrv im EDP-Hauptverzeichnis (C:\EDP\kezsrv).
2. Geben Sie der Anwendung kezservice.exe per Rechtsklick → „Eigenschaften“ Adminrechte.
3. Öffnen Sie den Ausführen-Dialog von Windows, wählen Sie die kezservice.exe aus und ergänzen Sie /install. Klicken Sie dann auf „OK“.
4. Nach erfolgreicher Installation erscheint die Meldung „Dienst erfolgreich installiert“.

Die KEZ-Schnittstelle ist damit an diesem Ort als Windows-Dienst registriert und kann über die Dienstverwaltung von Windows gestartet und beendet werden. Der Dienst wird auch in der EDP-Konfiguration angezeigt.

Beachten Sie beim Umstieg von EDP 4.9 auf EDP2023 mit MariaDB folgende Hinweise:

Die KEZ-Schnittstelle dient der Datenübertragung zwischen ILS und KEZ sowie zwischen KEZ und Einsatznachbearbeitung (MGM Server). Die ILS übergibt Daten an die KEZ, die KEZ gibt Daten an den MGM Server der Einsatznachbearbeitung weiter.

Folgende Aktionen sind vorhanden.

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

Die ILS leitet einen Einsatz zur Information an die KEZ weiter. Der Einsatz wird in der ILS weiterbearbeitet, die KEZ übermittelt keine Daten an die Einsatznachbearbeitung.

Die ILS übergibt ein Einsatzmittel an die KEZ. Die KEZ kann dieses Einsatzmittel dann eigenständig disponieren. Die KEZ-Schnittstelle setzt das Einsatzmittel dazu nur in den Status 2. Hintergrund ist die Absprache, dass alle Einsatzmittel der KEZ standardmäßig im Status 6 stehen. Zusätzlich wird der Haken „EM in Verwendung“ automatisch gesetzt.

In diesem Abschnitt ist beschrieben, welche Daten die KEZ-Schnittstelle von sich aus weitergibt.

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

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

In beiden Fällen werden jeweils der aktuelle Stand der Maßnahmen, Rückmeldungen, Patientendaten und Einsatzmittel/Statusdaten übermittelt.

Einen in der KEZ angelegten Einsatz können Sie über die KEZ-Schnittstelle an den Server der Einsatznachbearbeitung übergeben. Klicken Sie dazu in der Ribbonleiste im Reiter „KEZ“ auf den Button „An MGM Server senden“.

Die KEZ-Schnittstelle wird über die zugehörige Ini-Datei kez.ini konfiguriert. Folgende Daten legen Sie dort fest.

Geben Sie hier die Verbindungsdaten zur Datenbank an.

kez.ini

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

Geben Sie die Verbindungsdaten zum EDP-Server an:

kez.ini

[EDP-Server]
Host=localhost
Port=2200

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

kez.ini

[Server]
WS-Port=443

Hier tragen Sie die Adresse des Webservers der ILS ein.

kez.ini

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

Die Übermittlung der Status „Disponiert“ und „Abgeschlossen“ an den MGM Server lässt sich deaktivieren. Steht Wiederholen auf 1, wird eine fehlgeschlagene Übermittlung bei jedem Durchlauf erneut versucht. Bei vielen Einsätzen kann das zu Performance-Problemen führen. Aktivieren Sie diese Option deshalb nur in Ausnahmefällen.

kez.ini

[Funktionen]
Status=1
Wiederholen=0

Die Grunddaten für die Einsatznummer KEZ werden automatisch geschrieben. Die ILS-Kennung müssen Sie angeben.

kez.ini

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

Standardmäßig überträgt die KEZ-Schnittstelle im Parameter Ortsteil zusätzlich die Kommune (z.B. Musterstadt - Musterort). Die Kommune kann aus diesem Parameter entfernt werden:

kez.ini

[Ortsteil]
RemoveOrt=1

Die Lizenz enthält den Namen der KEZ, unter dem sie in ELDIS angelegt ist (z.B. 1.2.3 KEZ Musterstadt). Dieser Name wird bei der Kommunikation mit der ILS übermittelt. Für eine korrekte Datenübermittlung muss der KEZ-Name deshalb stimmen.

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 können Sie auch selbst erstellen: Anleitung zum Erstellen eines Zertifikats

Für den Betrieb der KEZ-Schnittstelle müssen die Einsatzmittel mit ihrer ELDIS-ID in EDP hinterlegt sein.

Die KEZ-Schnittstelle ordnet Einsatzmittel über deren ID in ELDIS zu. Deshalb müssen die Einsatzmittel mit der jeweiligen ID in EDP hinterlegt sein. Die ID steht im Feld EXTERNAL_ID, das auch im Editor in der Liste der Einsatzmittel sichtbar ist.

Empfehlenswert ist eine CSV-Datei im üblichen CSV-Format zum Datenimport des EDP Editors. Das Feld für die ELDIS-ID heißt EXTERNAL_ID.

Für die KEZ-Schnittstelle werden folgende Datenbankfelder 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)

• Es werden keine Daten von der ILS empfangen

• Interne Infos