Page History
...
Version | Dato | Ændring | Ansvarlig |
---|---|---|---|
2018-08-31 | Initialt dokument | Trifork | |
2018-09-13 | Tilføjet manglende beskrivelse af ID-attribut for Language-struktur (UUID). Beskrivelse af, at Stamkort hentes via Det Fælles Stamkort | Trifork | |
2018-09-19 | Rettet et forkert link til CreateTemporaryAddress request eksempel. | Trifork | |
2018-10-09 | Tilføjet og updateres create requests eksempler med id (Uuid) | Trifork | |
2018-10-11 | Præcisering omkring antal midlertidige adresser, så der altid kun er én | SDS | |
2018-11-29 | Tilrettet, således at fornavn og efternavn på pårørende er påkrævede. (Der er bestilt en ændring, således efternavn gøres optionelt) | SDS | |
2019-01-04 | Tilrettet således pårørendes telefonnummer, efternavn gøres optionel Slut-dato på midlertidig adresse gøres optionel | SDS | |
1.0.11 | 2019-08-02 | Opdateret beskrivelse af snitflade til 2019/08/01-snitfladen | Trifork |
1.0.17 | 2020-08-05 | Opdateret beskrivelse af snitflade til 2020/07/28-snitfladen | Kvalitetsit |
HL7 CDA
Modellen der anvendes til at repræsentere stamdata er HL7 CDA (se evt. http://www.hl7.org/implement/standards/product_brief.cfm?product_id=7), som er en XML-baseret standard til repræsentation af kliniske data. HL7 CDA er et begrebsapparat, som kan repræsentere en enorm mængde af forskelligartede data, hvoraf kun en lille delmængde anvendes i SKR. Det anbefales derfor at studere eksemplerne der refereres her på siden frem for modellen der defineres af HL7 CDA, da de giver et mere præcist billede af hvilke data der kræves og returneres af de forskellige operationer. CDA-terminologien gør, at man kan kvalificere de forskellige begreber gennem attributter (fx at en adresse er en hjemmeadresse ved at angive use="H"), og derfor sker der validering i SKR af, at disse attributter anvendes korrekt, så der ikke er tvivl om hvordan data skal fortolkes. Dvs. i praksis sker der en strengere validering end WSDL og XSDer dikterer.
...
Et stamkort repræsenteres som et "ClinicalDocument", som er grundpillen i CDA. Ifm. SKR er der lavet en extension til CDA, som gør det muligt at repræsentere pårørende, midlertidige adresser, sprog mv. som entry-typer i dokumentets "structuredBody". Nedenfor ses ClinicalDocument-strukturen som det benyttes i SKR:
Gliffy Diagram | ||||||
---|---|---|---|---|---|---|
|
Selve dokumentets "header" indeholder (udover personen der senest har opdateret stamkortet) de statiske data, som trækkes fra CPR-registeret, og ikke kan opdateres gennem SKRs operationer. De egentlige stamkort-data ligger under "StructuredBody", som indeholder en liste en "entry"-sektioner. Disse kan i SKR-sammenhæng have indhold af typen relatedPerson, temporaryAddress, language og languagehealthprovider. De to førstnævnte har sin egen id, som skal benyttes hvis man ønsker at slette eller opdatere entiteten via de relevante operationer. Hvis man fx ønsker at opdatere stamdata på en pårørende (RelatedPerson), så skal man bruge id'et man finder på vedkommende i "GetPersonalDataCard" til det request man sender til "UpdateRelatives"-operationen. Tilsvarende for midlertidige adresser.
...
Operation | Beskrivelse | ||
---|---|---|---|
GetPersonalDataCard_20192020_0807_0128 | Hent stamkort for en specifik borger.
| ||
UpdateContactInformation_20192020_0807_0128 | Opdater en borgers kontaktoplysninger | ||
CreateRelatives_20192020_0807_0128 | Opret en pårørende | ||
UpdateRelatives_20192020_0807_0128 | Opdater en pårørendes stamdata | ||
DeleteRelatives_20192020_0807_0128 | Slet en pårørende | ||
CreateTemporaryAddress_20192020_0807_0128 | Opret midlertidig adresse for den pågældende borger
| ||
UpdateTemporaryAddress_2020_07_28UpdateTemporaryAddress_2019_08_01 | Opdater midlertidig adresse | ||
DeleteTemporaryAddress_20192020_0807_0128 | Slet midlertidig adresse | ||
CreateLanguage_20192020_0807_0128 | Opret borgers sprog
| ||
UpdateLanguage_2020_07_28UpdateLanguage_2019_08_01 | Opdater borgers sprog | ||
DeleteLanguage_2019_08_01 | Slet borgers sprog | ||
CreateHealthProvider_2019_08_01 | Opret en tandlæge for den pågældende borger | ||
_2020_07_28 | Slet borgers sprog | ||
CreateHealthProvider_2020_07_28 | Opret en tandlæge for den pågældende borger
| ||
UpdateHealthProvider_2020_07_28UpdateHealthProvider_2019_08_01 | Opdater tandlæge | ||
DeleteHealthProvider_20192020_0807_0128 | Slet en tandlæge |
De enkelte operationer forklares i de følgende afsnit.
...
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
id | Som attribut "extension" angives personens CPR-nummer (uden bindestreg) | varchar(10) | Nej |
temporaryAddressId | ID (er) på den/de midlertidige adresser adresse der skal slettes. Hvert id skal matche id (UUID) på en temporaryAddress fra svaret på en GetPersonalDataCardskal slettes. | varchar(36) | Nej |
dataEnterer | Personen der sletter. Se tabel længere nede (delt struktur) | - | Nej |
...
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
id | Som attribut "extension" angives personens CPR-nummer (uden bindestreg) | varchar(10) | Nej |
language.id | ID (er) på det /de sprog der skal opdateres. Hvert id skal matche id (UUID) på et language fra svaret på en GetPersonalDataCard | varchar(36) | Nej |
language.languageCode | Sprogkode. Format: ISO-639-1 | char(2) | Nej |
dataEnterer | Personen der opdaterer. Se tabel længere nede (delt struktur) | - | Nej |
...
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
id | Som attribut "extension" angives personens CPR-nummer (uden bindestreg) | varchar(10) | Nej |
languageId | ID (er) på det /de sprog der skal slettes. Hvert id skal matche id (UUID) på et language fra svaret på en GetPersonalDataCard | varchar(36) | Nej |
dataEnterer | Personen der sletter. Se tabel længere nede (delt struktur) | - | Nej |
...
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
id | Som attribut "extension" angives personens CPR-nummer (uden bindestreg) | varchar(10) | Nej |
healthProvider.id | ID (er)på den tandlæge der skal opdateres . Id skal matche UUID på en tandlæge fra svaret på en GetPersonalDataCard | varchar(36) | Nej |
healthProvider.providerType | Som attribut "code" angives "tandlæge", som er den eneste værdi der understøttes i aktuelle version. | - | Nej |
healthProvide.organization | Tandlægeorganisation. Se tabel længere nede (delt struktur) | - | Nej |
dataEnterer | Personen der opdaterer. Se tabel længere nede (delt struktur) | - | Nej |
...
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
id | Som attribut "extension" angives personens CPR-nummer (uden bindestreg) | varchar(10) | Nej |
healthProvider.id | ID (er) på den tandlæge der skal slettes. Id skal matche UUID på en tandlæge fra svaret på en GetPersonalDataCard | varchar(36) | Nej |
dataEnterer | Personen der sletter. Se tabel længere nede (delt struktur) | - | Nej |
...