Page History
...
Migrering af data fra lokale fagsystemer til Fælles Stamkort
Migrering af stamkortdata fra fagsystemet til Fælles Stamkort inden løsningen ibrugtages i drift, er en mulighed myndigheder med deres fagsystemer kan benytte.
Ved at lave en migrering vil forretningsværdien af at benytte Fælles Stamkort kunne udnyttes hurtigere, da borgere derved hurtigere vil få et overblik over de stamkortdata fagsystemerne har registreret på dem, og således kan verificere og kvalificere disse stamkortdata.
Benyttes migreringsprocessen, skal den kun køre en gang pr. fagsystem, da stamkortdata under migreringen udelukkende vil blive skrevet til Fælles Stamkort, uden hensyntagen til eksisterende data i Fælles Stamkort.
Udførsel af migreringsprocessen skal benytte en ny migreringsgrænseflade på Stamkortregisteret, som har til ansvar at sikre datakvaliteten for migreringen, samt sikre at borgere der allerede har etableret et Fælles Stamkort, ikke får overskrevet dette med ikke validerede data fra fagsystemerne.
Undlader myndigheden at benytte migreringsprocessen for deres fagsystemer, eller for dele af deres fagsystemer bør der laves lokale overvejelser for hvordan stamkort efterfølgende ibrugtages.
Principper for migrering af stamkortdata
#1: Alle stamkortdata migreres ukritisk
Stamkortdata migreres ukritisk, hvilket vil sige der ikke skal tages højde for tidligere udmeldte fletteregler. Forretningsregler skal stadig overholdes, hvilket beskrives nærmere i følgende principper.
Migreringsgrænsefladen vil returnere en fejlkode, i tilfælde af enten et brud på en forretningsregel, eller brud på en af følgende principper. Fagsystemet skal ikke, i det tilfælde det modtager en fejlkode, migrere det pågældende element der giver fejlkoden.
Fagsystemet bør i tilfælde af det ikke kan migrere stamkortdata overveje om det vil beholde lokale stamkortdata til senere synkronisering, eller om det eventuelt vil fjerne lokale data og udelukkende basere sig på de data der eksisterer i Fælles Stamkort.
Konsekvensen af en ukritisk migrering vil være, at der kan være duplikater af data på f.eks. borgerens pårørende. Dette kan borgeren, eller dennes pårørende, enten selv rette op på via brugergrænsefladen på sundhed.dk, eller sundhedspersoner kan hjælpe de borgere der ikke har fået det gjort, eller som ikke er i stand til selv at gøre dette.
#2: Hvor borgere i forvejen har oprettet et Fælles Stamkort vil det ikke være muligt at migrere stamkortdata
Fælles Stamkort skal gøre det muligt at migrere stamkortdata, hvor borgeren allerede har verificeret stamkortdata.
Borgeren kan enten selv have verificeret sine data, eller det kan være gjort af en sundhedsperson på vegne af borgeren, eller af borgerens fuldmagtshavere.
Der returneres en fejlkode fra migreringsgrænsefladen, og fagsystemet skal ikke migrere stamkortdata for denne borger.
...
Fejlkode: 800
Fejltekst: Fælles Stamkort er verificeret af borgeren
Når borgeren efterfølgende har kontakt til myndigheden, og denne myndighed slår borgeren op i fagsystemet, bør fagsystemet allerede have taget stilling til om lokale data beholdes, da fagsystemet i den sammenhængt skal synkronisere med Fælles Stamkort
Eksemplet nedenfor viser hvordan det lokale fagsystem har tilknyttet UUID'er til de pårørende der står registreret lokalt, men ved efterfølgende migrering får fejlkode 800 retur, og derved kan se at borgeren allerede har et verificeret stamkort, og at stamdata ikke er migreret.
Eksempel på migrering hvor borgeren har et verificeret stamkort i forvejen
#3: Alle pårørende oprettes ukritisk
Stamkort data indeholdende pårørende information skrives ukritisk til Fælles Stamkort, altså uden hensyntagen til om der skulle eksistere en pårørende med samme oplysninger i forvejen, i borgerens Fælles Stamkort.
Fagsystemet skal tilknytte en UUID til hver pårørende der migreres, og gemme denne UUID sammen med pårørende oplysninger i fagsystemet. Efterfølgende synkronisering af Fælles Stamkort, når borgeren er i kontakt med myndigheden, vil dermed kunne sikre, hvilke pårørende der har fået rettet op på data, er slettet, eller er migreret fra andre fagsystemer.
Første eksempel nedenfor viser hvordan det lokale fagsystem har tilknyttet UUID'er til de pårørende der står registreret lokalt, og disse migreres til Fælles Stamkort selvom der allerede eksisterer en pårørende med navnet Hans Hansen i Fælles Stamkort. Den eneste forskel på de to Hans Hansen'er i Fælles Stamkort er UUID'en.
Efterfølgende migrerer fagsystem nr. 2, som vist i andet eksempel nedenfor, hvor endnu en dublet af pårørende Hans Hansen oprettes i Fælles Stamkort.
Migrering af pårørende til Fælles Stamkort, resulterende i dubletter
Migrering af pårørende fra fagsystem nr. 2 til Fælles Stamkort, resulterende i flere dubletter
#4: Oprydning i fagsystemer inden migrering
Fagsystemerne bør inden migrering af borgerens kontaktinformation (nuværende 3 typer af telefonnumre - hjemme, mobil, arbejde) - have struktureret egne data i fagsystemet. Fagsystemet skal skrive kontaktinformationen til Fælles Stamkort, eksisterer der et telefonnummer i forvejen, vil migreringsgrænsefladen returnere en fejlkode, og fagsystemet skal ikke skrive borgerens telefonnummer.
Fagsystemet bør overveje hvordan telefonnumre der ikke er migreret skal håndteres lokalt.
...
Fejlkode: 810
Fejltekst: Der eksisterer et telefonnummer af type <indsat type> i forvejen
Efterfølgende synkronisering af Fælles Stamkort, vil ske når borgeren er i kontakt med en myndighed.
Første eksempel nedenfor viser hvordan det lokale fagsystem i forvejen har struktureret telefonnumrene på borgeren, og ved migreringen får skrevet hjemme nummeret til Fælles Stamkort. Hvorimod andet eksempel nedenfor kun får skrevet hjemme nummeret, men får fejlkode tilbage på mobilnummeret, da dette eksisterer i forvejen.
Migrering af borgerens hjemme telefonnummer til Fælles Stamkort
Migrering af borgerens hjemme telefonnummer, men fejl på borgerens mobiltelefonnummer da dette eksisterer i forvejen.
#5: Fagsystemerne skal udelukkende migrere borgerens sprog, hvis det ikke eksisterer i forvejen
Fælles Stamkort har i forretningsregel nr. 11 defineret at der maksimalt kan være et sprog for borgeren, eksisterer der et sprog i forvejen, vil migreringsgrænsefladen returnere en fejlkode, og fagsystemet skal ikke skrive borgerens sprog.
Fagsystemet bør overveje hvordan sprog der ikke er migreret, skal håndteres lokalt.
...
Fejlkode: 820
Fejltekst: Borgerens sprog eksisterer i forvejen
Efterfølgende synkronisering af Fælles Stamkort, vil ske når borgeren er i kontakt med en myndighed.
Eksemplet nedenfor viser hvordan det Fælles Stamkort i forvejen har borgerens sprog til dansk, og ved migreringen får en fejlkode tilbage
Migrering af borgerens sprog giver en fejlkode retur
#6: Fagsystemerne skal udelukkende migrere borgerens midlertidige adresse, hvis den ikke eksisterer i forvejen
Fælles Stamkort har i forretningsregel nr. 7 defineret at der maksimalt kan være en midlertidig adresse for borgeren i Fælles Stamkort, eksisterer der en midlertidig adresse i forvejen, vil migreringsgrænsefladen returnere en fejlkode, og fagsystemet skal ikke skrive borgerens midlertidige adresse.
Fagsystemet bør overveje hvordan en midlertidig adresse der ikke er migreret skal håndteres lokalt.
...
Fejlkode: 830
Fejltekst: Borgerens midlertidige adresse eksisterer i forvejen
Funktionaliteten vedr. migrering er arkiveret, anvend fremadrettet den beskrevne proces for synkronisering af data mellem lokale fagsystemer og Fælles Stamkort
Dokumentation for migrering bibeholdes indtil servicen er lukket ned, og kan ses under: Migrering af data fra lokale fagsystemer til Fælles Stamkort
Efterfølgende synkronisering af Fælles Stamkort, vil ske når borgeren er i kontakt med en myndighed.
Eksemplet nedenfor viser hvordan Fælles Stamkort i forvejen har borgerens midlertidige adresse, og ved migreringen giver en fejlkode tilbage til fagsystemet
Migrering af borgerens midlertidige adresse giver en fejlkode retur
Tilslutning og governance i forhold til migreringsgrænsefladen.
Fagsystemer der tilsluttes migreringsgrænsefladen, skal have en whitelisting af det certifikat der benyttes til at skrive data til migreringsgrænsefladen.
Tilslutning skal anmeldes via den nationale servicedesk[1], hvor der oprettes en supportsag. Supportsagen skal indeholde "Subject" fra certifikatet, som følgende eksempel viser
Subject: SERIALNUMBER=CVR:11111111-FID:22222222 + CN=www.test-eksempel.dk – NemLogin (funktionscertifikat), O=Test-eksempel A/S // CVR:00000000, C=DK
Supportsagen skal ligeledes indeholde planlagt dato og tidspunkt for hvornår migreringen ønskes startet, således det kan planlægges fra Sundhedsdatastyrelsen at ikke alle fagsystemerne migrerer på samme tid.
Efter succesfuld migrering, vil whitelistingen for fagsystemet blive fjernet igen
Daglig drift mellem lokale fagsystemer og Fælles Stamkort
...
Kode | Beskrivelse | Eksempel | Kilde |
Patientens CPR-nummer er en del af den generiske CDA header recordTarget.patientRole.id | Patientens CPR-nummer Patientens CPR-nummer er en del af den generiske CDA Header. | <id assigningAuthorityName="CPR" extension="2512489996" root="1.2.208.176.1.2"/> | CPR – register |
Patientens navn og adresse er en del af den generiske CDA header recordTarget.patientRole.addr | Patientens navn og adresse Patientens navn og adresse er en del af den generiske CDA Header. | <addr use="H"> Bemærk at har patienten navne eller adressebeskyttelse vises "BESKYTTET NAVN/ADRESSE" | CPR - register |
Information om patientens pårørende component.structuredBody. templateId code | Oplysninger om patientens pårørende, som patienten selv har angivet. Oplysningerne er: · Pårørendes Navn · Pårørendes Relation · Pårørendes Telefonnummer · Fritekstfelt, hvor der f.eks. kan angives "bor i Canada" Bemærk der kan kun angives flere observation med patientens pårørende | <templateId root="1.2.208.184.16.1.10.20.1.25" extension="2019-08-14"/> Bemærk: Der tilføjes ikke automatisk pårørende angivet i CPR-registeret (f.eks. værger og ægtefæller) - eneste undtagelse herfor er børn under forældremyndighed, eller personer som har forældremyndighed over et barn (se næste række) | Indtastet information fra stamkortregisteret |
Patientens børn under forældremyndighed component.structuredBody. templateId code
| Hvis patienten har forældremyndighed over et eller flere børn, kan børnene vises i Fælles Stamkort. Bemærk: Hvis patienten er biologisk forælder, men ikke har forældremyndigheden over barnet, vises barnet ikke i Fælles Stamkort. Bemærk: Hvis patienten er værge for et barn, men ikke har forældremyndigheden over det pågældende barn, vises barnet ikke i Fælles Stamkort. Bemærk: Der kan kun angives flere observationer med patientens børn under forældremyndighed. | <templateId root="1.2.208.184.16.1.10.20.1.23" extension="2019-08-14"/> <!-- Value representing the name of the child of whom the patient has custody --> <!-- Value representing the relationship the patient has to the child of whom the patient have custody → | CPR - register |
Patientens forældremyndighedshavere component.structuredBody. templateId code
| Hvis patienten er et barn, kan forældremyndighedshavere vises i Fælles Stamkort. Bemærk: Hvis barnet har biologiske forældre som ikke har forældremyndigheden over barnet, vises de biologiske forældre ikke i Fælles Stamkort. Bemærk: Hvis barnet er myndling under en værge, men værgen ikke har forældremyndigheden over det pågældende barn, vises værgen ikke i Fælles Stamkort. Bemærk: Der kan kun angives flere observationer med barnets forældremyndighedshavere. | <templateId root="1.2.208.184.16.1.10.20.1.23" extension="2019-08-14"/> <!-- Value representing the name of the Custodian of whom the patient is in custody --> <!-- Value representing the relationship the patient has to the custodian of whom the patient is in custody → | CPR - register |
Patientens telefonnummer component.structuredBody. templateId code | Patientens kontakt telefonnummer (3 telefonnumre kan angives (hjemme "H", mobil "MC", arbejde "WP"). Bemærk: Der kan kun angives en observation med patientens telefonnumre. | <templateId root=”1.2.208.184.16.1.10.20.1.24” extension=”2019-08-14”/> <value xsi:type=”TEL” use=”WP” value=”tel:33112244”/> <value xsi:type=”TEL” use=”MC” value=”tel:66774433”/> | Indtastet information fra stamkortregisteret |
Patientens midlertidige adresse component.structuredBody. templateId code | Patientens midlertidige adresse inklusiv et tidsinterval for hvornår patienten befinder sig på den midlertidige adresse. Bemærk: Det er ikke nødvendigt at angive et sluttidspunkt (effectivetime.high) for den midlertidige adresse. Bemærk: Er slutdatoen overskredet på forespørgselstidspunktet, returneres den midlertidige adresse ikke fra Fælles Stamkort. Bemærk: Der kan kun angives en observation med patientens midlertidige adresse. | <templateId root="1.2.208.184.16.1.10.20.1.21" extension="2019-08-14"/> | Indtastet information fra stamkortregisteret |
Patientens egen læge recordtarget.patientRole. | Kontaktoplysninger til patientens egen læge. Bemærk: Det er ikke alle patienter der har tilknyttet en læge - elementet er derfor optionelt. | <providerOrganization> <id extension="123456" root="1.2.208.176.1.4" assigningAuthorityName="Yderregisteret"/ <name>Lægerne Hansen</name> <telecom use="WP" value="tel:+4512345678"/> <telecom value="mailto:test@testyder.dk"/> <addr use="H"> <streetAddressLine>Ydervej 42</streetAddressLine <postalCode>1234</postalCode> <city>Yderby</city> </addr> </providerOrganization> | Yderregisteret |
Patientens tandlæge component.structuredBody. templateId code | Hvis patienten har tilknyttet en tandlæge, kan Fælles Stamkort indeholde kontaktoplysninger til tandlægen. Patienten skal selv angive tandlægen, Fælles Stamkort vil efterfølgende hente kontaktoplysninger på patientens tandlæge fra Yderregisteret. | <templateId root="1.2.208.184.16.1.10.20.1.22" extension="2019-08-14"/> | Indtastet information fra stamkortregisteret |
Sygesikringsgruppe component.structuredBody. templateId code | Patientens sygesikringsgruppe. | <templateId root="1.2.208.184.16.1.10.20.1.27" extension="2019-08-14"/> | Sygesikringsregisteret |
Patientens foretrukne kommunikationssprog. component.structuredBody. templateId code | Patienten kan registrere hvilket sprog de foretrækker at kommunikerer på. Feltet er forudfyldt med sproget ”Dansk”. Bemærk: Der kan kun registreres et sprog pr. patient. | <templateId root="1.2.208.184.16.1.10.20.1.20" extension="2019-08-14"/> | Indtastet information fra stamkortregisteret |
Behandlingstestamente component.structuredBody. templateId code | Information om patienten har registreret et Behandlingstestamente kan vises i Fælles Stamkort. Fælles Stamkort må IKKE vise indholdet i registreringen, kun OM der lavet en registrering. Bemærk: En patient kan have registreret enten et Behandlingstestamente eller et Livstestamente, ikke begge testamenter på samme tid. | <templateId root="1.2.208.184.16.1.10.20.1.29" extension="2019-08-14"/> | Behandlingstestamenteregister |
Livstestamente component.structuredBody. templateId code | Information om patienten har registreret et Livstestamente kan vises i Fælles Stamkort. Fælles Stamkort må IKKE vise indholdet i registreringen, kun OM der lavet en registrering. Bemærk: En patient kan have registreret enten et Behandlingstestamente eller et Livstestamente, ikke begge testamenter på samme tid. | <templateId root="1.2.208.184.16.1.10.20.1.30" extension="2019-08-14"/> | Livstestamenteregister |
Organdonorregistrering component.structuredBody. templateId code | Information om patienten har en Organdonorregistrering kan vises i Fælles Stamkort. Fælles Stamkort må IKKE vise indholdet i registreringen, kun OM der lavet en registrering. | <templateId root="1.2.208.184.16.1.10.20.1.28" extension="2019-08-14"/> <id extension="bf5b7087-b8dd-41f3-91c8-d2e0a8955c3a" root="1.2.208.184"/> <code code="OrganDonorRegistration" codeSystem="1.2.208.184.100.1" codeSystemName="MedCom Message Codes" displayName="Registreret organdonor"/> <value xsi:type="II" root="1.2.208.176.1.10" extension="true" assigningAuthorityName="Dansk Center For Organdonation"/> | Organdonorregisteret |
...
0.8 | 2019-12-06 | Udkast til Teknisk implementeringsguide til Fælles Stamkort | SDS |
1.0 | 2020-01-06 | Offentlig efter afsluttet kommenteringsrunde | SDS |
1.0.1 | 2020-01-21 | Tilrettet link til standard for Fælles Stamkort | SDS |
1.1 | 2020-03-27 | Tilrettet efter opdatering af testprotokol for CDA profilen Desuden mindre tekstuelle rettelser | SDS |
1.2 | 2020-05-28 | Indført afsnit som præciserer hvorledes data skal synkroniseres mellem lokale fagsystemer og Fælles Stamkort | SDS |
1.2.1 | 2020-06-26 | Præcisering omkring hvilke datafelter fra Fælles Stamkort, der skal vises for slutbrugerne. | SDS |
1.2.2 | 2020-10-21 | Opdateret med specifik reference til testprotokol for modtagelse af Fælles Stamkort | SDS |
1.3 | 2021-01-26 | Opdateret med migreringsgrænseflade | SDS |
1.3.1 | 2021-02-11 | Tilrettet AdhocQueryRequest eksemplet med on-demand documenttype angivelse | SDS |
1.3.2 | 2021-02-23 | Tilrettet eksempel på ITI-18 forespørgsel, da det benyttede forældet codesystem navn | SDS |
1.4 | 2021-03-04 | Opdateret med vejledning til adviseringer fra Stamkortregisteret | SDS |
1.5 | 2021-03-12 | Tilføjet beskrivelse omkring mulighed for system-system kald ved læsning af Fælles Stamkort | SDS |
1.5.1 | 2021-09-14 | Opdateret med endpoint beskrivelse for system-system kald | SDS |
1.5.2 | 2021-11-18 | Opdateret med endpoint beskrivelse for system-system kald til NSP-TEST-2, samt whitelisting og Minlog information | SDS |
1.5.3 | 2022-01-25 | Opdateret med endpoint beskrivelse for adviseringer, samt præciseringer af notifikationsformatet | SDS |
1.5.4 | 2022-04-20 | Opdateret med reference til ny Errata for PDC-DK CDA standarden fra MedCom | SDS |
1.5.5 | 2022-10-10 | Opdateret med reference til ny Errata for PDC-DK CDA standarden fra MedCom, Errata præciserer tilknytning af relationer i forbindelse med forældremyndighed. | SDS |
1.5.6 | 2023-03-01 | Opdateret link til MedCom Header v. 1.4. | SDS |
1.5.7 | 2023-03-20 | Rettet rettighed for nspSundAssistR2 - rollen giver kun adgang til Aftaleoversigten og Fælles Stamkort | SDS |
1.5.8 | 2023-04-26 | Fjernet beskrivelse af manuel indtastning af tandlæge | SDS |
1.6 | 2023-09-21 | Arkiveret beskrivelse af grænseflade til migrering af data fra lokale fagsystemer | SDS |