Dokumentenabfrage und -zugriff

Dokumentenabfrage

Dokumente können anhand ihrer Metadaten gesucht werden. Im Rahmen der ISiK-Spezifikation müssen mindestens die im Kapitel Interaktionen mit MUSS gekennzeichneten Suchparameter unterstützt werden. Einzelnen Systemen steht es frei, darüber hinaus weitere FHIR-konforme Suchparameter zu implementieren.

Es gelten die allgemeinen Festlegungen zu Suchparametern gemäß ISiK Basisprofil Stufe 2

Die Ergebnisse einer Suchanfrage werden in Form eines Bundles zurückgegeben:

identifierΣ0..1Identifier
typeΣ1..1codeBindingFixed Value
timestampΣ0..1instant
totalΣ I1..1unsignedInt
relationΣ1..1string
urlΣ1..1uri
fullUrlΣ1..1uri
resourceΣ0..1Resource
modeΣ0..1codeBinding
scoreΣ0..1decimal
methodΣ1..1codeBinding
urlΣ1..1uri
ifNoneMatchΣ0..1string
ifModifiedSinceΣ0..1instant
ifMatchΣ0..1string
ifNoneExistΣ0..1string
statusΣ1..1string
locationΣ0..1uri
etagΣ0..1string
lastModifiedΣ0..1instant
outcomeΣ0..1Resource
fullUrlΣ0..1uri
resourceΣ I1..1Erforderliche Metadaten für Dokumentenaustausch in ISiK
modeΣ0..1codeBinding
scoreΣ0..1decimal
methodΣ1..1codeBinding
urlΣ1..1uri
ifNoneMatchΣ0..1string
ifModifiedSinceΣ0..1instant
ifMatchΣ0..1string
ifNoneExistΣ0..1string
statusΣ1..1string
locationΣ0..1uri
etagΣ0..1string
lastModifiedΣ0..1instant
outcomeΣ0..1Resource
signatureΣ0..1Signature

Suchergebnisse können zahlreich sein. Server MÜSSEN daher FHIR-konformes Paging unterstützen. Server KÖNNEN im SearchSet-Bundle auch Ressourcen vom Typ OperationOutcome mit Informationen über die Suchergebnisse zurückgeben. Diese müssen in Bundle.entry.search.mode mit dem Wert outcome gekennzeichnet sein. Die Issues im OperationOutcome dürfen nur dem Schweregrad information oder warning entsprechen. Issues vom Schweregrad error oder fatal sind unzulässig.

Beispiele:

  • Suche anhand von Patientenkontext (PID) und Dokumentendatum: [base]/DocumentReference?patient.identifier=1234&creation=gt2021-10-06
  • Suche nach vorläufigen Endoskopiebefunden (anhand KDL-Dokumenttyp und docStatus): [base]/DocumentReference?type=http://dvmd.de/fhir/CodeSystem/kdl|DG02010&doc-status=preliminary
  • Suche von Dokumenten anhand der Nummer des Abrechnungsfalles: [base]/DocumentReference?encounter.account:identifier=56789

Dokumentenzugriff

Das den Metadaten zugeordnete Dokument kann jeweils unter DocumentReference.content.attachment.url vom Server abgerufen werden. Es gelten die Festlegungen gem. IHE ITI-68: Retrieve Document

Der einzige MIME-Type, den alle Dokumentenserver verpflichtend zurückgeben können MÜSSEN ist der MIME Type, der dem DocumentReference.content.attachment.contentType entspricht.

Dokumentenserver SOLLEN das Dokument präferiert über einen Binary-Endpunkt bereitstellen. Dieser verfügt über folgende Besonderheit:

  • Wenn der Zugriff mit dem Accept-Header application/fhir+xml oder application/fhir+json erfolgt, müssen die Daten als Binary-Ressource im angeforderten Format zurückgegeben werden.
  • Wenn der Zugriff mit einem anderen Accept-Header als application/fhir+xml oder application/fhir+json erfolgt, so soll das Dokument im angeforderten Format zurückgegeben werden, z.B. MUSS bei Zugriffen mit Accept-Header application/pdf das Dokument unmittelbar als PDF zurückgegeben werden, sofern dies dem Content-Type der Binary-Ressource entspricht.