Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.
  6. (Patient Identify Source som fremgår af figuren anvendes ikke på NSP)


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

IdBeskrivelseLink
ITI TF-1

Alle IHE profilerne beskrives.

Afsnit

For NSP dokumentdeling er relevant afsnit

  • "10. Cross-Enterprise Document Sharing (XDS.b)"
er det relevant afsnit for NSP dokumentdeling.

Man vil også kunne finde brugbar information i flere af appendixerne.

IHE IT Infrastructure Technical Framework Volume 1 (ITI TF-1) Integration Profiles (Revision 17.0 – Final Text)
ITI TF-2

Hvert ITI håndtag beskrives med definition, information som overføres og begrænsninger

Hvilket afsnit, som er relevant afhænger af hvilke ITI håndtag man skal

implmentere

implementere.

Skal man lave fremsøgning (ITI-18) vælges afsnit "3.18 Registry Stored Query [ITI-18]"

IHE IT Infrastructure (ITI) Technical Framework, Volume 2 Revision 18.0, July 30, 2021 – Final Text
ITI TF-3

Her beskrives metadata ved dokumentdeling. 

For NSP dokumentdeling

, vil

er relevant afsnit

  • "4 Metadata used in Document Sharing profiles"
være relevant
IHE IT Infrastructure (ITI) Technical Framework, Volume 3 Revision 18.0, July 30, 2021 – Final Text
ITI TF-Metadata

Her beskrives Opdatering af metadata, som endnu ikke er med i den udgivne specifikation.

Dokumentet indeholde de dele, som med tiden skal flettes ind i 1-3 ovenfor. 

Hvis man skal

lave

implementere opdatering af metadata (ITI-57) kan følgende afsnit være relevante:

  • 10 Cross-Enterprise Document Sharing (XDS.b)
  • 3.57 Update Document Set [ITI-57]
  • 4.1 Abstract Metadata Model
  • 4.3 Additional Document Sharing Requirements
IHE IT Infrastructure Technical Framework Supplement 10 XDS Metadata Update 15 Rev. 1.12 – Trial Implementation July 2, 2021

TODO: mere læsevejledning til standarden?


Arkitekturoversigt af komponenter

På NSP består dokumentdelings infrastrukturen af følgende komponenter.

<< oversigtstegninger over komponenter og iti interaktioner - tag kopi fra aftaledeling: Aftaler - justser med (+SFSK og -backends)?? >> I den tegning for dokumentdeling er det DDS Repo+Registry+DRS+DROS+SFSK, der er relevante (diverse backends skal ikke dokumenteres her). Skrive "udløbsdato" for DRS.

<< 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 

nævne flere miljøer med denne konfig, og ref'e til test link nedenfor

Minlog, behandlingsrelationer, minSamtykke (filter) og værdispring


Hvordan kommer man igang

husk dgws

og adgang til nsp og sdn

andet? hvor meget kan der linkes til?

...

Komponenterne i dokumentdelings infrastrukuren kommunikerer med ITI kald, som er standardiserede SOAP services, der skal overholde IHE XDS specifikationen. 

Det er op til anvenderen/udvikleren selv at vælge platform og frameworks, der passer til resten af dennes løsning. Fra et udvikler perspektiv kan man enten vælge selv at generere stubkode udfra de standardiserede WSDL filer eller at anvende et tredjepartsprodukt.  Nedenfor gives et forslag til, hvordan det kan gribes an med tredjepartsproduktet IPF Open eHealth Integration Platform, som forudsætter man arbejder på en java platform. Andre platforme kan have tilsvarende værktøjer og muligheder.

Da dokumentdelingen kører på NSP og sundhedsdatanettet (SDN) skal man anvende Den gode Web Service og have adgang til SDN for den del af miljøerne. Dette beskrives ikke yderligere her.

OpeneHealth biblioteket til Java

Man behøver ikke at basere alting på Camel, men kan med fordel nøjes med at inkludere biblioteket IPF Commons IHE XDS i sin kodebase. Her findes både stubbe og en masse anvendelige utilities.

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

...

gode steder at kigge: integrationstestene  og anvender guides for komponenterne

Biblioteker til .Net

...

endpoints link

andre nsp sider

cda viewer

cda validator

...

De følgende links kan alle bidrage til at lette arbejdet med at implementere dokumentdeling,

VærktøjBeskrivelseLink



DDS

Guide til anvendere
Når man skal læse noget:

  • fremsøge dokumenter
  • hente dokumenter
https://www.nspop.dk/display/public/web/DDS+-+Guide+til+anvendere
DROS

Guide til anvendere

Når man skal skrive noget:

  • oprette et stable dokument
  • rette et stable dokument
  • registrere et stable dokument (hvis man selv ejer det tilhørende repository)
  • registrere et on-demand dokument
  • rette et dokuments metadata
https://www.nspop.dk/display/public/web/DROS+-+Guide+til+anvendere



AftaleoversigtSiden beskriver de tekniske forretningsregler i forhold til at implementere Aftaleoversigten i et lokal fagsystem eller en borgerportal.Aftaleoversigt
AftalerBeskriver servicearkitekturen, der ligger bag deling af aftaler via NSPhttps://www.nspop.dk/display/public/web/Aftaler



Medcom CDA Viewer

Her kan man fremsøge, hente, oprette, rette og deprecate dokumenter på test1 og test2

Hvis man f.eks har lavet et ITI-41 kald til en service, og vil se at dokumentet blev registreret og gemt kan man fremsøge og hente det her.

Skal man lave en ITI-18 fremsøgning kan man oprette dokumenter her først.

Det er også muligt at downloade request og response (RIM format) ved de forskellige udførsler. Det kan anvendes til sammenligning med et ITI kald man sidder og udvikler på og som f.eks. driller.

Adgang kræver login, kontakt Medcom

https://cdaviewer.medcom.dk/cdaviewer/
Medcom CDA Validator

Her findes en CDA validator der kan checke om et CDA dokument opfylder den danske profil.
Man kan vælge en given profil af de ovenfor angivne og få at vide, om ens dokument indeholder fejl.

https://cda.medcom.dk/
Medcom CDA builder/parserBibliotek der kan benyttes til at serialisere og deserialisere CDA dokumenter standardiseret af MedCom.https://bitbucket.org/4s/4s-cda-builder/src/master/4s-cda-builders/
MedCom igang guide

Medcoms "kom godt igang med dokumentdeling"

Beskrivelsen er mere bred end, den i dette her dokument og går også mere i detaljer på udvalgte punkter. 

https://www.medcom.dk/media/10982/kom-godt-igang-med-dokumentdeling-14-interactive.pdf