links til gavn under skrivning:

Teknisk implementeringsvejledning Aftaleoversigt

Aftaler

https://github.com/KvalitetsIT/kih-anvendelse

https://github.com/KvalitetsIT/aftaledeling

NXRG - Design- og arkitekturbeskrivelse

Indledning

Formål

Dokumentdeling gør det muligt for aktører sundhedsvæsnet at dele relevante data om borgere, og dermed skabe et overblik over den enkelte borgers situation for de aktører som har brug for dette. Det kan være dem, som planlægger og gennemfører behandlingsforløb eller for borgerens selv og omsorgspersoner. Samtidig skal det være muligt for borgeren at bestemme, hvem han/hun vil dele disse data med gennem samtykke samt se, hvem der har læst data via MinLog. Infrastrukturen der muliggør deling af dokumenter på tværs af sundhedsaktører er baseret på IHE XDS standarden

Dette dokuments fokus er selve dokumentdelingen; dens dele, dens infrastruktur og hvordan man kommer igang med at anvende den som eksempelvis udvikler, der skal udvikle systemer der skal anvende den.

Der forventes et hvis kendskab til CDA dokumenter - da fokus ikke er disse, ligesom kendskab til anvendelse af DGWS, NSP og SDN  forventes. Hjælpe moduler som MinSpæring, MinLog og andre komponenter, der er i spil i forbindelse med dokumentdeling berøres heller ikke andet overfladisk.

Ordliste

Betegnelse

Beskrivelse

Yderligere dokumentation

AO Aftaleoversigt
CDAClinical Document Architecture R2. Standard for struktur af kliniske dokumenter.http://www.hl7.org/implement/standards/product_brief.cfm?product_id=7
DDSDokumentdelingsservicehttps://www.nspop.dk/display/public/web/DDS+-+Guide+til+anvendere
DROSDokument Registrerings- og Opdateringsservicehttps://www.nspop.dk/display/public/web/DROS+-+Guide+til+anvendere
DRSDokumentregistreringsservice - udfases og erstattes af DROShttps://www.nspop.dk/display/public/web/DRS+-+Guide+til+anvendere
IHEIntegrating the Healthcare Enterprise. Organisation til bl.a. udarbejdelse af standarder til anvendelse i sundhedsit.https://www.ihe.net/about_ihe/
ITI-xxEn række standardservices (SOAP) beskrevet i standarden for XDS
XDSCross Enterprise Document Sharing (XDS) er en række IHE standarder, der specificerer, hvordan dokumenter (f.eks. CDA) deles mellem sundhedsorganisationer.https://wiki.ihe.net/index.php/Cross-Enterprise_Document_Sharing

Hvad er dokumenter

Data i en XDS infrastruktur gemmes som dokumenter. Et dokument har et unikt id (documentId) og en række metadata, der beskriver, hvad dokumentet handler om. Dokumenter kan indholdsmæssigt være af flere forskellige typer: PDF, Word-dokument, men kan også være af typen CDA (Clinical Document Architecture). Et CDA dokument er egentlig bare et struktureret XML dokument, der følger en bestemt standard for kliniske dokumenter til udveksling (deling). Se f.eks. What is HL7 CDA? for en kort beskrivelse. Her kan man bl.a. se, at CDA findes på forskellige niveauer 1-3, hvor 3 har den højeste grad af struktur. En vigtig egenskab ved CDA dokumenter er den fælles CDA header. Denne header indeholder information, der går igen henover alle typer af kliniske dokumenter f.eks. hvilken patient drejer dokumentet sig om, hvilken organisation er ansvarlig (ejer) af dokumentet mm. CDA headeren er således en international standard (HL7), men der findes en dansk specialisering af denne (standardiseret i regi af Medcom). Denne er beskrevet her HL7 Implementation Guide for CDA Release 2.0 CDA Header (DK CDA Header). Medcom vedligeholder en liste over tilladte værdi sæt for metadata, som findes her DK-IHE_Metadata-Common_Code_systems-Value_sets.

Der findes andre profiler, der er specialiseringer af CDA. Dvs. kliniske dokumenter, der har en struktur til bestemte formål. Medcom har leveret danske profileringer af følgende typer (se evt. Medcoms oversigt over HL7 standarder):

Oprindelig var det aftaledokumenter (APD) som blev delt på NSP platformen. Men det har ændret sig, så også de andre dokumenttyper er kommet i spil. Alle dokumenterne på NSP er CDA dokumenter for nuværende. Og de skal alle overholde Medcoms profiler nævnt ovenfor. 

Der er to typer af CDA dokumenter (angives også i metadata feltet type) .

TODO: andre dokumenttyper af ondemand som skal nævnes med navn?

Hvad er dokumentdeling

XDS står for Cross-Enterprise Document Sharing og er en international standard (IHE) for udveksling af kliniske dokumenter. Se f.eks. IHE Cross-Enterprise Document Sharing. En XDS infrastruktur består (mindst) af følgende to komponenter:

Integrationen med XDS infrastrukturen sker vha en række standardiserede SOAP webservices. Et overblik over XDS infrastrukturen og de forskellige services ses nedenfor:

IHE-oversigt.png


TODO: Lav korrekt tegning

Når data skal deles vha XDS sker følgende:

  1. Dokumenter afleveres af dokumentkilden (Document Source) til XDS repository via servicehåndtaget ITI-41 Provide and Register Document Set. Herefter sørger XDS repository for at registrere dokumentet i XDS registry via servicehåndtaget ITI-42 Register Document Set.
  2. Hvis der er tale om et on-demand dokument registreres det af dokumentkilden (On Demand Document Source) direkte i XDS registry via servicehåndtaget ITI-61 Register On Demand Document Entry,  da der ikke et et faktisk CDA dokument at gemme.
  3. Dokumentaftager (Document Consumer) fremsøger dokumenter i XDS registry via servicehåndtaget ITI-18 Registry Stored Query. Svaret på denne query er en liste af documentIds og repositoryIds, der fortæller, hvilke dokumenter der lever op til søgekriterierne, og hvor de findes (repositoryId)
  4. Dokumentaftager (Document Consumer) henter dokument i XDS repository via servicehåndtaget ITI-43 Retrieve Document Set
  5. Dokumentadministrator (Document Administrator) kan opdatere metadata (heriblandt deprecate) i XDS registry via servicehåndtaget ITI-57 Update Document Set.

IHE XDS standarden er specificeret i en række dokumenter som findes her (revision og dato matcher versionen da link indsat):


TODO: inkl læsevejledning til standarden



Arkitekturoversigt af komponenter

<< oversigtstegninger over komponenter og iti interaktioner - tag kopi fra aftaledeling: Aftaler - justser med (+SFSK og -backends)?? >>

<< liste og forklaring af tegning inkl links til anvender guide for de forskellige >>

husk at placere hjælpe moduler og nævne at det får man med 

Hvordan kommer man igang

husk dgws

og adgang til nsp og sdn

andet? hvor meget kan der linkes til?

OpeneHealth biblioteket til Java

eksempler på brug af librariet (hvilke objekter og hvilke id'er skal man tage stillinger)

ise det resulterende "RIM XML" så man forstår sammenhængen.

noget af det kan tages dros anvender guide

evt nævn logiske id'er og hvad der sker hvis man tror man sender et uuuid men ikke gør.

gode steder at kigge: integrationstestene  og anvender guides for komponenterne

Biblioteker til .Net

Hjælpeværktøjer

endpoints link

cda viewer

cda validator

medcoms komme godt igang guide