====== KEZ Schnittstelle ======
===== Wichtiger Hinweis: Umstellung Schlagworte ab KW43/2021 =====
Ab der KW43 werden die endständigen Leerzeichen in den Schlagworten entfernt. Der folgende SQL-Befehl kann über den EDP-Editor (Werkzeuge -> SQL Editor) ausgeführt werden, um diese zu entfernen:
update meldebilder set meldebild=trim(meldebild)
===== Allgemein =====
Die KEZ Schnittstelle ist seit der Version 2.0 ein Windowsdienst (Name "kezsrv"), der alle Funktionen der KEZ Schnittstelle eigenständig ausführt.
==== 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=localhost
Database=C:\Programme\EDP\Server\EDP.fdb
User=SYSDBA
Passwort=masterkey
==== 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:
{{ :edpweb:erstellen_eines_zertifikats.pdf |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 importiert werden. Bei einer Einsatzmittelanlage in EDP direkt ist keine Zuordnung möglich.
Zu empfehlen ist hier eine CSV-Datei entsprechend des üblichen [[editor:import|CSV Formats zum Datenimport]] im EDP Editor. Der Name des Feldes für die Eldis-ID lautet "ELDIS_ID".
=== Importtool für Einsatzmittel ===
Da bei einer Aktualisierung Einsatzmittel immer über die CSV-Datei importiert werden müssen, wurde ein spezielles Importtool entwickelt. Dieses ist in der Lage vor dem Import eine "Suchen & Ersetzen" - Funktion durchzuführen und so z.B. standardisiert Rufnamen zu kürzen. Außerdem werden bereits bestehende Einsatzmittel mit den aktuellen Daten der CSV-Datei aktualisiert.
{{:kez:kezimport.zip|Import-Tool downloaden}}
====== Changelog ======
===== Update KEZ Schnittstelle V2.2.1 =====
==== Download ====
Die aktuelle Version der KEZ-Schnittstelle kann hier heruntergeladen werden: [[https://eifert-systems.de/EDP4/kezservice.zip|KEZ-Schnittstelle V 2.2.1]]
Diese Version ist nur mit EDP 4.8.1 oder neuer kompatibel.
=== Einspielen des Updates ===
Für das Einspielen des Updates ersetzen Sie bitte nur die folgenden Dateien Ihrer Installation durch die neuen Dateien aus dem Zip-Archiv:
* kezservice.exe
* koordinaten-konverter.exe
* ssleay32.dll
* libeay32.dll
==== Neuerungen ====
Folgende Änderungen umfasst die neue Version der KEZ-Schnittstelle:
* Die Gauss-Krüger-Koordinate der ILS wird über eine interne Anwendung in WGS84 für EDP umgerechnet. Dies erfolgte in der Vergangenheit über einen Webservice und war vereinzelt fehlgeschlagen.
===== Update KEZ Schnittstelle V2.2 =====
==== Download ====
Die aktuelle Version der KEZ-Schnittstelle kann hier heruntergeladen werden: [[https://eifert-systems.de/EDP4/kezservice_2.2.zip|KEZ-Schnittstelle V 2.2]]
Diese Version ist nur mit EDP 4.8.1 oder neuer kompatibel.
=== Einspielen des Updates ===
Für das Einspielen des Updates ersetzen Sie bitte nur die folgenden Dateien Ihrer Installation durch die neuen Dateien aus dem Zip-Archiv:
* kezservice.exe
* einsatzmittel.sql
* ssleay32.dll
* libeay32.dll
==== Neuerungen ====
Folgende Änderungen umfasst die neue Version der KEZ-Schnittstelle:
* Das Feld "Hausnummer Zusatz" wird nun auch mit verarbeitet
* Für wachverlegte Einsatzmittel wird automatisch der Haken "In Verwendung" gesetzt. Nach diesem Kriterium ist die Gesamtliste der Einsatzmittel filterbar.
* Für die Rückübermittlung von Einsatzdaten werden nur Einsatzmittel übertragen, die über eine ELDIS-ID verfügen und wachverlegt sind (d.h. der Haken "In Verwendung" gesetzt ist).
* Die von der ILS übermittelte Gauss-Krüger-Koordinate der Einsatzstelle wird über einen Webservice in WGS84 umgerechnet und zu dem Einsatz nun direkt gespeichert
====== Zusätzliche Datenbankfelder ======
Folgende Datenbankfelder werden für die KEZ-Schnittstelle zusätzlich angelegt:
ALTER TABLE EINSAETZE ADD ELDIS_ID BIGINT;
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 EINSATZMITTEL ADD ELDIS_ID BIGINT;
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 ======
* [[kez:keinedaten|Es werden keine Daten von der ILS empfangen]]
====== Intern ======
* [[intern:kezschnittstelle|Interne Infos]]