Page History
...
Denne guide har som formål at give et overblik over MHDService i GMv2 projektet.
Beskrivelse
MHDService er udviklet i regi af GMv2 projektet er et første skridt på vejen mod en generel MHD-baseret (se og udstiller en general MHD-basere t(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 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.
...
| url | https://test.cloud.idm.trifork.com/auth/realms/gravid/protocol/openid-connect/auth |
| access token url | https://test.cloud.idm.trifork.com/auth/realms/gravid/protocol/openid-connect/token |
| client id | gravidapp |
| redirect url | gravidapp |
| scope | openid profile |
...
Endpoint eksempler:
Capability statement :
| Endpoint | <serverurl>/mhd/api/2025/11/27/meta |
| Beskrivelse af services | Returnerer en capability statement der beskriver service samt søge parametre. |
| Resultat | Capability statement (https://build.fhir.org/capabilitystatement.html) |
Hent dokumentreferencer (ITI-67):
| Endpoint | <serverurl>/mhd/api/2025/0511/0627/DocumentReference?patient.identifier=2311890002&status=current |
| Beskrivelse af services | Returnerer dokument referencer for borgeren. Bemærk, der returneres kun de dokumenttyper som er MHD'en er konfigureret til at returnere. |
| Resultat | Bundle med DocumenReference resourcer |
...
| Endpoint | <serverurl>/mhd/api/2025/0511/0627/Binary/1.2.208.193%5E12345f0f-648f-4760-841a-05e96e3c3990?repositoryID=1.2.208.176.43210.8.10.15&homeCommunityID=1.2.208.176.43210.8.10 |
| Beskrivelse af services | Returnerer binaries indeholdende dokumenter fra DDS. Bemærk, ovenstående url findes i svaret fra hent dokumentreferencer og det er derfor ikke meningen at man selv skal konstruere den. |
| Resultat | Binary med dokument fra DDS |
...
ITI-67 (registry opslag) udstiller søgning efter dokumenter i graviditetsmappen for en specifik patient baseret på søgeparameteren følgende søgninger efter dokumenter:
GET: <MHDService instance base URL>/DocumentReferencePOST: <MHDService instance base URL>/DocumentReference/_search
POST-kaldet understøtte både at parameter kaldes med query- og form- parametre. For yderligere detaljer se https://hl7.org/fhir/R4/http.html#.
I graviditetsmappen fremsøges dokumenter for en specifik patient ved at angivelse af parametrene "patient.identifier" og status. Da nuværende instans af MHD er konfigureret til at kun returnere dokumenter tillgørende gravidmappen, vil kun disse blive returneret. MHD standarden tilbyder en række yderligere søgeparametre , men disse er ikke supporteret endnusom er specificeret i følgende Capability statement:
https://mhd.gravidmappen.test.tcs.trifork.cloud/mhd/api/2025/11/27/metadata
I de følgende afsnit beskrives kort de minimal kald som GMv2 projektet bruger.
ITI-67 Request
Request til ITI-67 er et GET eller POST kald til "<MHDService instance base URL>/DocumentReference" eller POST med parameteren "patient.identifier" angivet som url-parameter eller i body'en. Parameteren angiver patientens CPR nummer.
...
| ITI-67 parametre | ||
|---|---|---|
| Parameter | Beskrivelse | Påkrævet |
| patient.identifier | Patientens CPR nummer | Ja |
| status | Status på dokumentet | ja |
For yderligere parametre se https://mhd.gravidmappen.test.tcs.trifork.cloud/mhd/api/2025/11/27/metadata
ITI-67 Response
Response er et FHIR searchset Bundle med MedComDocumentReference ressourcer for de fundne dokumenter.
Bemærk! I MedComs profil er der kun understøttelse for 1 author med en organisation og en optinel person. I ITI-18 kan der være flere authors, hver med en organisation og en person. I den generelle document reference profil https://hl7.org/fhir/R4/documentreference.html er der understøttelse for 0 til mange authors, desværre er en author her. enten en organisation, person, osv. Det vil sige at vi kan ikke mappe en person og bevare tilknytning til organisation som beskrevet i ITI-18. Derfor er det besluttet at vi blot mapper en organisation med person i henhold til den nuværende MedCom document reference.
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.
...
GET <baseurl>/DocumentReference?patient.identifier=<cpr>&status=current
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.
...