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 |
1.0.18 | 2021-04-27 | Ny migreringssnitflade | Kvalitetsit |
1.0.19 | 2021-06-08 | navne skift i snitflade fra fsk til skr | Kvalitetsit |
1.0.21 | 2021-09-02 | Præcisering af URL til wsproxy | KvalitetsIT |
1.0.22 | 2021-11-02 | Præcisering af snitflader | KvalitetsIT |
Indhold
Table of Contents |
---|
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.
...
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
Notificeringer i NAS
I forbindelse med skriveoperationer i SKR (oprettelse, opdateringer og sletninger) sker der en notificering via NAS. Se evt. NAS 2.0 Anvenderguide.
De enkelte notificeringer indholder ikke detaljer vedr. opdateringen eller stamkortet, men udelukkende oplysninger om det cprnummer, for hvilket opdateringen har fundet sted. Det er efterfølgende op til anvenderen at hente det opdaterede stamkort ud via snitfladerne.
Følgende er et eksempel på en opdateringsnotificering:
Code Block | ||||
---|---|---|---|---|
| ||||
<ns3:Notify xmlns:ns2="http://www.w3.org/2005/08/addressing" xmlns:ns3="http://docs.oasis-open.org/wsn/b-2" xmlns:ns4="http://docs.oasis-open.org/wsn/t-1" xmlns:ns5="http://docs.oasis-open.org/wsrf/bf-2" xmlns:ns6="http://nsi.dk/advis/v10" xmlns:ns8="http://sundhedsdatastyrelsen.dk/skr/2021/06/02"> <ns3:NotificationMessage> <ns3:Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">SKR-TOPIC</ns3:Topic> <ns3:Message> <ns6:NotifyContent id="0309691444" idType="http://nsi.dk/advis/v10/CPR"> <ns8:DataCardUpdated> <date value="2021-12-22"/> <id value="0309691444"/> <messageId value="AAABfeIdUdOcGhp3cE/gtlNPU0k="/> <type value="http://sundhedsdatastyrelsen.dk/MessageDefinition/PDC-notification"/> <version value="1"/> </ns8:DataCardUpdated> </ns6:NotifyContent> </ns3:Message> </ns3:NotificationMessage> </ns3:Notify> |
Topic der anvendes: http://sundhedsdatastyrelsen.dk/PersonalDataCard/2020/11/01:DataCardUpdated
Snitflader
Til SKR er der 2 hold gældende snitflader. Et hold til normalt brug og et til migreringsbrug.
...
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
time | Tidspunkt for opdatering. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200 | varchar(19) | Nej |
assignedAuthor.id | En eller flere forekomster med værdi i attribut "extension" og type (fx CPR/AUTORISATION/UDDANNELSESKODE) i attribut "assigningAuthorityName". Ved responses forekommer kun ét element, hvor assigningAuthorityName="CPR" og extension="ANONYM" for at skjule følsomme oplysninger om eksempelvis sundhedsfaglige. | extension varchar(10), assigningAuthorityName varchar(30) | Nej |
assignedAuthor.assigningPerson.name.given | For- og mellemnavn på person bag opdatering | varchar(80) | Nej |
assignedAuthor.assigningPerson.name.family | Efternavn på person bag opdatering | varchar(80) | Nej |
assignedAuthor.representedOrganization.id | Organisations id, såfremt der er tale om en sundhedsperson. Værdi findes i attribut "extension", type i attribut "assigningAuthorityName" | extension varchar(80), assigningAuthorityName varchar(30) | Ja |
assignedAuthor.representedOrganization.name | Organisations navn | varchar(30) | Ja |
Savedatacardsnitflade
Denne snitflade muliggør at data kan opdateres asynkront på baggrund af et systemkald. Snitfladen understøtter niveau 3 ID-kort, via OCES funktionscertifikater (FOCES), og ikke niveau 4 ID-kort.
Snitfladen udstiller en enkelt operation, der tillader at enten oprettes borgerens stamdata, stamdata redigeres eller stamdata slettes. Det er ikke muligt at læse via denne snitflade, dertil skal eksisterende snitflader benyttes.
Migreringssnitflade
Der er lavet en midlertidig migregingsnitflade der kan benyttes til migrerering af lokale stamkort.
...