Indholdsfortegnelse
Se eksempel på udfyldelse på DDS: DDS - Guide til anvendere - NSP services - Global Site
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
<Relevante links til andre dokumenter, herunder i forhold til de data services skal arbejde på, og den model de følger>
<Eventuel link til mere uddybende beskrivelse, intern på NSP og eksternt>
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:
Relevante use-cases
<Angiv use cases såfremt det er relevant>
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 <f.eks.: SOAP WebService, Den Gode WebService (DGWS) og Sercurity Token Service (STS), o.a.>
<Eventuel andre forudsætninger>
Sikkerhed
<Forudsætninger for anvendelse og krævede adgange, whitelistinger etc., Sikkerhedsniveau. Angiv krav til authentication for at kunne bruge servicen/komponenten.>
| Service udstil type | REST service med JWT bearer token autentifikation. |
| Krævede adgange | JWT token identificerer borgeren, der har adgang til egne dokumenter. |
| Whitelisting | <Angiv eventuel nødvendig whitelisting> |
| Krævet sikkerhedsniveau | <Angiv krav til authentication for at kunne bruge servicen/komponenten> |
| Forudsætninger for anvendelse | <Angiv forudsæntninger som er nødvendige for at kunne bruge servicen/komponenten, eventuelle nødvendige kald til andre services, etc.> |
| Logning | <Angiv om og hvad der logges> |
| <evt. yderligere krav eller forhold> |
<Eventuel nærmere introduktion>
<Eventuel yderligere beskrivelse af området / domænet som servicen/komponenten servicerer>.
<Samt yderligere information som er vigtigt for anvendelsen eller forståelsen>
Definitioner og referencer
| Reference | Beskrivelse |
|---|---|
Adgang, brug og snitflader
Adgang
<Beskrivelse af hvordan service/komponent bruges, snitflade(r), endpoints, og andet relevant>
| Tilgængelig | <Angiv på hvilke(n) NSP-installation(er) servicen/komponenten er tilgængelig> |
| Endpoint(s) | <Angiv udstillede endpoint(s), og hvad de hedder.> |
| WSDL | <Angiv henvisning til WSDL(er). For ekstern anvendbare services typisk på https://wsdl.nspop.dk/> |
| Beskrivelse af services | <Beskrivelser af service(s) / actions på endpoint(s). I lægmands termer beskrive hvad man kan forvente af de enkelte services.> |
| Namespaces etc | <Angiv eventuelt Namespaces, eksterne typer, ..> |
Snitfladebeskrivelse og brug
<Beskrivelse af Snitfladerne, samt den logik og de regler, der skal følges for den måde servicen anvendes på, og som servicen selv efterlever.>
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.
<snitflade 1>Request
<beskrivelse af request>
<Marker hvilke der er obligatoriske. Gerne en beskrivende tekst på samtlige parametre, og gerne også et eksempel på hvilke data der kan sættes ind her. Selv hvis man forstår beskrivelsen, så er det stadig godt at have et eksempel. Angiv hvis der er undtagelser eller specielle hensyn>
| <navn> | ||
|---|---|---|
| Element | Beskrivelse | Påkrævet |
<snitflade 1>Response
<beskrivelse af svar>
| <navn> | ||
|---|---|---|
| Element | Beskrivelse | Påkrævet |
<snitflade 2, osv., med request/response>
Generelle koder, værdier, etc.
<Angiv eventuelle generelle koder, værdier, etc>
Fejlbeskeder
<Beskrivelse af fejlbeskeder, og i hvilke situationer man kan forvente at se disse i.
Noter omkring ting som går på tværs af services. Det kan være fejl som optræder generelt og som man skal være opmærksom på.>
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.
<eksempel 1 på ..>
<mere eksempel>
Test
<beskriv Test muligheder, test-systemer og eventuelle testdata>
Eksempel kode og klient
Eksempel kode
<Eksempel kode. Det er meget lettere at lave sin egen implementering, hvis man kan kigge efter en anden ....>
Eksempel klient
<og hvor det giver mening angiv eventuel eksempel klient, samt hvordan og hvor det eventuelt kan eksekveres>
Dokument Historik
| 3/4 2025 | Martin Henriksen/SDS | Etablering af dokumentation |