Unterseiten:

• Systemanforderungen des DEMIS-Adapter
• ​LDTv2 als Inputformat
• JSON als Inputformat
• Mapping Labor JSON/LDT -> FHIR

Inhaltsverzeichnis:

• Systemanforderungen des DEMIS-Adapter
• ​LDTv2 als Inputformat
• JSON als Inputformat
• Mapping Labor JSON/LDT -> FHIR

Der Demis-Adapter besteht aus zwei Teilkomponenten:

• demis-adapter - parst JSON/LDTv2-Dateien und generiert Logdateien in entsprechenden Verzeichnissen

• demis-adapter-api - parst Laborkonfigurationsdateien, bildet die HL7 FHIR Nachrichten, ruft den Identity Provider für Tokengenerierung und die Notification-API für die Nachrichtenmeldung auf

Die beiden Teilkomponenten werden in einer JAR Datei mit dem Namen demis-adapter-{VERSION}.jar verpackt.

1. Starten des DEMIS-Adapters

Der Aufruf des DEMIS-Adapters erfolgt über das jeweilige Startskript (start.sh im Ordner linux bzw. start.cmd im Ordner windows).

1.2 Starten für einmalige Ausführung: -runOnlyOnce

Im Startskript kann zusätzlich zu den bereits angegebenen Pflichtparametern beim Start (-apiConf=... -conf=...) ein weiterer, optionaler Parameter angegeben werden, -runOnlyOnce. In diesem Fall liest der Adapter das Queue- und Input-Verzeichnis beim Start genau einmal ein und beendet sich, sobald die Verarbeitung der gefundenen Dateien abgeschlossen und die Informationen an das Backend weitergegeben wurden. Falls das Backend sich im Wartungsmodus befindet, wartet der Adapter und beendet sich erst dann, sobald das Backend wieder verfügbar und die Verarbeitung aller Dateien abgeschlossen ist.

2. Loggen und Ablauf

Nach dem Start wird eine Logdatei im Hintergrund gebaut. Die Logdatei logFile.log wird in dem Verzeichnis abgelegt, in dem auch das Startkommando ausgeführt wurde.

Zuerst werden die Konfigurationsdateien verarbeitet. Wenn ein Konfigurationsfehler entsteht, wird der Demis-Adapter die Fehler in die Logdatei logFile.log schreiben und sich beenden.

Nach erfolgreicher Konfiguration, werden die JSON/LDTv2-Dateien in den Verzeichnissen für die vorverarbeiteten Dateien (siehe unten in Konfigurationparameter queued.lab.results.folder) und für die neu hinzugefügten Dateien (siehe unten in Konfigurationparameter queued.lab.results.folder) vom Demis-Adapter verarbeitet. Im Debug-Modus kann man in der Logdatei zuerst die Mitteilung “checking folder queued.lab.results.folder“ und danach die Mitteilung “starting loop for checking folder incoming.lab.results.folder” sehen.

Jede 2 Sekunden wird der incoming.lab.results.folder auf neu vorliegende Dateien überprüft. Die neuen Dateien werden vorverarbeitet und in dem queued.lab.results.folder verschoben, womit sie für die Weiterverarbeitung vorgesehen sind. Wenn während des Parsens ein Fehler entsteht (z.B. ein LDT2 joker Feld fehlt oder der Wert von Feld 8300/8320 passt nicht zu einem Laborkonfigurationparameter indentifikator), wird der Fehler in eine separate Logdatei gespeichert und zusammen mit der Datei im Verzeichnis error.lab.results.folder abgelegt.

Für jede Erregernachweismeldung wird der Identity Provider zur Tokengenerierung aufgerufen. Der Token wird mit der Erregernachweismeldung an die Notification-API gesendet und dient der Authentifizierung.

Wenn beide Dienste mit 200 OK antworten, wird die Quittung in einer separaten Logdatei zusammen mit der JSON/LDTv2-Datei in dem konfigurierten submitted.lab.results.folder Verzeichnis gespeichert.

Wenn einer der beiden Dienste mit HTTP 503 antwortet, ist dies das Zeichen für serverseitige Wartungsarbeiten. Der DEMIS-Adapter geht dann in eine Ruhephase (keine Dateien werden verarbeitet), deren Dauer durch maintenance.waitnbminutes konfiguriert werden kann.

Wenn einer der Dienste mit einem anderen Code antwortet, wird ein entsprechender Fehler in einer separaten Logdatei gespeichert und zusammen mit der JSON/LDTv2-Datei im Verzeichnis error.lab.results.folder abgelegt.

3. Konfiguration

Die Software-Komponente demis-adapter erhält zum Starten zwei Konfigurationsdateien demis-adapter-api.properties sowie app.properties über das folgende Kommando:

„java -jar {PFAD}/demis-adapter-{VERSION}.jar -apiConf={PFAD}/demis-adapter-api.properties -conf={PFAD}/app.properties“

3.1. Konfigurationsdatei demis-adapter-api.properties

3.1.1. Erläuterungen zu den Konfigurationsparametern

Folgende Konfigurationsparameter in der Datei demis-adapter-api.properties sind anzugeben:

3.1.2. Beispiel demis-adapter-api.properties

debuginfo.enabled=true

fhir.basepath=https://demis.rki.de/notification-api/fhir/

idp.lab.tokenendpoint=https://demis.rki.de/auth/realms/LAB/protocol/openid-connect/token
idp.lab.clientid=demis-adapter
idp.lab.secret=secret_client_secret
# Optional Proxy: use idp.lab.proxy (deprecated) OR idp.lab.proxy.host, idp.lab.proxy.port, idp.lab.proxy.username (optional), idp.lab.proxy.password (optional)
#idp.lab.proxy=192.168.0.1:1234
# OR
#idp.lab.proxy.host=192.168.0.1
#idp.lab.proxy.port=1234
#idp.lab.proxy.username=proxyUser
#idp.lab.proxy.password=proxyPassword

# mtls
idp.lab.truststore=../config/nginx.truststore
idp.lab.truststorepassword=secret

# comma separated file locations for lab configuration (e.g. laborConfigs/labor1.json,laborConfigs/labor2.json)
labor.configfile=../config/labor1.json

3.2. Konfigurationsdatei app.properties

3.2.1 Erläuterungen zu den Konfigurationsparametern

Folgende Konfigurationsparameter in der Datei app.properties sind anzugeben:

3.2.2. Beispiel app.properties

debuginfo.enabled=true

# input/output folders for LDTv2 files
incoming.lab.results.folder=../data/input
submitted.lab.results.folder=../data/done
error.lab.results.folder=../data/error
queued.lab.results.folder=../data/queue

# valid DEMIS jokers in LDTv2 files 
labor.ldt.valid9901=demis_einsender_ansprechpartner,demis_einsender_telefon,demis_einsender_fax,demis_einsender_email,demis_test_code,demis_betroffeneperson_strasse,demis_betroffeneperson_hausnummer,demis_betroffeneperson_plz,demis_betroffeneperson_ort,demis_betroffeneperson_laendercode,demis_betroffeneperson_telefon

# retry configuration
sendretry.nbseconds=60
sendretry.nbattempts=10
sendretry.nbthreads=10

#maintenance mode - Processing will be stopped for a configurable time span when server responds with 503
maintenance.waitnbminutes=30

#target directory for PDF receipts
quittung.lab.results.folder=C:\\quittungen\\pdf

3.3. Laborkonfigurationsdatei

3.3.1. Erläuterungen zu den Konfigurationsparametern

Die voranstehenden Angaben gehen in die Erregernachweismeldung ein.

3.3.2 Zertifikate

Der Zugriff auf DEMIS erfolgt mit einem Labor-individuellen Zertifikat, welches durch das Robert-Koch-Institut (RKI) als p12-Datei bereitgestellt wird.

Umwandlung des p12-Zertifikats in einen jks-Keystore

Aus dem p12-Zertifikat muss ein jks-Keystore erzeugt werden, der in der jeweiligen Labor-spezifischen Konfigurationsdatei angegeben werden muss (siehe unten).

Mit folgenden Befehlen können Sie sich einen solchen Keystore über die Kommandozeile erstellen:

keytool -importkeystore -srckeystore DEMIS-12345_CSM012345678.p12 -srcstoretype PKCS12
 -destkeystore DEMIS-12345_CSM012345678.jks -deststoretype JKS
 -destkeypass NEWPASSWORD -deststorepass NEWPASSWORD -srcstorepass SMSPASSWORD

Konfiguration und Parameter des Zertifikats (idp Properties)

Bitte entnehmen Sie Ihre individuelle DEMIS-Laborkennung aus der Informationsmail des Robert Koch-Instituts zur DEMIS-Registrierung und Zertifikatsbereitstellung (z.B. DEMIS-12345).

Im authcertkeystore geben Sie bitte den Pfad zu der p12-Datei bzw. zu dem jks-Keystore an. Es bietet sich an, die Datei vorher in den Ordner /config zu schieben und so ergibt sich authcertkeystore=../config/DEMIS-12345_CSM012345678-p12.

Das authcertpasswort entspricht bei der Nutzung der p12-Datei dem Passwort, welches Sie per SMS erhalten haben. Bei Nutzung des jks-Keystores entspricht es dem Passwort, welches Sie vergeben haben.

Die individuelle DEMIS-Laborkennung entspricht dem authcertalias in der Konfigurationsdatei. In der Konfigurationsdatei müssen Sie darauf achten, dass Sie Kleinschreibung verwenden (z.B. authcertalias=demis-12345).

Eine weitere Möglichkeit zur Ermittlung des authcertalias ist der folgendem Befehl:

keytool -list -v -keystore DEMIS-12345_CSM012345678.p12

Nach Eingabe des Passworts findet sich der Alias ganz oben in den angezeigten Informationen. Dieser muss exakt wie angezeigt in die Konfigurationsdatei übernommen werden (z.B. authcertalias=demis-12345).

Der username in der Konfiguration entspricht dem CN des Zertifikats ohne das vorgestellte "DEMIS-", also z.B. bei individueller DEMIS-Laborkennung bzw. CN=DEMIS-12345 lautet der username "12345". Dies muss so in die json-Konfigurationsdatei eingetragen werden.

3.3.3. Laborkonfiguration Beispiel

Als Beispiel für eine Laborkonfiguration mit dem Dateinamen labor1.json dient die folgende Vorlage:

{
    "identifikator":"123456789",
    "positiveTestergebnisBezeichnungen": ["schwach nachweisbar", "positiv", "POSITIV", "P O S I T I V"],
    "melderPerson":{
        "nachname":"MelderPersonTestNachname",
        "vorname":"MelderPersonTesVorname",
        "anschriftenzeile":"MelderPerson Strasse nr 123 Drittenhinterhof",
        "postleitzahl":"13055",
        "stadt":"Berlin",
        "telefonnummer":"030 1234",
        "erreichbarkeit":"montag-freitag 8:00-16:00"
    }, 
    "melderEinrichtung":{
        "BSNR":"123456789",
        "name":"Labor von Froreich/Schmidt und Partner",
        "einrichtungsArt":"laboratory",
        "ansprechspartnerNachname":"MelderEinrichtung Ansp. Nachname",
        "ansprechspartnerVorname":"MelderEinrichtung Ansp. Vorname",
        "anschriftenzeile":"MelderEinrichtung Strasse nr 123 Drittenhinterhof",
        "postleitzahl":"13055",
        "stadt":"Berlin",
        "telefonnummer":"030 1234",
        "faxnummer":"030 1234",
        "email":"office@meldereinrichtung.de",
        "webseite":"meldereinrichtung.de"
    },
    "idp": {
        "username":"12345",
        "authcertkeystore":"../config/DEMIS-12345_CSM012345678.p12",
        "authcertpassword":"password",
        "authcertalias":"demis-12345"
    }
}