...

NSP stiller et nationalt dokument repository til rådighed til opbevaring af dokumenter til Aftaleoversigten. De parter der implementerer løsninger som en del af Aftaleoversigten kan vælge imellem at benytte det nationale dokument repository, at implementere deres eget repository, eller implementere en “On Demand Document Source”.
Fælles for disse løsninger er dog at metadata skal registeres i det nationale dokument registry.

Indhold i Aftaleoversigt

[Under opdatering]

Tekniske forudsætninger

...

Først og fremmest skal man kende til det indholdsformat der benyttes til aftaledokumenter. Formatet er XML og indholdet er specificeret som en dansk profil af CDA. Den danske profil for CDA Appointment (DK-APD 2.0) er forankret hos Medcom der står for den danske profilering. Se under Medcom DK-APD hvor både beskrivelse af standarden samt forskellige aftale eksempler opbevares.

Et CDA dokument består af en header og en body, hvor headeren generelt beskriver en række metadata omkring dokumentets indhold, mens de dokumentspecifikke data placeres i body sektionen.

Indholdet i CDA headeren er fælles for alle danske CDA dokumenter, og er ligeledes forankret hos Medcom, se under Medcom CDA Header.

Yderligere information om om hvordan CDA dokumenter er opbygget kan findes hos IHE, under: IHE - Hvad er HL7 CDA?

Tekniske forudsætninger

Se Administrative forudsætninger for at få adgang til NSP'en.

Fælles stamkort udstilles via services på NSP'en, disse skal tilgås gennem en afkoblingskomponent "DCC'en" DCC'en viderestiller kald til underliggende services, så der er ikke en WSDL for DCC'en. Se DCC Dokumentation for adgang til servies gennem DCC'en.

NSP services kan tilgås enten via Den Gode Webservice (DGWS) eller via OIO-IDWS (Udelukkende borgeradgang).
Den Gode WebService benytter XMLDSIG til at signere SAML assertions ud fra X.509 certifikater/nøgler - for adgang til Fælles Stamkort skal sundhedspersoner have et gyldigt Nem-ID Medarbejdercertifikat (MOCES) - for mere information om den gode webservice, se: https://www.medcom.dk/standarder/webservice-standarder/den-gode-webservice

Til at understøtte SAML har Sundhedsdatastyrelsen udviklet biblioteker til Java og .NET (SEAL biblioteket) Dette bør benyttes så vidt det er muligt, se STS Dokumentation

De servicesnitflader der udstilles til Aftaleoversigten er, allebaseret på SOAP kald der opfylder den gode web service (DGWS).
Der arbejdes på at indføre en model baseret på IDWS kompatibel med XUA, som anvendes af de standard produkter der implementerer IHE XDS.

Indholdsdelen af den enkelte servicekald (SOAP body) er den del der er specificeret af IHE XDS snitfladerne, dvs. for eksempel ITI-18 og ITI-43.

De detaljerede beskrivelser af snitfladerne findes i IHE IT Infrastructure Technical Framework dokumenterner volume 1, 2a, 2b, 2x og 3.

• IHE ITI TF Vol. 1 - Integration Profiles
  http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol1.pdf
• IHE ITI TF Vol. 2a - Transactions 1-28
  http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol2a.pdf
• IHE ITI TF Vol. 2b - Transactions 29-64
  http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol2b.pdf
• IHE ITI TF Vol. 2x - Appendices A-X
  http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol2x.pdf
• IHE ITI TF Vol. 3 - Metadata
  http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol3.pdf

Beskrivelserne i de officielle dokumenter fra IHE er relativt komplicerede, og det kan være svært at opnå et godt overblik over hvordan specifikke kald sættes sammen. Der findes en række generelle og praktiske eksempler og programmer på IPF Open eHealth Integration Platform siderne. Se for eksempel:

• IPF Open eHealth Integration Platform
  http://oehf.github.io/ipf/ipf-platform-camel-ihe/
• IPF Commons IHE XDS
  https://mvnrepository.com/artifact/org.openehealth.ipf.commons/ipf-commons-ihe-xds

Søgning på Aftaler

[Under opdatering]

...

Oprettelse af Aftaler

[Under opdatering]

...

Ændring af Aftaler

[Under opdatering]

Sletning af Aftaler

...

Sikkerhed, roller og rettigheder

For adgang til Aftaleoversigten skal der for sundhedspersoner eksistere et gyldigt SOSI-ID kort som er signeret af NSP'ens Secure Token Service, dokumentationen for SOSI-ID kort og STS ligger under: Anvenderguide til STS

Sundhedspersoner, med en sundhedsfaglig autorisation har adgang til Aftaleoversigten. Sundhedspersoner uden sundhedsfaglig autorisation skal have tilknyttet en rettighed før disse kan få adgang. Lokale organisationer kan enten tilknytte disse rettigheder via Sundhedsstyrelssens Elektroniske Brugerstyring (SEB), eller give rettigheden via den lokale identifikations- og rettighedstyring.

Følgende rollebeskrivelser anvendes i forbindelse med Et samlet patientoverblik.

En sundhedsperson kan ikke have tilknyttet flere roller på samme tid - dette skal administreres via den lokale identifikations- og rettighedstyring.[Under opdatering]

Håndtering af Spærring og fuldmagt

Spærring

Adgang til Aftaleoversigten kan være spærret for den sundhedsfaglige, i det tilfælde vil fejlkoden "Consent Filter Applied" returneres (se nedenstående xml eksempel), det betyder at adgang til Fælles Stamkort er spærret, og klienten skal derfor enten angive et værdispring, eller angive der ligger et explicit samtykke til at se data, og så spørge igen.
Yderligere information omkring spærring og forespørgsler via dokumentdeling kan ses i Brugervejledning til forespørgsler via DDS

ITI-18 Spærrede dokumenter  Collapse source

Fuldmagt

Patientportaler kan give patienternes pårørende adgang via den Fælles Offentlige Fuldmagtsservice, hvortil der er tilknyttet en brugergrænseflade på Borger.dk.

Bevis for fuldmagter er understøttet i OIO-IDWS identitytokens signeret af STS'en, dog understøtter dokumentdelingsservicen ikke OIO-IDWS - så fuldmagter er istedet etableret via en trust-løsning hvor patientportalen selv håndterer kontrol af fuldmagter.

Information angående angivelse af fuldmagter via dokumentdelingsservicen, kan ses i HSUID header dokumentation.[Under opdatering]

Ændringslog

...