Versions Compared

Old Version 13

changes.mady.by.user Kjeld Froberg

Saved on

compared with

New Version 14

changes.mady.by.user Unknown User (jeh)

Saved on

Key

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

...

VersionDatoÆndringAnsvarlig
1.02018-08-16Initialt dokumentTrifork
1.12018-09-11Præciseret hvilke delte strukturer der henvises til.Trifork
1.22018-09-13Tilføjet manglende beskrivelse af ID-attribut for Language-struktur (UUID)Trifork
1.32018-10-11

Præcisering omkring antal midlertidige adresser, så der altid kun er én

Rettelse af tekst omkring periode for midlertidig adresse, så det matcher den der står i SKR

SDS
1.42018-12-05

Pårørendes telefonnummer (associatedEntity.telecom) stod fejlagtigt som optionelt.

Pårørendes telefonnummer skal angives, da sundhedsfaglige ikke ønsker en liste af pårørende, de ikke kan kontakte.

SDS
1.52019-01-04

Borgere med beskyttede adresser i CPR registeret bliver markeret i CDA-headeren

(Gældende fra release 2.0.4)

SDS
2.0.112019-12-16

Ajourført. Bemærk, at versionering af dokumentation ikke bør ske særskilt, men skal følge komponentens version.

Trifork

Generelt

Fælles Stamkort (FSK) er en service der udstiller borgeres stamdata fra udvalgte registre. Dette inkluderer pårørende, midlertidige adresser, sprog, kontaktoplysninger, tandlæge, livstestamente-, behandlingstestamente, og organdonorregistrering. FSKs dataformat beskrives i det følgende, som forudsætter kendskab til XML og HL7 CDA.

...

  • borgerens navne- og adresseoplysninger (Hvis ikke de er navne/adressebeskyttede)
  • forældre og forældremyndighed
  • egen læge, inkl. adresse og kontaktoplysninger
  • sygesikringsgruppe
  • et antal pårørende (med tilhørende kontakt- og fritekstoplysninger)
  • eventuelle midlertidig(e) adresse(r)
  • borgerens sprog
  • borgerens kontaktoplysninger (telefonnumre)
  • tandlæges stamdata
  • indikator for livstestamente
  • indikator for behandlingstestamente
  • indikator for organdonorregistrering

Der sker registrering af, hvem der gennem tiden har opdateret de forskellige elementer af borgerens stamkort, og disse oplysninger udstilles på stamkortet.

Fælles stamkort populerer CDA-header imformationen med CPR-oplysninger fra hentes vha. det gode CPR opslag (https://www.medcom.dk/standarder/webservice-standarder/det-gode-cpr-opslag), og efterlever de begrænsninger standarden stiller.

Begreber

Et stamkort repræsenteres som et "ClinicalDocument", som er grundpillen i CDA. Ifm. FSK er der lavet en extension til CDA, som gør det muligt at repræsentere pårørende, midlertidige adresse, sprog samt indikation for livstestamente, behandlingstestamente og organdonorregistrering som entry-typer i dokumentets "structuredBody". Nedenfor ses ClinicalDocument-strukturen som det benyttes i FSK:

...

Det er derfor også i datakilden for CPR-opslag at ting såsom adressebeskyttelse håndteres.

Serviceoperationer

FSK indeholder ingen serviceoperationer, som er direkte tilgængelige for klienter. Derimod udstilles FSKs data som et "on demand"-dokument i dokumentdelingsservicen (DDS). Dette betyder at klienter skal anvende services fra DDS til fremsøgning af data fra FSK. Disse services er beskrevet her: Dokumentdelingsservice (DDS), og nedenfor beskrives hvilke data der skal til ifm. anvendelsen af DDS, samt formatet af det returnerede dokument.

DDS konfiguration

Proceduren er, at FSK registrerer metadata i DDS om det "on demand"-dokument der for hver borger kan trækkes fra FSK. Efterfølgende kan klienter fx lave en "AdhoqQuery" for at fremsøge hvilke dokumenter der findes for fx et givet CPR-nummer.

For at kunne benytte DDS til fremsøgning af oplysninger i FSK er det dog nødvendigt at kende følgende stamdata om FSK's "on demand"-dokumenter:

FSK HomeCommunityId: 1.2.208.176.8.1.12

MiljøRepositoryUniqueId
Test11.2.208.176.43210.8.10.12
Test21.2.208.176.43210.8.20.12
ProdTest1.2.208.176.43210.8.30.12
Uddannelse1.2.208.176.43210.8.40.12
Produktion

...

Selve dokumentets "header" indeholder (udover personen der senest har opdateret stamkortet) data fra CPR-registeret. De øvrige stamkort-data ligger under "StructuredBody", som indeholder en liste af "entry"-sektioner. Disse kan i FSK-sammenhæng have indhold af typen relatedPerson, temporaryAddress, language, healthProvider og observation. Ifm. HL7 CDA er der defineret en række "OIDer", som hver især definerer et udfaldsrum for forskellige id/kode-typer. Meningen er, at der til et id (på fx en person, altså CPR-nummer) defineres et OID, som kan betragtes som en type-erklæring. For FSK er følgende OID'er aktuelle:

TypeOIDBeskrivelseEksempelPatientkontakt1.3.6.1.4.1.19376.1.5.3.1.2.4Template-id på participant (se evt. https://wiki.ihe.net/index.php/1.3.6.1.4.1.19376.1.5.3.1.2.4)

<ns2:participant typeCode="IND">

<ns2:templateId root="1.3.6.1.4.1.19376.1.5.3.1.2.4"/>

SOR
1.2.208.176.
1
8.1.12

For en detaljeret oversigt over, hvilke metadata der registreres i DDS registry henvises til denne side.

Fælles Stamkort CDA profil

MedCom har udarbejdet en dansk profil for et Fælles Stamkort dokument betegnet Personal Data Card Document release 2.0 (PDC-DK V.2.0).

Fra 2020 understøtter FSK denne nye CDA profil og anvendere skal derfor tage denne i brug. Der henvises til MedComs officielle udgivelser vedr. dokumentation af profilen samt eksempler, da disse jævnligt opdateres og for at undgå at udstille forældede dubletter i denne dokumentation.

Fælles Stamkort midlertidig profil (udfaset)

Info

Fra januar 2020 udfases den følgende midlertidige profil, og anvedere skal derfor i stedet anvende dokumenter i den officielle profil PDC-DK V.2.0 defineret af MedCom.

Den følgende dokumentation af formatet gælder således udelukkende den midlertidige profil.


Et stamkort repræsenteres som et "ClinicalDocument", som er grundpillen i CDA. Ifm. FSK er der lavet en extension til CDA, som gør det muligt at repræsentere pårørende, midlertidige adresse, sprog samt indikation for livstestamente, behandlingstestamente og organdonorregistrering som entry-typer i dokumentets "structuredBody". Nedenfor ses ClinicalDocument-strukturen som det benyttes i FSK:

Gliffy Diagram
nameClinicalDocument v11
pagePin1

Selve dokumentets "header" indeholder (udover personen der senest har opdateret stamkortet) data fra CPR-registeret. De øvrige stamkort-data ligger under "StructuredBody", som indeholder en liste af "entry"-sektioner. Disse kan i FSK-sammenhæng have indhold af typen relatedPerson, temporaryAddress, language, healthProvider og observation. Ifm. HL7 CDA er der defineret en række "OIDer", som hver især definerer et udfaldsrum for forskellige id/kode-typer. Meningen er, at der til et id (på fx en person, altså CPR-nummer) defineres et OID, som kan betragtes som en type-erklæring. For FSK er følgende OID'er aktuelle:

Stamkode code system1<ns2:code code="NA" codeSystem1 displayNameStamkortMidlertidig adresse18415*<ns4:temporaryAddress>
<ns4:id extension="5477653c-4c46-4f50-a566-591d677b541118415Behandlingstestamente TreatmentWill displayName"Behandlingstestamente codeSystem="Organdonor code system1<ns2:code code="OrganDonor" displayName="OrganDonorRegistration" codeSystem1
TypeOIDBeskrivelseEksempel
Patientkontakt1.3.6.1.4.1.19376.1.5.3.1.2.4Template-id på participant (se evt. https://wiki.ihe.net/index.php/1.3.6.1.4.1.19376.1.5.3.1.2.4)

<ns2:participant typeCode="IND">

<ns2:templateId root="1.3.6.1.4.1.19376.1.5.3.1.2.4"/>

SOR1.2.208.176.1.1Type af organisations-ID baseret på SOR.

<id extension="368061000016003

Type af organisations-ID baseret på SOR.

<id extension="368061000016003" root="1.2.208.176.1.1" assigningAuthorityName="SOR"/>

SKS2.16.840.1.113883.3.4208.100.5Type af organisations-ID baseret på SKS.<id extension="368061000016003" root="2.16.840.1.113883.3.4208.100.5" assigningAuthorityName="SKS"/>
CVR-P1.2.208.184.15.9*Type af organisations-ID baseret på CVR-P.<id extension="368061000016003" root="1.2.208.184.15.9" assigningAuthorityName="CVR-P"/>
CVR1.2.208.184.15.10*Type af organisations-ID baseret på CVR.<id extension="368061000016003" root="1.2.208.184.15.10" assigningAuthorityName="CVR"/>
Ydernummer1.2.208.184.15.8*Type af organisations-ID baseret på Ydernummer.<id extension="368061000016003" root="1.2.208.184.15.8" assigningAuthorityName="Yder"/>
Kommunekode1.2.208.184.15.11*Type af organisations-ID baseret på Kommunekode.<id extension="3680610000" root="1.2.208.184.15.11" assigningAuthorityName="Kommunekode"/>
CPR1.2.208.176.1.2CPR-nummer

<id extension="2512489996" root="1.2.208.176.1.2" assigningAuthorityName="CPR"/>

DK MedCom (member body)1.2.208.184Id på ClinicalDocument. Ikke aktual ifm. FSK (extension=NA)

<ns2:id assigningAuthorityName="MedCom" extension="NA" root="1.2.208.184176.1.1" assigningAuthorityName="SOR"/>

FortrolighedSKS2.16.840.1.113883.3.4208.100.5.25Altid N=Normal ifm. FSKType af organisations-ID baseret på SKS.<id extension="368061000016003" root<ns2:confidentialityCode code="N" codeSystem="2.16.840.1.113883.3.4208.5.25100.5" assigningAuthorityName="SKS"/>
ISOCVR-angivelse af sprogP1.2.0208.184.63915.1ISO-639-1 formatteret sprog<ns4:languageCode codeSystem="1.0.639.1">de</ns4:languageCode>
ISO-angivelse af køn2.16.840.1.113883.5.1En borgers køn (M/F)

<ns2:administrativeGenderCode code="F" codeSystem="2.16.840.1.113883.5.1"/>

Dokument type-id2.16.840.1.113883.1.3HL7-registreret RMIM (HL7 internal)

<ns2:typeId extension="POCD_HD000040" root="2.16.840.1.113883.1.3"/>

9*Type af organisations-ID baseret på CVR-P.<id extension="368061000016003" root="1.2.208.184.15.9" assigningAuthorityName="CVR-P"/>
CVR1.2.208.184.15.10*Type af organisations-ID baseret på CVR.<id extension="368061000016003" root="1.2.208.184.15.10" assigningAuthorityName="CVR"/>
Ydernummer1.2.208.184.15.8*Type af organisations-ID baseret på Ydernummer.<id extension="368061000016003" root="1.2.208.184.15.8" assigningAuthorityName="Yder"/>
Kommunekode1.2.208.184.15.11*Kodesystem, ikke aktuel ifm. FSK (code=NA)Type af organisations-ID baseret på Kommunekode.<id extension="3680610000" root="1.2.208.184.15.11" assigningAuthorityName="Kommunekode"/>
CPR1.2.208.176.1.2IDer (UUID) på midlertidige adresseCPR-nummer

<id extension="2512489996" root="1.2.208.

176.

1.2" assigningAuthorityName="CPR"/>

PårørendeDK MedCom (member body)1.2.208.184.15.3*IDer (UUID) på pårørendeId på ClinicalDocument. Ikke aktual ifm. FSK (extension=NA)

<ns2:id assigningAuthorityName="MedCom" extension="NA<ns4:relatedPerson>
<ns4:id extension="dc565d8b-cb87-4edf-9f43-02b996f73268" root="1.2.208.184.15.3"/>

Pårørende type
Fortrolighed2.16.840.1.2113883.208.184.15.4*Følger MedCom-definerede typer for pårørende: uspec_paaroerende, barn, aegtefaelle, forældre, barnebarn, svigerbarn, ingen_relationer, nabo, samboende, registreret_partner, søskende, øvrig_familie<ns2:code code="uspec_paaroerende" codeSystem="1.2.208.184.15.4"/>
Uddannelseskode1.2.208.184.15.5*IDer (UUID) på uddannelseskoder<ns2:id assigningAuthorityName="UDDANNELSESKODE" extension="7170" root="1.2.208.184.15.5"/>
Autorisationsid1.2.208.184.15.6*IDer (UUID) på autorisationskoder<ns2:id assigningAuthorityName="AUTORISATION" extension="09YM8" root="1.2.208.184.15.6"/>
Livstestamente code system1.2.208.184.15.1*Kodesystem

<ns2:code code="LivingWill" displayName="Livstestamente" codeSystem="1.2.208.184.15.1"/>

5.25Altid N=Normal ifm. FSK

<ns2:confidentialityCode code="N" codeSystem="2.16.840.1.113883.5.25"/>

ISO-angivelse af sprog1.0.639.1ISO-639-1 formatteret sprog<ns4:languageCode codeSystem="1.0.639.1">de</ns4:languageCode>
ISO-angivelse af køn2.16.840.1.113883.5.1En borgers køn (M/F)

<ns2:administrativeGenderCode code="F" codeSystem="2.16.840.1.113883.5.1"/>

Dokument type-id2.16.840.1.113883.1.3HL7-registreret RMIM (HL7 internal)

<ns2:typeId extension="POCD_HD000040" root="2.16.840.1.113883.1.3"/>

Stamkode code system1.2.208.184.15.1*Kodesystem, ikke aktuel ifm. FSK (code=NA)

<ns2:code code="

NA"

codeSystem=

"

1.2.208.184.15.1" displayName="Stamkort"/>

Midlertidig adresse1.2.208.184.15.2*KodesystemIDer (UUID) på midlertidige adresse

<ns4:temporaryAddress>
<ns4:id extension="5477653c-4c46-4f50-a566-591d677b5411" root="1.2.208.184.15.

2"/>

* id defineres endeligt af MedCom.

På oidref.com kan man i øvrigt se betydningen af enkeltcifre i de fleste OIDer, fx http://oidref.com/2.16.840.1.113883.1.3

Serviceoperationer

FSK indeholder ingen serviceoperationer, som er direkte tilgængelige for klienter. Derimod udstilles FSKs data som et "on demand"-dokument i dokumentdelingsservicen (DDS). Dette betyder at klienter skal anvende services fra DDS til fremsøgning af data fra FSK. Disse services er beskrevet her: Dokumentdelingsservice (DDS), og nedenfor beskrives hvilke data der skal til ifm. anvendelsen af DDS, samt formatet af det returnerede dokument.

DDS konfiguration

Proceduren er, at FSK registrerer metadata i DDS om det "on demand"-dokument der for hver borger kan trækkes fra FSK. Efterfølgende kan klienter fx lave en "AdhoqQuery" for at fremsøge hvilke dokumenter der findes for fx et givet CPR-nummer.

For at kunne benytte DDS til fremsøgning af oplysninger i FSK er det dog nødvendigt at kende følgende stamdata om FSK's "on demand"-dokumenter:

FSK HomeCommunityId: 1.2.208.176.8.1.12

Test217643210.8.20.1217643210.8.30.12
Pårørende1.2.208.184.15.3*IDer (UUID) på pårørende

<ns4:relatedPerson>
<ns4:id extension="dc565d8b-cb87-4edf-9f43-02b996f73268" root="1.2.208.184.15.3"/>

Pårørende type1.2.208.184.15.4*Følger MedCom-definerede typer for pårørende: uspec_paaroerende, barn, aegtefaelle, forældre, barnebarn, svigerbarn, ingen_relationer, nabo, samboende, registreret_partner, søskende, øvrig_familie<ns2:code code="uspec_paaroerende" codeSystem="1.2.208.184.15.4"/>
Uddannelseskode1.2.208.184.15.5*IDer (UUID) på uddannelseskoder<ns2:id assigningAuthorityName="UDDANNELSESKODE" extension="7170" root="1.2.208.184.15.5"/>
Autorisationsid1.2.208.184.15.6*IDer (UUID) på autorisationskoder<ns2:id assigningAuthorityName="AUTORISATION" extension="09YM8" root="1.2.208.184.15.6"/>
Livstestamente code system1.2.208.184.15.1*Kodesystem

<ns2:code code="LivingWill" displayName="Livstestamente" codeSystem="1.2.208.184.15.1"/>

Behandlingstestamente code system1.2.208.184.15.1*Kodesystem

<ns2:code code="TreatmentWill" displayName="Behandlingstestamente" codeSystem="1.2.208.184.15.1"/>

Organdonor code system
MiljøRepositoryUniqueId
Test11.2.208.176.43210.8.10.12
1.2.208.184.ProdTest15.1*Kodesystem

<ns2:code code="OrganDonor" displayName="OrganDonorRegistration" codeSystem="1.2.208.

184.

Uddannelse1.2.208.176.43210.8.40.12
Produktion1.2.208.176.8.1.12

15.1"/>

* id defineres endeligt af MedCom.

På oidref.com kan man i øvrigt se betydningen af enkeltcifre i de fleste OIDer, fx http://oidref.com/2.16.840.1.113883.1.3For en detaljeret oversigt over, hvilke metadata der registreres i DDS registry henvises til denne side. 

Dokumentformat

Nedenfor beskrives formatet af "on demand"-dokumentet, som returneres fra FSK. For hard-kodede værdier angives ikke en type.

...