DEMIS Wissensdatenbank

Für Fragen und Antworten im Bezug auf die Nutzung des DEMIS Meldeportals finden Sie hier:  FAQ DEMIS-Meldeportal


Frage

Antwort

1

Wie erfolgt eine Bestätigung für die erfolgreiche Meldung an DEMIS?

Derzeit durch Verschieben der Meldung vom input in den done Ordner.
Das Thema rechtssichere Bestätigung ist an die Projektbeteiligten adressiert.

2

Wie kann ein DEMIS Adapter für mehrere Labore (z.B. einer Kette) benutzt werden?

In der Konfiguration des DEMIS Adapters können individuelle Laborkonfigurationen im JSON-Format angegeben werden. Diese Konfigurationsdateien werden in der beiliegenden Datei demis-adapter-api.properties unter dem Parameter labor.configfile als kommaseparierte Aufzählung referenziert (vgl. DEMIS-Adapter (kein Support mehr))

3

Sind weitere Meldungen geplant?

Es ist bereits jetzt absehbar, dass auch weitere Meldungen zukünftig umgesetzt werden. In der ersten Phase geht es jedoch erstmal nur um Positivmeldungen (Covid 19).

4

Welche Fehlercodes gibt es?

401: Fehler im usernamen in der labor.json (s. DEMIS-Adapter Laborkonfiguration)

403 (Forbidden):

  • demis.rki.de kann aufgrund von Proxy/Firewall-Einstellungen nicht erreicht werden. Versuchen Sie testweise von dem PC von dem die Meldungsübermittlung erfolgt, https://demis.rki.de in einem Browser oder per curl im Terminalfenster aufzurufen. Sie sollten zumindest keine Fehlermeldung erhalten. Für die Testumgebung muss man testweise den https://demis-test.rki.de aufrufen. Überprüfen Sie die Proxy-Einstellungen im Adapter: demis-adapter-api.properties (idp.lab.proxy)

  • Fehler im authcertalias in der labor.json. In der Konfigurationsdatei müssen Sie darauf achten, dass Sie Kleinschreibung verwenden (z.B. authcertalias=demis-12345), siehe DEMIS-Adapter Laborkonfiguration.

  • Fehlerhaftes Zertifikat (z.B. falscher Alias)

404: Fehler in URL in demis-adapter-api.properties (fhir.basepath / idp.lab.tokenendpoint)

407: Der konfigurierte Proxy erfordert eine Authentifizierung.

422: Fehler in den Daten, z.B. fehlende Einsender-Telefonnummer oder ungültige Postleitzahl

500: Authentifizierungsfehler (s. Frage 8 ) oder Datenenkodierungsfehler.
Bitte überprüfen Sie dass die LDTv2 Datei sauber ist und keine versteckten Zeichen wie z.B. [m oder ^M enthält, die von Editieren mal in Linux, mal in Windows kommen könnten.

503: Fehler aufgrund von Wartungsarbeiten an DEMIS

5

Warum wird eine Meldung ohne Angabe der Telefonnummer des Einsenders nicht von der DEMIS-Infrastruktur (d.h. der DEMIS Notification API) akzeptiert? Die Anforderungen an die LDTv2-Datenstrukturen (​LDTv2 als Inputformat) weisen diese Angabe nämlich als optional aus.

In den Anforderungen an die LDTv2-Datenstrukturen werden die betreffenden Felder folgendermaßen definiert:

  • "demis_einsender_ansprechpartner" – Ansprechpartner der Einsenderorganisation, falls vorhanden [SOLL]

  • "demis_einsender_telefon" – Telefonnummer der Einsenderorganisation, falls vorhanden [SOLL]

  • "demis_einsender_fax" – Faxnummer der Einsenderorganisation, falls vorhanden [SOLL]

  • "demis_einsender_email" – E-Mail-Adresse der Einsenderorganisation, falls vorhanden [SOLL]

Hier fehlt der Hinweis bzw. die Einschränkung, dass die Nennung mindestens eines Kommunikationsmittels verpflichtend ist. Das heißt, wenn die Telefonnummer nicht zur Verfügung steht, muss eine andere Angabe erfolgen, damit eine Meldung erfolgreich zugestellt werden kann.

6

Warum ist der Demis-Adapter minutenlang still und werden keine LDTv2-Datei verarbeitet

Der Demis-Adapter hat ein 503 HTTP Nachricht an der letzten verarbeitete LDTv2 Datei entweder von Identity Provider oder Notification-API bekommen und wird eine entsprechenden konfigurierte Anzahl Minuten warten und danach wieder aktiv.

7

Was bedeutet die Fehlermeldung ”Exception in thread ‘main’ Malformed \uxxxx encoding.”?

Die Properties Datei beinhaltet einen Fehler im Encoding. Bitte achten Sie darauf, dass die Pfadangaben mit “/” angegeben sind. Pfadangaben mit “\” führen zu diesem Fehler.

8

Was bedeutet die Fehlermeldung “500: Recipient certificate could not be loaded. Target office (Gesundheitsamt) probably not registered yet.” (vorher: “500 : Certificate clould not be loaded.“ beim Senden einer Meldung?

Die Meldung konnte nicht gesendet werden, da das zuständige Gesundheitsamt derzeit noch nicht angebunden ist, also kein gültiges Zertifikat besitzt.
Meldungen können nur gesendet werden, wenn das entsprechende Gesundheitsamt angebunden ist.

9

In manchen Fällen (z.B. Meldungen von mobilen Testzentren, aus Krankenhäusern) existiert keine LANR, die in die LDTv2 Felder 0212 und 8615 gefüllt werden muss?

Die LDT-Spezifikation der KBV sieht als Ersatzwert “999999900” vor!

10

Warum gibt es ein komische betroffene Person Geburts- und Laboreingangsdatum in der Meldung?

Das Datumformat ist: yyyyMMdd.

11

Warum sind die Umlauten nicht korrekt in der Meldung?

Default-Annahme im Adapter ist ISO-8859-15. Details über andere Kodierung sind hier https://confluence-demis.gematik.de/pages/viewpage.action?pageId=76579076#5.-Zeichenkodierung (siehe Zeichenkodierung)

12

Welchen Dateinamen müssen die LDT Dateien im Inputverzeichnis haben?

Die ldt Dateien im Inputverzeichnis müssen *.ldt oder *.LDT heißen und nach dem Starten des Adapters angelegt worden sein.

13

In manchen Fällen existiert keine BSNR (Betriebsstättennummer)?

In diesem Fall kann "999999999" benutzt werden.

14

Ich bekomme den Fehler:
2020-10-19 07:06:32  4729 [pool-2-thread-1] ERROR de.rki.demis.adapter.helper.files.FileHandlerNewLabResult:handleLaborFile:103 - LDT file 'queued_at_2020_1019_070632_20102874.ldt' is wrong and will be moved to '/var/tmp/demis/error'. Error message is: Field 9901 (demis_test_code) value ' 94309-2' is not a valid code from value set 'LaboratoryTestSARSCoV2'.

Mein Jokerfeldes 9901 sieht so aus:
0329901demis_test_code 94309-2

Das Problem ist das Leerzeichen vor der 9:
Falsch:
0329901demis_test_code 94309-2
Richtig:
0329901demis_test_code94309-2

15

Ich bekomme FileNotFoundException, wie unten:

ERROR de.rki.demis.adapter.helper.files.FileHandlerNewLabResult:readLabResultAsLdtFile:56 - Could not parse LDT file.
java.io.FileNotFoundException: LDT-Datei nicht vorhanden

Das Problem könnte an einer 2. laufenden demis-adapter Instanz liegen, in der sich die 2 Instanz die LDT datei holt. Sie benötigen keine 2. Instanz um mehrere Labore zu unterstützen. Man kann mehrere Labore mit einer Instanz handhaben, siehe Konfigurationsparameter labor.configfile in DEMIS-Adapter#3.1.1.-Erläuterungen-zu-den-Konfigurationsparametern

16

Ich bekomme

LDT file 'XX' is wrong: Field 8615 (Auftraggeber) does not correspond with either 0212 (Lebenslange Arztnummer (LANR)) or 0223 (Pseudo-LANR)

obwohl Feld 0212 und Feld 8615 gleich sind.

Das Problem entsteht weil die Werte von Feld 8615 und Feld 0212 nur richtig verarbeitet werden, wenn Feld 0211 (Arzt Name) da ist. Temporäre Lösung ist, das Feld 0211 in der LDT Datei einzufügen. In einer zukünftigen Version wird das behoben.

17

Wie kann man zusätzliche Informationen bzw. Werte, wie z.B. den ct-Wert, an das Gesundheitsamt übermitteln?

Der ct-Wert kann ab Adapter 1.7.0 in den Feldern 8420/8421 übergeben werden. In älteren Versionen kann das LDT-Feld 8470 ("Hinweise zum Test") benutzt werden.

Diese Felder werden auf Observation.note.text gemapt. Dieses kann derzeit jedoch noch nicht automatisiert in SurvNet beim Gesundheitsamt angezeigt werden. Es ist aber für die Gesundheitsämter möglich, in der ursprünglichen Meldung (xml) den entsprechenden Eintrag zu lesen.

18

Wie kann ich im Adapter absolute Pfade unter Windows angeben?

Dazu müssen sie doppelte Backslashes und 2 Verzeichnisebenene benutzen, z.B. C:\\xxx\\yyy.
So geht es NICHT: C:\\xxx

19

Wo finde ich eine Beschreibung des KBV LDT Formates?

Siehe Nr. 9

20

Welche PLZ/Gesundheitsamt kann ich auf demis-test.rki.de benutzen um den Fehler “500: Recipient certificate could not be loaded. Target office (Gesundheitsamt) probably not registered yet.” hervorzurufen?

Das zusätzliche Gesundheitsamt “Testgesundheitsamt 11” wird nicht erreichbar sein. Dieses Gesundheitsamt bezieht sich auf die Postleitzahlen von Bielefeld (Bielefeld Verschwörung). Eine Liste der Postleitzahlen finden Sie hier.

21

Wie kann ein Gesundheitsamt Nachfragen zu Meldungen stellen?

Bitte geben Sie unbedingt melderEinrichtung.telefonnummer in Ihrer Laborkonfiguration an, damit die Gesundheitsämter Sie telefonisch erreichen können, um Nachfragen zu einer Meldung stellen zu können.

22

Welche PLZ setze ich, wenn eine angegebene PLZ nicht valide ist?

Bitte setzen Sie nicht die PLZ “99999”.
Falls die angegebene PLZ nicht valide ist, nutzen Sie bitte eine benachbarte PLZ. Mithilfe des RKI PLZ Tools können Sie auch schauen, ob eine PLZ valide ist.
Beispiel: PLZ “33123” ist invalide, also wird die “33100” genutzt.

23

Beim Starten der CMD verschwindet das Fenster nach wenigen Sekunden?

Dann liegt meist ein Fehler vor, den man nicht sieht weil das Fenster zu schnell verschwindet.

Öffnen Sie die CMD in einem Editor und fügen am Ende eine weitere Zeile mit dem Befehl
pause
ein. Dann wird das Fenster nicht verschwinden und Sie sehen die Fehlermeldung.

24Wie werde ich informiert, wenn sich in der Wissensdatenbank etwas ändert, z.B. ein Wartungsfenster angekündigt wird, das Mapping sich erweitert oder eine neue Adapterversion herausgegeben wird?Es gibt im Internet diverse Services, die Webseiten inhaltlich überwachen und bei Änderungen Notifizierungen verschicken, z.B. versionista.com oder visualping.io. Mit diesen können Sie sich eine Überwachung einrichten.
25Muss ich jedes Adapter Update "mitnehmen" oder ist jedes Update kumulativ und enthält alles was auch die vorherigen Updates enthalten haben? Woher weiß ich, welche Update für mich relevant ist?

Es muss nicht jedes Update "mitgenommen" werden. Updates enthalten immer auch die Funktionalität des/der Vorgänger.

In den DEMIS-Adapter Release Notes sieht man immer was in welcher Version hinzugekommen ist. Außerdem informieren wir auf der Startseite der Wissensdatenbank (https://confluence-demis.gematik.de/display/DSKB) auch immer an welchen Featuren wir gerade arbeiten.

26

Wir verwenden den DEMIS Adapter unter Windows. Gibt es die Möglichkeit den Adapter als Windows Dienst oder ähnliches zu registrieren ?

Der DEMIS Adapter bietet von sich aus keine eigene Möglichkeit sich als Windows Dienst zu registrieren. Es soll aber Tools geben, die Programme wie den Adapter als Windows Dienst laufen lassen können.

Ab DEMIS Adapter 1.7.0 (Version 1.7.0 (29.03.2021)) gibt es zusätzlich die Möglichkeit den Adapter nicht in einer Schleife laufen zu lassen sondern mit -runOnlyOnce nur einmalig bis alle Dateien verarbeitet sind. Damit können Sie den Adapter z.B. stündlich über den Aufgabenplaner von Windows ausführen.

27Die Meldung wird an das falsche Gesundheitsamt geroutet, das Gesundheitsamt des Einsenders und nicht das der betroffenen Person.

Wenn die Adresse der betroffenen Person nicht gefunden werden kann, wird gemäß des Meldungsroutings die Adresse des Einsenders der Probe zur Bestimmung des Gesundheitsamtes benutzt.

Die Adresse der betroffenen Person kann z.B. NICHT bestimmt werden, wenn das Länderkennzeichen falsch ist.
Zulässige Länderkennzeichen

28

Wir möchten unseren Adapter von Version 1.a.b auf Version 1.c.d updaten.

Welche Dateien/Verzeichnisse müssen dazu ausgetauscht werden?

Es muss lediglich das neue Jar File aus dem Update Packet (client/demis-adapter-*.jar) in die bestehende Installation nach client/ kopiert werden und in windows/start.cmd der Name des Jar Files ausgetauscht werden. Anschließend muss der Adapter neu gestartet werden.
29Could not find a Laboratory configuration with identifier: 0000001

In den Feldern 8300/8320 in der JSON/LDTv2-Datei wird das Labor bzw. der Laborname angegben. Für diesen Wert muss es in der labor.json des Adapters einen identifikator geben (siehe 3.3.1. Erläuterungen zu den Konfigurationsparametern).

Die Fehlermeldung bedeutet, dass es in der labor.json keinen identiofikator 0000001 gibt.

30Ich habe eine Frage zu SORMAS.

Zu SORMAS sind wir leider weder technisch noch inhaltlich aussagefähig.

Bitte wenden Sie sich mit Ihrem Anliegen an den SORMAS-Support unter:

https://www.sormas-oegd.de/kontakt/

31

Meine Zertifikatsdatei liegt im falschen Format vor.

Wie kann ich meine Zertifikatsdatei von .pem nach .crt oder .key konvertieren? 

Generell können Zertifikatsdateien u. a. mittels OpenSSL konvertiert werden. 

Eine gute Anleitung mit umfangreichen Anwendungsbeispielen finden sie hier: 

https://newbedev.com/convert-pem-to-crt-and-key

32Ich kann mich nicht auf dem Portal D-TRUST Certificate Service Manager anmelden.

Bitte wenden Sie sich mit Ihrem Problem zunächst an die DEMIS-Geschäftsstelle (demis-support@rki.de). Die Kolleginnen und Kollegen können Auskunft über den von Ihnen verwendeten Benutzernamen geben oder bei der Passwortwiederherstellung unterstützen.

Auch bei anderweitigen Problemen helfen die Kolleginnen und Kollegen bei der Klärung mit D-TRUST bzw. der Bundesdruckerei weiter.

33Bundle does contain a given name with a number

Die Meldepflicht gemäß § 7 IfSG erfordert die Meldung des Einzelfalls, nicht Pseudonyme.

Die Verwendung von Ziffern in den Namen ist daher nicht möglich. Wie weisen darauf hin, dies bei der Erstellung bzw. Formulierung von Pseudonymen zu berücksichtigen.

34Ich habe eine falsch-positiv Meldung eingesendet. Können Sie diese Meldung bitte stornieren?

Zum aktuellen Zeitpunkt können Sie eine elektronische Meldung nicht automatisiert stornieren bzw. zurückziehen.

Sollten Sie über fehlerhafte Personendaten der betroffenen Person aufmerksam gemacht worden sein, so setzen Sie bitte eine neue Meldung mit den korrekten Angaben zur Person an DEMIS ab und informieren Sie das Zielgesundheitsamt (der ersten fehlerhaften Meldung) über die Korrektur. Informationen zum Zielgesundheitsamt finden Sie in Ihrer Meldungsquittung.

Sollten Sie versehentlich eine positive Meldung abgesetzt haben, obwohl ein negatives Testergebnis vorliegt, können Sie die Korrektur derzeit ausschließlich im direkten Kontakt mit dem Gesundheitsamt durchführen.

35

Wird es einen Demis-Adapter (Version 2.x) mit LDT Import geben der die Verpflichtung der Demismeldungen ab 1.1.2022 für alle namentlich meldepflichtigen Untersuchungen abdeckt.

Nein. Der DEMIS Adapter wird nur die Meldung von SARS-CoV-2 unterstützen. Für weitere Erregermeldungen ist die FHIR Schnittstelle mit den Profilen von https://simplifier.net/demis direkt zu benutzen.

36Ich habe ein Frage zum Zertifikatsabruf im "certificate service manager" der Bundesdruckerei/ des D-Trust.

Hier können wir leider nicht unterstützen, da der certificate service manager nicht von der gematik betrieben wird.

Bei diesbezüglichen Anliegen, sprechen Sie gerne die KollegInnen der DEMIS Geschäftsstelle via demis-support@rki.de an.

37Wie können quantitative Angaben in einer Meldung gemacht werden, z.B. der ct Wert?

Zur Angabe von international unit per milliliter wird der UCUM-Code [iU]/mL verwendet.

2 Beispiele
<valueQuantity>
    <value value="2546789"></value>
    <system value="http://unitsofmeasure.org"> </system>
    <code value="[iU]/mL"></code>
</valueQuantity>
 
<valueQuantity>
    <value value="20"></value>
    <system value="http://unitsofmeasure.org"></system>
    <code value="{Ct_value}"></code>
</valueQuantity>
Eine Übersicht weiterer UCUM-Codes: https://ucum.org/trac/raw-attachment/wiki/adoption/common/TableOfExampleUcumCodesForElectronicMessaging.xlsx

Und eine Erklärung von Quantity: http://hl7.org/fhir/datatypes.html#Quantity

38Wie kann ich mit einem Adapter Meldungen eines 2. Labors unterstützen?
  1. Legen Sie sich im config\ Verzeichnis des Adapters eine 2. labor Json Datei, z.B. labor2.json, an und tragen Sie dort die Daten des Labors ein. Tragen Sie unter identifikator einen anderen Identifikator für dieses Labor ein.
  2. Fügen sie labor2.json in client\demis-adapter-api.properties unter labor.configfile= hinzu.
  3. Nutzen sie den in 1. gewählten identifikator in der Meldung um das Labor zu identifizieren. Im LDT ist dies das Feld 8300/8320, im Json melderEinrichtungIdentifier.
39Können Erreger, die nur in einem Bundesland (z.B. Sachsen) meldepflichtig sind, über DEMIS gemeldet werden?DEMIS unterstützt z.Z. die Meldungen von Erregernachweise gemäß § 7 Abs. 1 IfSG (https://www.gesetze-im-internet.de/ifsg/ ) Meldepflichten gemäß landesspezifischen  Verordnungen (wie z.B. in Sachsen) sind seit Sommer 2023 über die Schnittstelle möglich
40Antibiotika-Verbrauchs-Surveillance (AVS) und Antibiotika-Resistenz-Surveillance (ARS) - G-BA-Beschluss bzw. Umsetzung der Surveillancesysteme in DEMIS 

Der Gemeinsame Bundesausschuss (G-BA) hat für Antibiotika, die gemäß §35 SGB V als Reserveantibiotika eingestuft wurden und deren Zusatznutzen damit als belegt gilt, Qualitätsvorgaben bei der Anwendung in Behandlungseinrichtungen beschlossen. 

Demnach sollen Behandlungseinrichtungen, die Reserveantibiotika gemäß §35 SGB V einsetzen, an den übergeordneten Surveillance-Systemen AVS (Antibiotika-Verbrauchs-Surveillance) und ARS (Antibiotika-Resistenz-Surveillance) bzw. ARVIA (Antibiotika-Resistenz und -Verbrauch Integrierte Analyse) teilnehmen. Gemäß G-BA Beschluss ist die Übermittlung der Resistenz- und Verbrauchsdaten zu Reserveantibiotika an die genannten Systeme bis spätestens 01.01.2024 zu gewährleisten.

Ein Überblick zu den etablierten Übermittlungswegen für Daten von ARS und AVS wurde auf den RKI-Seiten https://ars.rki.de/ und https://avs.rki.de/  veröffentlicht. Die aktuell genutzte Schemadefinition für die Übermittlung der ARS-Daten ist seit 2008 für Softwarehersteller frei verfügbar. Für AVS besteht seit 2014 die Möglichkeit der Datenübermittlung über die Plattform WebKess des Nationalen Referenzzentrums für Surveillance von nosokomialen Infektionen sowie seit 2021 eine Schemadefinition, die an geeigneter Krankenhaussoftware implementiert werden kann.

Darüber hinaus wird eine Datenübermittlung über DEMIS unter Nutzung der FHIR-Schnittstelle erarbeitet. Angestrebt wird eine Bereitstellung der ARS-Schnittstelle in 2024.