Ressourcenmodell

In Im Folgenden werden grob die einzelnen Ressourcen der Basismeldeinhalte erläutert. Eine gesamtübersicht aller Ressourcen findet sich in diesem Leitfaden unter Ressourcen. Detallierte beschreibungen und Implementerungsanweisungen finden sich in diesem Leitfaden unter Ressourcen → jeweilige Ressource.

Ressource "Notification"

In dieser Ressource wird die Meldung definiert. Die Meldung ist NICHT die konkrete Übermittlung an DEMIS! Sie ist vielmehr ein abstraktes Profil, welches aus mehreren konkreten Meldevorgängen besteht bzw. bestehen kann. Eine Meldung ("Notification") hat einen eindeutigen Identifier ("NotificationID"), der für alle Meldevorgänge ("NotificationBundles") in der Meldung gleich ist. Das bedeutet, dass die "NotificationID" systemweit NICHT eindeutig ist, da mehrere konkrete Meldevorgänge die selbe "NotificationID" tragen können, wenn sie sich auf die selbe Meldung beziehen.

Hat man eine Meldung mit mehren Meldevorgängen, so muss man bei jedem dieser Meldevorgänge die gleiche NotificationID in der Ressource Notification angeben. Aus diesem Grund muss die NotificationID aus dem meldenden System heraus an DEMIS übergeben werden. Dafür sind strenge Bildungsvorschriften notwendig, die in diesem Leitfaden beschrieben sind.

Ressource "NotificationBundle"

Die Meldevorgänge ("NotificationBundles") sind die konkret übermittelten Informationen, die eine Meldung ausmachen. Das gesamte übermittelte Dokument IST der Meldevorgang, er wird in der Ressource "NotificationBundle" lediglich definiert und mit einem Identifier versehen - der "NotificationBundleID". Der Meldevorgang enthält alle notwendigen Ressourcen, wie Notification, Melder, Betroffene Person, fachliche Meldeinhalte aus entspr. Paketen, etc., die einen vollständigen Meldevorgang ausmachen. So betrachtet, ist der Meldevorgang ein zusammengeschnürtes Päckchen an befüllten Ressourcen, daher der englische Begriff "Bundle".

Im Gegensatz zur "NotificationID" ist die "NotificationBundleID" systemweit in DEMIS einzigartig. Daher wird die NotificationBundleID im DEMIS-Backend erstellt und in jeden Meldevorgang geschrieben, der an DEMIS übergeben wird. Somit werden hier alle durch das meldende System übergeben Inhalte überschrieben! Die durch DEMIS festgelegte NotificationBundleID wird in der Quittung ("ReceiptBundle") dem Melder zurückgespiegelt, da er diese kennen muss.

Ressource "ReceiptBundle"

Der Meldevorgang, definiert in der Ressource "NotificationBundle", bildet die Eingabe für die ProcessNotification-Operation, die den gesamten Meldevorgang validiert und verarbeitet. Dies geschieht automatisch im Backend von DEMIS, nachdem ein Meldevorgang abgesetzt wurde. Als Ergebnis liefert DEMIS eine ProcessNotificationResponse und ein Quittungs-Bundle zurück. Ausnahme: Für rki.demis.igs wurde eine separate Operation definiert, die sich zu gegebener Zeit im entspr. Paket finden wird.

Die Ressource "ReceiptBundle" ist somit nicht zum eigentlichen Absetzen der Meldung notwendig, sondern wird vom DEMIS-Backend umgesetzt. Es ist die Antwort vom DEMIS-Backend auf das Absetzen einer Meldung.

image-processnotification

Das Quittungs-Bundle enthält die Meldequittung und die darin referenzierten Ressourcen. Die Meldungsquittung umfasst die Angaben zum von DEMIS ermittelten zuständigen Gesundheitsamt und enthält eine Quittung in Form einer PDF-Datei. Insbesondere die PDF-Datei ist von hohem Interesse für folgende Prozesse, da Sie alle wichtigen Identifier (Also auch "NotificationID" und "NotificationBundleID") und Meldeinhalte menschenlesbar darstellt. Sie enthält auch QR-Codes, die das Verarbeiten und übermitteln der Identifier zu vereinfachen. Daher sollte diese Quittung als PDF-Datei unbedingt nach dem Durchführen eines Meldevorgangs im meldenden System (LIS, LIMS. PVS, KIS, etc.) persisitiert werden und für Nutzenden des System leicht identifizierbar und einsehbar sein.

image-receiptbundle

Die ProcessNotificationResponse liefert das Ergebnis der Validierung des gesendeten Meldevorgangs, also ob er valide ist und erfolgreich übermittelt wurde im besten Falle, oder ob er nicht valide war und abgelehnt wurde, mit der Nennung der entsprechenden Fehler. Es kann auch Warnungen zu bestimmten Inhalten im Meldevorgang geben, die nicht dazu führen dass er abgelehnt wird, die aber dennoch dringend durch den Melder beachtet werden sollten.

Daher sollte das Ergebnis der Validierung im meldenden System (LIS, LIMS. PVS, KIS, etc.) leicht einsehbar sein, da insbesondere bei Warnungen oder bei der Ablehnung einer Meldung Handlungsbedarf durch die meldende Person erforderlich ist.