Indholdsfortegnelse

Introduktion

Formål

Denne guide har som formål at give et overblik over MHDService i GMv2 projektet.

Beskrivelse

MHDService i GMv2 projektet er et første skridt på vejen mod en generel MHD-baseret (se https://profiles.ihe.net/ITI/MHD/index.html) adgang til at hente dokumenter på dokumentdelingsservicen. Denne version implementerer kun de specifikke dele af standarden som projektet har brug for, men med henblik på en senere udvidelse hvor servicen kan anvendes bredere.

MHDService udstiller opslag i registry og repository efter MHD standarden via operationerne ITI-67 (https://profiles.ihe.net/ITI/MHD/ITI-67.html) og ITI-68 (https://profiles.ihe.net/ITI/MHD/ITI-68.html). Disse svarer til hhv. ITI-18 og ITI-43 i tilgangen til DDS, men udstiller et mere REST-agtigt API med FHIR ressourcer. I FHIR termer laver man således i ITI-67 en søgning efter DocumentReference ressourcer. Hver DocumentReference indeholder et link, der er et opslag efter en Binary resource, der indeholder dokumentet.

MHDService giver adgang for borgeren til borgerens egne dokumenter. MHDServicens REST snitflade er sikret ved bearer tokens. Disse veksles til IDWS kald videre på DDS'en.

Links til mere information

MHD standarden: https://profiles.ihe.net/ITI/MHD/index.html

ITI-67: https://profiles.ihe.net/ITI/MHD/ITI-67.html

ITI-68: https://profiles.ihe.net/ITI/MHD/ITI-68.html

MedComs profilering af DocumentReference: https://build.fhir.org/ig/medcomdk/dk-medcom-core-document/StructureDefinition-medcom-documentreference.html

Binary ressourcen: https://hl7.org/fhir/R4/binary.html

Grafisk fremstilling og sammenhængen

Kald-sekvens gennem MHDService, der gennemstiller og transformerer de traditionelle ITI-18 og ITI-43:

Til redigering: https://mermaid.live/edit#pako:eNqFkcFOwzAMhl-l8rmbQrc2WQ6ToDmwwy6UA0K9RI27VTTJyBLEmPbuZCsDaYKRk_37d_zJ3kNjFQKHLb4GNA2KTq6c1LVJ4iv7Do0fzefLe1Ghe-sa5MnicTEq6GD40aNJiGqo3rChGoWL3idRJRq9VNLLX34Y5vFE2CboGD1gi-5I9R8Ou4YznfyFU4rbRNmX06wrOHedkW5Xm8ECKWh0WnYqrm1_1Grwa9RYA4-hwlaG3tdQm0O0yuBttTMNcO8CpuBsWK2Bt7Lfxixs4ibOO_9WN9I8W6vPLTEFvod34FPKxjQr8iwjhBFKWQo74Cwbz0hOyIxNclrMyPSQwsepn4wZzVNA1XnrlsOhT_dOYeWO_F9MaBS60gbjgU-K7PAJ-qelZw

Læsevejledning og forudsætninger

Dette dokument er henvendt til udviklere og arkitekter, der skal anvende MHD Service.

Det forventes at læseren har kendskab til REST services, JWT / bearer token autentifikation og FHIR.

Sikkerhed

Definitioner og referencer

Adgang, brug og snitflader

Adgang

Adgang til servicen sker ved at medsende en Authorization-header med bearer token i form af JTP-H. Et gyldigt JTP-H token til test kan erhverves vha. OATH 2.0 med følgende properties (fra GMv2):  

Endpoints:

Hent dokumentreferencer (ITI-67):

Hent dokument (ITI-68):

Snitfladebeskrivelse og brug

Anvender skal kalde ITI-67 for at få udleveret en aktuel liste af links til dokumenter. Disse links kan umiddelbart derefter bruges i ITI-68 kald for at hente indholdet af dokumenterne. Links til dokumenter bør ikke lagres til senere anvendelse, da status mm. kan skifte på dokumentdelingsservicen, fx deprecating af dokument ved erstatning med en ny version.

MHDService-instansen henter dokumenter for den angivne patient i det dokument repository den enkelte instans er konfigureret op til. Man kan fx kun hente dokumenter fra graviditetsmappens repository med graviditetsmappe-instansen af MHDService.

ITI-67

ITI-67 (registry opslag) udstiller søgning efter dokumenter i graviditetsmappen for en specifik patient baseret på søgeparameteren "patient.identifier". MHD standarden tilbyder en række yderligere søgeparametre, men disse er ikke supporteret endnu.

ITI-67 Request

Request til ITI-67 er et GET eller POST kald til "<MHDService instance base URL>/DocumentReference" med parameteren "patient.identifier" angivet som url-parameter eller i body'en. Parameteren angiver patientens CPR nummer.

ITI-67 Response

Response er et FHIR searchset Bundle med MedComDocumentReference ressourcer for de fundne dokumenter.

ITI-68

ITI-68 (repository opslag) udstiller opslag efter dokumenter i graviditetsmappen. I ITI-67 kaldet er givet et antal MedComDocumentReferences der har en URL til hvert enkelt dokument. På denne URL findes ITI-68 opslaget efter dokumentet.

URL'en for hvert dokument vil være på formen "<MHDService instance base URL>/Binary/<documentId>", og vil returnere objektet i form af en Binary FHIR ressource, med CDA'en som "data".

ITI-68 Request

Request til ITI-68 er et GET kald til "<MHDService instance base URL>/Binary/<documentId>?repositoryID=<repo id>&homeCommunityID=<home community id>", hvor værdien af "documentId" angiver dokumentets "DocumentUniqueId".

Bemærk at DocumentReference-ressourcen fra ITI-67, indeholder linket med alle parametre, så dette link er ikke noget man som anvender skal konstruere selv.

ITI-68 Response

Response er en FHIR Binary ressource hvor dokumentet er base 64 encoded i "data" elementet.

Eksempler på request/response

Eksempler på request og response til de operationer der udstilles. De enkelte elementer er beskrevet under snitfladebeskrivelse. Klient proxier kan genereres udfra WSDL'en.

ITI-67 efterfulgt af ITI-68

Et kald til ITI-67 kunne se ud som

GET <baseurl>/DocumentReference?patient.identifier=<cpr>

og give et Bundle af DocumentReferences med URL'er til at hente de enkelte dokumenter. Herunder er vist et eksempel med et enkelt og dokument. Der er skåret en masse fra for at vise hvordan selve linket er indfanget.

{
	"resourceType": "Bundle",
	"type": "searchset",
	"entry": [
		{
			"resource": {
				"resourceType": "DocumentReference",
				"meta": {
					"profile": [
						"http://medcomfhir.dk/ig/coredocument/StructureDefinition/medcom-documentreference"
					]
				},
                ...
                "content": [
					{
						"attachment": {
							"contentType": "application/fhir+json",
							...
							"url": "<baseurl>/Binary/<documentId>?repositoryID=<repo id>&homeCommunityID=<home community id>",
							...
						},
						...
					}
				],
				...
			}
		}
	]
}

Denne URL bruges derefter i et ITI-68 kald. ála

GET <baseurl>/Binary/<documentId>?repositoryID=<repo id>&homeCommunityID=<home community id>

som vil give dokumentet indpakket i en Binary ressource.

{
  "resourceType": "Binary",
  "contentType": "text/xml",
  "data": "<base64 encodet CDA dokument>"
}

Test

Følgende brugere burde have journal data på både Test 1 og Test 2:

Dokument Historik