Implementation Guide
ePA MHD Service
Version 1.0.0 - release

Retrieve Document

Seiteninhalt:

Die Retrieve-Document-Transaktion des MHD Service basiert auf der IHE-Transaktion [ITI-68] der MHD-Spezifikation. Sie wird vom ePA-Client-System verwendet, um ein Dokument abzurufen. Das Dokument kann dabei vorher über eine MHD Metadatensuche oder Volltextsuche gefunden werden oder anderweitig (z. B. aus dem XDS Document Service) bekannt sein.

Einsatzbereich

Die Transaktion Retrieve Document [ITI-68] wird verwendet, um ein Dokument vom MHD Service abzurufen.

Nachricht

Document ConsumerDocument ResponderRetrieve Document
Abbildung: Retrieve-Document-Interaktion


Diese Nachricht ist eine HTTP GET-Request-Nachricht zum Abrufen des Dokuments der Form:

GET [base]/epa/mhd/retrieve/v1/content/<DocumentReference.masterIdentifier>.<file_extension>

Auslösung

Das ePA-Client-System möchte ein Dokument herunterladen.

API

Das ePA-Client-System sendet eine HTTP GET-Request-Nachricht zum MHD Service.

Das ePA-Client-System SOLL eine HTTP GET-Request-Nachricht nutzen, um Dokumente über DocumentReference-Instanzen des FHIR-Elements DocumentReference.content.attachment.url abzurufen. Der MHD Service MUSS ausschließlich einen MIME-Type zurückgeben, welcher im Element DocumentReference.content.attachment.contentType angegeben und damit konform zum IHE XDS Mapping ist. Das ePA-Client-System DARF den HTTP If-Unmodified-Since Header NICHT im HTTP GET-Request inkludieren.

Verarbeitung

Die HTTP-Antwortnachricht wird nach Bearbeitung des Retrieve Document Request gesendet.

Der MHD Service MUSS das Dokument im angeforderten MIME-Type bereitstellen oder mit einem HTTP Status Code antworten, der den Fehlerzustand angibt. Der MHD Service DARF das angeforderte Dokument NICHT transformieren. Der MHD Service MUSS eine HTTP Response-Nachricht nach [RFC2616] erzeugen. Wenn das angeforderte Dokument zurückgegeben wird, MUSS der MHD Service mit dem HTTP Status Code 200 antworten. Der HTTP Body MUSS den Inhalt des angeforderten Dokuments beinhalten. Das MHD Service MUSS die nachstehende API unterstützen.

Sicherheitsanforderungen

Generelle Sicherheitsanforderungen werden hier festgehalten.

Protokollierung

Die Protokollierung erfolgt über den Audit Event Service. Weitere Anforderungen sind [gemSpec_Aktensystem_ePAfueralle#Protokollierung] zu entnehmen.