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:
| Titel | Beschreibung |
|---|---|
| Angleichung der Feldzuordnung an die üblichen Datenbankfelder von EDP | Standardmäßig findet keine Unterteilung in Einsatzstichwort 1 bis 4 mehr statt. Stattdessen wird das dort befüllte Feld extrahiert und in das normale Stichwortfeld von EDP übernommen. Die Informationen, die die Leitstelle im Feld FREITEXT übermittelt, werden in EDP jetzt dem Feld Bemerkung zugeordnet. Damit können Sie auch im Betrieb der KEZ die übliche Einsatzmaske von EDP mit Anzeige von Meldebild bzw. Schlagwort und dem Block Bemerkung verwenden. Auch mit edp:web 3 besteht dann volle Kompatibilität. |
| Zuordnung via EXTERNAL_ID | Bei Einsatzmitteln und Einsätzen wird jeweils das Feld EXTERNAL_ID zur Zuordnung der ID aus ELDIS verwendet. |
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.
kezsrv im EDP-Hauptverzeichnis (C:\EDP\kezsrv).kezservice.exe per Rechtsklick → „Eigenschaften“ Adminrechte.kezservice.exe aus und ergänzen Sie /install. Klicken Sie dann auf „OK“.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:
| Titel | Hinweis |
|---|---|
| Neue Schnittstellenversion | Laden Sie die aktuelle Version der KEZ-Schnittstelle herunter. Entpacken Sie das ZIP-Archiv und kopieren Sie die Dateien „kezservice.exe“, „libmysql.dll“, „libeay32.dll“ und „ssleay32.dll“ in das Verzeichnis der KEZ-Schnittstelle. Falls noch nicht geschehen, beenden Sie vorher den Dienst „kezsrv“. |
| 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 | Ab EDP2023 wird zur Identifikation der Einsatzmittel nicht mehr das Datenbankfeld ELDIS_ID verwendet. Stattdessen gibt es in EDP ein allgemeines Feld EXTERNAL_ID, das auch im Editor angezeigt wird. Beim Ausführen des DBUpdates werden die Daten automatisch übernommen. |
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.
[Database] Hostname=127.0.0.1 Database=EDPdb User=root Passwort=IhrPasswort
Geben Sie die Verbindungsdaten zum EDP-Server an:
[EDP-Server] Host=localhost Port=2200
Legen Sie den Port fest, auf dem der Webserver erreichbar sein soll.
[Server] WS-Port=443
Hier tragen Sie die Adresse des Webservers der ILS ein.
[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.
[Funktionen] Status=1 Wiederholen=0
Die Grunddaten für die Einsatznummer KEZ werden automatisch geschrieben. Die ILS-Kennung müssen Sie angeben.
[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:
[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)