Version | Dato | Ændring | Ansvarlig |
|---|---|---|---|
2.0.0 | 2018-08-27 | Initialt dokument | Trifork |
| 2.0.8 | 2019-08-16 | Tilføjet note om MinLog SessionId | Trifork |
| 2.0.11 | 2019-12-16 | Ajourført | Trifork |
| 2.0.12 | 2021-08-20 | Fjernet reference til Syncjob | KIT |
HL7 CDA | Standard til udveksling af oplysninger indenfor sundhedsvæsenet. |
Forkortelse | Betydning |
|---|---|
FSK | Det Fælles Stamkort |
| DDS | Dokumentdelingsservicen |
| SCES | CPR Enkeltopslags service |
| ODR | Organdonorregistret |
| LTR | Livstestamenteregistret |
| BTR | Behandlingstestamenteregistret |
Det Fælles Stamkort servicen (FSK) har har til formål at agere on-demand dokumentkilde for Dokumentdelingsservicen (DDS). En sundhedsfaglig kan foretage en forespørgsel til Dokumentdelingsservicen på, hvilke dokumenter der findes for en person. Dokumentdelingsservicen returnerer en liste over dokumenter, og såfremt der er registreret et stamkort for personen, vil dette være iblandt de dokumenter, der returneres. Herefter kan den sundhedsdaglige kalde Dokumentddelingsservicen og bede om et dokument. Når der bedes om stamkortet, vil DDS kalde FSK for at hente dette, da denne type dokumenter er registreret i DDS som et on-demand dokument. FSK vil herefter kalde et antal underregistre for at hente de data, der skal indgå i det dokumentet:
Ud fra de hentede data sammensætter FSK et HL7 CDA ClinicalDocument, som returneres via DDS til til den sundhedsfaglige. Alle data fra stamkortet indgår i svaret, men for livstestamente-, behandlingstestamente- og organdonorregistret gælder, at såfremt den sundhedsfaglige vil tilgå de faktiske data fra registrene, skal disse hentes ved et direkte kald til den pågældende registerservice.
Figuren herunder illustrerer hvorledes FSK servicen indgår som samleled mellem DDS og de underliggende registre:
Der kan alene hentes data fra FSK. Opdateringer til de underliggende registre skal foretages ved direkte kald til pågældende services.
Alt dataudveksling er basereret på HL7 Clinical Document Architecture (CDA).
Data fra selve registret udstilles i CDA-dokumentets body (structuredBody), mens metadata og informationer fra andre datakilder udstilles i CDA-dokumentets header. Metadata er hovedsageligt information om, hvilken borger de pågældende oplysninger vedrører.
HL7 CDA er tiltænkt kliniske dokumenter og ikke specifikt stamkortregisterdata. Derfor har MedCom udviklet en dansk implementeringsguide (PDC-DK V.3.0), for hvordan oplysningerne repræsenteres vha. standard CDA-elementer.
Forretningslogikken i servicen er afkoblet fra udvekslingsformatet, dvs. Fra HL7 CDA.
Se Guide til Anvendere for flere detaljer.
Kald til FSK servicen foretages alene igennem Dokumentdelingsservicen.
<iframe src="https://archi.nspop.dk/NSP/570928ca/views/id-47687249-d866-45e5-b52e-7a14c53ea291.html" name="test" height="650" width="800">You need a Frames Capable browser to view this content.</iframe> |
* Hver kasse i ovenstående diagram har en kort forklaring, som kommer frem i et nyt browservindue, når der klikkes på kassen.
Kaldet til FSK 1.5 fra DDS er et SOAP 1.2 kald med DGWS headers (Den Gode Webservice). Der kræves anvendelse af OCES sikkerhedsniveau 4, hvor der skal medsendes et ID-kort, som er signeret med medarbejdercertifikat (MOCES). Dog er der pt. konfigureret en undtagelse for Sundhed.dk, som kan foretage kald med OCES sikkerthedsniveau 3. Servicen vil verificere at kaldet er korrekt signeret, og at signeringen ikke er udløbet.
Der henvises til hhv. Den Gode Webservice og OIO Identity-based Web Services v1.0.1a for yderligere information.
Ved kald til servicen vil der blive foretaget logning af, at der er foretaget et kald, samt hvem der har foretaget kaldet, hvornår kaldet blev foretaget, og hvor lang tid behandlingen af kaldet varede. Dette vil ske i form af auditlogning, SLA-logning samt logning i MinLog2.
Cpr-subscriber er en fælles intern applikation hvis formål er at håndtere al kommunikation til stamdata (cpr-registry). FSK-servicen inkluderer et job der skal sørge for at vedligeholde DDS registry med information om aktuelle on-demand dokumenter. Som en del af dette sletter jobbet dokumenter for borger 1 år efter at personen er afgået ved døden.
Opslag af oplysninger registreres i MinLog2. Det kan konfigureres, om der skal logges, når der kaldes med SOSI Idkort niveau 3. Alle andre opslag logges.
(Dele af følgende bliver muligvis ændret senere:) Ved manglende adgang til MinLog-servicen logges en fejl i applikationsloggen men servicekaldet fejler ikke.
CPR Enkeltopslagsservicen (SCES) anvendes til opslag af følgende oplysninger:
For personer, der er registreret som PersonWardRelation=barn, PersonCustodyRelation=mor og PersonCustodyRelation=far i CPR, laves et separat opslag:
Såfremt opslag af CPR-data for personen fejler, f.eks. hvis data ikke findes, vil on-demand servicekaldet fejle. Hvis opslag af værge fejler vil servicekaldet også fejle, dog ikke hvis det blot er fordi at data ikke findes.
Fra stamkortregistret (SKR) hentes personens stamkort. Dette omfatter følgende oplysninger:
Såfremt data for tandlæge omfatter ydernummer, vil FSK servicen foretage opslag af navn, adresse mv for pågælende tandlæge i yderregistret. Disse yder data vil indgå i det endelige svar fra on-demand servicen.
Fra FGHVR hentes ønske om fravalg af genoplivning, for en given borger.
Fra de 3 registre Livstestamenteregister (LTR), Behandlingstestamenteregister (BTR) og Organdonorregister (ODR) hentes alene oplysning om, hvorvidt der findes en registrering.
FSK er ikke i sig selv et databærende register, men håndterer alene data fra de underliggende registre.
Dog er det nødvendigt at for servicen at lagre data i en database omkring, hvilke dokument-ID'er, der er tildelt til hvilke borgeres stamkort.
<iframe src="https://archi.nspop.dk/NSP/570928ca/views/id-5d2247bf-39c8-4088-9de8-030f6871cb4b.html" name="test" height="170" width="800">You need a Frames Capable browser to view this content.</iframe> |
* Hver kasse i ovenstående diagram har en kort forklaring, som kommer frem i et nyt browservindue, når der klikkes på kassen.
Det detaljerede schema for databasen er vist på figuren herunder.
RegistryIndex indeholder information om en persons stamkorts dokument-ID i DDS registry.