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 - ITI kald. Et overblik over en standard XDS infrastruktur og de forskellige services ses nedenfor:

IHE-oversigt.png


Når data skal deles vha XDS er der følgende overordnede flows:

...

Gliffy Diagram
size600
displayNamearkitektur
namearkitektur
pagePin915

  • DROS (anvenderguide) anvendes til skrive aktiviteterne:
    • Oprettelse af nye dokumenter (ITI-41 Provide and Register Document Set) sker fra anvendersystemerne. DROS lagrer det oprettede dokument i det bagvedliggende nationale XDS Repository. I forbindelse med oprettelsen sørger det nationale XDS Repository for at få indexeret dokumentet og dets metadata i det nationale XDS Registry (ITI-42 Register Document Set). Tidligere har også DRS været anvendt til dette formål, men den udgår.
    • Oprettelse af et dokument, som en opdatering til et eksisterende dokument (ITI-41 Provide and Register Document Set). Her ugyldiggøres det eksisterende/gamle dokument.
    • Ugyldiggøre (deprecate)  et dokument eller opdatering af et dokument (ITI-57: Update Document Set)
    • Registrering af On-Demand dokumenter (ITI-61 Register On-Demand Document Entry)
    • Registrering af Stable dokumenter (ITI-42 Register Document Set). Dette anvendes, hvis man selv ejer et repository, men anvender det nationale registry til indeksering. Et eksempel på dette er KIH databasen, som indeholder hjemmemålinger (PHMR) og spørgeskemaer (QRD) .
  • DokumentDelingsServicen (DDS registry) (anvenderguide) anvendes til fremsøgning af dokumenter (ITI-18 Registry Stored Query)  hvor der blandt andet kigges i
    • det Nationale XDS Registry
    • aftale adaptorer til region Nord og Region Midt. Disse delegere søgninger videre til de to Bookplan instanser i Region Nord hhv. Region Midt
    • FSK registry (vha bruger idkort)
    • Svareksponeringsservice XDS Registry Adapter. Der delegerer søgninger videre til Svareksponeringsservicen efter laboratoriesvar
  • DokumentDelingsServicen (DDS repository) (anvenderguide) anvendes til at hente dokumenter (ITI-43 Retrieve Document Set) fra repositories som
    • det Nationale XDS Repositoryaftale adaptorer til Region Nord og Midt, som henter Bookplan dokumenter i Region Nord hhv. Region Midt
    • Svareksponeringsservice XDS Repository Adapter. Der delegerer hentning af laboratoriesvar videre til Svareksponeringsservicen
    • KIH databasen
    • Graviditetsmappe On-Demand repositoryFSK (vha bruger idkort)
  • Søgning af Fælles StamKort (SFSK) (anvenderguide) er til at fremsøge (ITI-18 Registry Stored Query) og hente (ITI-43 Retrieve Document Set) Fælles Stamkort vha system idkort . Dette er on-demand dokumenter, som skabes ud fra en række bagvedliggende stamdata services.
  • Læse servicene i DDS registry/ DDS repository og SFSK gør brug at hjælpe komponenterne SamtykkeService, BehandlerRelationsService , SamtykkeService og MinLog2 for at sikre borgerens rettigheder. Se evt. DDS anvenderguide for mere beskrivelse.
  • Læse servicene i SFSK gør brug at hjælpe komponenterne BehandlerRelationsService og MinLog2 for at sikre borgerens rettigheder.


Ovenstående  infrastruktur findes i flere versioner/miljøer. Eksempelvis findes miljøerne test1, test2, prodtest og produktion. Og f.eks. findes DROS i versionerne "Aftaler" , og "Graviditetsmappe" og "Planer og aftaler".

Hvordan kommer man i gang

Komponenterne i dokumentdelings infrastrukturen kommunikerer med ITI kald, som er standardiserede SOAP services, der skal overholde IHE XDS specifikationen - i det såkaldte XML basererede "RIM format"

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 ud fra 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.

...

OpeneHealth biblioteket til Java

Man kan med fordel inkludere biblioteket IPF Commons IHE XDS i sin kodebase. Her findes både stubbe og en masse anvendelige utilities. Disse kan blandt andet mappe fra den IHE XDS standard specificerede RIM format, til en en "OpeneHealth core model", som er java klasser. Og gør det at udvikle ITI kald lettere at arbejde med.

...

Savnes inspiration til kodeeksempler, er også integrationstestene til f.eks. DROS og NXRG et godt sted at kigge.


Et eksempel på ITI-41 request og response ses nedenfor.

...

VærktøjBeskrivelseLink



DDS

Guide til anvendere, når man skal læse data:

  • 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 data:

  • 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.AftaleoversigtAftaleoversigten
AftalerBeskriver servicearkitekturen, der ligger bag deling af aftaler via NSPhttps://www.nspop.dk/display/public/web/Aftaler
NSP test endpoints

For test1 kan man anvende endpoints til højre. Ønskes i stedet adgang til test2, skiftet "test1" ud med "test2".

sts endpointet anvendes i forbindelse med at man trækker et idkort til DGWS.

Alle test miljøer: Endpoints for eksterne testmiljøer

iti18: http://test1-cnsp.ekstern-test.nspop.dk:8080/ddsregistry    
iti43: http://test1-cnsp.ekstern-test.nspop.dk:8080/ddsrepository
iti41: http://test1-cnsp.ekstern-test.nspop.dk:8080/dros/iti41
iti57: http://test1-cnsp.ekstern-test.nspop.dk:8080/dros/iti57
iti42: http://test1-cnsp.ekstern-test.nspop.dk:8080/dros/iti42
iti61: http://test1-cnsp.ekstern-test.nspop.dk:8080/dros/iti61
sts(dgws): http://test1.ekstern-test.nspop.dk:8080/sts/services/NewSecurityTokenService




Medcom CDA Viewer

Her kan man fremsøge, hente, oprette, rette og ugyldiggøre (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 dokumenter oprettes 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 nævnte 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. Herunder udtræk af metadata.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.  Den er dog ikke helt opdateret på alle punkter.

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

...