Svareksponeringsservice-laboratoriesvar via dokumentdeling
Guide til Anvendere

Anchor
_Toc462245147 _Toc462245147

Introduktion

Anchor
_Toc316542421 _Toc316542421

Anchor
_Ref317083052 _Ref317083052

Anchor
_Toc327542697 _Toc327542697

Anchor
_Toc462245148 _Toc462245148

Formål

Anchor
_Toc327542699 _Toc327542699

Anchor
_Toc462245149 _Toc462245149

Læsevejledning

Nærværende dokument henvender sig til udviklere og arkitekter, der skal anvende patienters laboratoriesvar via den nationale infrastruktur til deling af dokumenter - dokumentdelingsservices.
Anvendelse er kun skitseret overordnet og suppleret med reference til mere detaljeret dokumentation.

Anchor
_Toc317831244 _Toc317831244

Anchor
_Toc317839917 _Toc317839917

Anchor
_Toc327542700 _Toc327542700

Anchor
_Toc462245150 _Toc462245150

Dokumenthistorik

Anchor
_Toc327542701 _Toc327542701

Anchor
_Toc462245151 _Toc462245151

Definitioner og referencer

Anchor
_Toc462245152 _Toc462245152

Overblik over adgang til laboratoriesvar

Laboratoriesvar fremsøges via den nationale infrastruktur til deling af dokumenter inden for sundhedsområdet. Et laboratoriesvar er fastholdt i et laboratoriesvarsdokument, som er et struktureret dokument. Dokumenterne stilles til rådighed af Laboratoriedatabanken.

Anchor
_Toc462245153 _Toc462245153

Overblik over tilgængelig dokumentation

Der findes en overordnet anvenderguide \[Anvenderguide\] for brug af den nationale infrastruktur til dokumentdeling – Dokumentdelingsservices. Nærværende guide er et supplement til denne, som specifikt uddyber de skridt, som er specifikke for adgang til laboratoriesvarsdokumenter.
Ved brug af DDS trækker man på en række nationale services, som hver især har deres egen anvender-guide \[Opslag anvender, Indhentning anvender\] og snitfladebeskrivelse \[Opslag snitflade, Indhentning snitflade\].
Endeligt findes der en snitfladebeskrivelse \[Svareksponeringsservice snitflade\], som beskriver dels metadata til fremsøgning af laboratoriesvarsdokumenter via dokumentdelingsservice, dels formatet for laboratoriesvarsdokumenter.

Anchor
_Toc462245154 _Toc462245154

Overblik over infrastrukturen

Infrastrukturen er illustreret på Figur 1 sammen med det overordnede flow ved fremsøgning og indhentning af laboratoriesvarsdokumenter om en borger.




!worddav85f30b2afa0a5d7eec8f3d8c2b09d761.png|height=73,width=71!Dokument-
delings-
serviceDokument-
anvender1.2.3. !worddava47b7064589254200dc63ab65ddc997f.png|height=118,width=83!Laboratorie-
databanken Laboratorie
svars
dokumentLabsvarLabsvarLabsvarLaboratorie
svars
dokumentLabsvarLabsvarLabsvarLabsvar*Labsvar*4.5..
Figur 1 – det overordnede flow for fremsøgning og indhentning af laboratoriesvarsdokumenter

Anchor
_Toc462245155 _Toc462245155

Overordnet flow for fremsøgning af laboratoriesvarsdokumenter

Forud for anvendelse af infrastrukturen til fremsøgning, skal anvenderen tilsluttes som anvender af dokumentdelingsservices.

1. Tilslutning til infrastrukturen

Skridtene i forbindelse med fremsøgning er følgende:

1. Slå laboratoriesvarsdokumenter op via Dokumentdelingsservice Opslag
2. Afgør hvilke laboratoriesvarsdokumenter, der ønskes indhentet
3. Indhent ønskede laboratoriesvarsdokumenter via Dokumentdelingsservice Indhentning
4. Fortolk dokumenterne og udtræk indeholdte laboratoriesvar
5. Filtrer laboratoriesvar

Anchor
_Toc462245156 _Toc462245156

De enkelte skridt i detaljer

De følgende afsnit beskriver de enkelte skridt i flowet.

Anchor
_Toc462245157 _Toc462245157

Tilslutning til infrastrukturen

Dokumentdeling vil foregå i et produktionsmiljø, hvor aktører er tilsluttet Sundhedsdatanettet (SDN) og hvor bl.a. Dokumentdelingsservices afvikles på den Nationale Serviceplatform (NSP). For at blive koblet på skal der indgås en tilslutningsaftale, hvori vilkår og ansvar afstemmes.
Dette er beskrevet i \[Anvenderguide\].

Anchor
_Toc462245158 _Toc462245158

Slå laboratoriesvarsdokumenter op via Dokumentdelingsservice Opslag

Dokumentdelingsservices udstiller en operation til opslag i infrastrukturens indeks via en webservice-snitflade. Opslagsoperationen er i IHE XDS-termer FindDocument-forespørgslen i IHE Technical Framework's transaktion 18, Registry Stored Query.  Denne er beskrevet i \[Opslag snitflade\].
Opslag foretages under anvendelse af standarden IHE Cross-Enterprise Document Sharing (XDS), hvor søgeparametrene er som beskrevet i \[Svareksponeringsservice snitflade\].
Webservicen er baseret på Den Gode Web Service og forudsætter et STS signeret idkort på niveau 4. Dette er beskrevet i \[Anvenderguide\] og \[Opslag anvender\].

Anchor
_Toc462245159 _Toc462245159

Afgør hvilke laboratoriesvarsdokumenter, der ønskes indhentet

Anvendere skal fortolke svaret fra opslaget, som overholder formatet beskrevet i \[Svareksponeringsservice snitflade, Opslag snitflade\], og udvælge, hvilke laboratoriesvarsdokumenter, der ønskes indhentet. De ønskede laboratoriesvarsdokumenter kan være samtlige eller en filtreret liste af de dokumenter, der er returneret metadata for i svaret fra opslaget.

Anchor
_Toc462245160 _Toc462245160

Indhent ønskede laboratoriesvarsdokumenter via Dokumentdelings-service Indhentning

På baggrund af metadata for de ønskede laboratoriesvarsdokumenter, skal anvender foretage indhentning ved anvendelse af Dokumentdelingsservicens web-serviceoperation til indhentning af dokumenter, beskrevet i \[Indhentning snitflade\].
Indhentning af dokumenter er i IHE XDS-termer RetrieveDocumentSet-forespørgslen i IHE Technical Framework's transaktion 43, Retrieve Document Set.  
Dokumentdelingsservicens webservice er baseret på Den Gode Web Service og forudsætter et STS signeret idkort på niveau 4, som beskrevet i \[Anvenderguide\] og \[Indhentning anvender\].

Anchor
_Toc462245161 _Toc462245161

Fortolk dokumenterne og find laboratoriesvar

Hvert af de fremsøgte laboratoriesvarsdokumenter indeholder nul, et eller flere laboratoriesvar, som beskrevet i \[Svareksponeringsservice snitflade\]. Dokumenterne parses og de enkelte laboratoriesvar samles til en samlet liste af laboratoriesvar over tid, på tværs af kilder.

Anchor
_Toc462245162 _Toc462245162

Filtrer laboratoriesvar

Da laboratoriesvarsdokumenter ikke nødvendigvis kun indeholder laboratoriesvar svarende til søgeperioden, skal hvert laboratoriesvar i den samlede liste gennemgås. De laboratoriesvar, der ikke ligger inden for søgeperioden kan frafiltreres.