Page History
...
Kaldet til Kopiregisterservicen er formelt specificeret i WSDL’en stamdata_krs.wsdl, der kan rekvireres ved henvendelse til NSP-operatøren.
3.
...
2 Struktur af kald til RFS
Kopiregisterservicen tager følgende input:
...
Kaldet til Fleropslagsservicen er formelt specificeret i WSDL’en stamdata_rfs.wsdl, der kan rekvireres ved henvendelse til NSP-operatøren.
3.
...
3 Fejlsituationer
Hvis der er en fejl i forespørgslen, eller der opstår en fejl på serveren, vil servicen returnere en fejlmelding af typen ReplicationFault med en beskrivelse af fejlen (jævnfør WSDL som specificeret i ovenstående afsnit). Hvis forespørgslen går godt, returnerer servicen en besked af typen ReplicationResponse, der indeholder et ”any”-element. Dette any-element er af typen atom baseret på ATOM 1.0 [RFC4287]. ATOM er en syndikeringsprotokol og designet til at holde styr på ændringer i en ressource. I dette tilfælde er ressourcerne datatyperne i et register. Hvordan dette atom-element skal tolkes er forklaret nærmere i afsnit 3.6.
3.
...
4 Endpoint URL
Kopi register servicen er som udgangspunkt konfigureret på
...
<hostnavn>:8080/stamdata-batch-copy-ws-rfs/service/StamdataReplication-20240227?wsdl
3.
...
5.1 Eksempel på kald til KRS
Som klient sender man et ReplicationRequest til servicen.
...
</soapenv:Body>
</soapenv:Envelope>
3.
...
5.2 Eksempel på kald til RFS
Som klient sender man et ReplicationRequest til servicen.
...
Strukturen af faults er den samme som for KRS, og vil gerfor ikke blive gennemgået igen.
3.
...
5.3 Eksempel på svar ved brug af et filter til RFS
| <?xml version="1.0" encoding="UTF-8"?> <atom:feed xmlns:atom="http://www.w3.org/2005/Atom" xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns2="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns3="http://www.w3.org/2000/09/xmldsig#" xmlns:ns4="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns5="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns7="http://nsi.dk/2024/02/27/StamdataRfs/"> <atom:id>tag:nsi.dk,2011:cpr/person/v1</atom:id> <atom:updated>2024-04-23T12:55:05.129Z</atom:updated> <atom:title>Stamdata Registry Feed</atom:title> <atom:author> <atom:name>National Sundheds IT</atom:name> </atom:author> <atom:entry> <atom:id>tag:nsi.dk,2011:cpr/person/v1/17136504000000005006</atom:id> <atom:title/> <atom:updated>2024-04-20T22:00:00.000Z</atom:updated> <atom:content type="application/xml"> <person:person xmlns="http://nsi.dk/-/stamdata/3.0/cpr" xmlns:person="http://nsi.dk/-/stamdata/3.0/cpr"> <cpr>0102451234</cpr> <koen>M</koen> <fornavn>Peter</fornavn> <mellemnavn>Sigurd</mellemnavn> </person:person> </atom:content> </atom:entry> </atom:feed> |
|---|
3.
...
6 Detaljeret svar fra KRS
Her følger et mere detaljeret output fra KRS. Tolkning af dette er beskrevet i afsnittet efter.
...
</atom:entry>
</atom:feed>
3.
...
7 Parsing af output
Responset fra SKRS og SRFS består af et antal metadata-felter, som indeholder overordnet information om de data der er i responset, samt en række entry-elementer. Et entry-element beskriver hvordan et forretningsobjekt så ud i en bestemt periode, repræsenteret ved ValidFrom- og ValidTo-felterne. Med forretningsobjekt menes her en instans af en datatype. Et forretningsobjekt er f.eks. instansen af datatypen 'Person' i CPR-registret med cpr-nummer '0102451234'. Et forretningsobjekt beskrives således af et antal entry-elementer, ét for hver version.
Et udtræk indeholder den fulde historik for det register der forespørges på.
3.
...
7.1 Unikke nøgler
Hver datatype har en nøgle, som identificerer et forretningsobjekt. F.eks. identificeres et Person-objekt i CPR-registret ved sit CPR-nummer. Unikke nøgler for de enkelte datatyper er beskrevet i listen over registre i dokumentet "Registerspecifikation for Anvendere”.
3.
...
7.2 Revisionsnumre
Hvert entry-element indeholder et revisionsnummer, som unikt identificerer den version af forretningsobjektet, der ligger under content-elementet. Dette kan sammenlignes med en primærnøgle i en database, som identificerer en bestemt række.
...
<atom:id>tag:nsi.dk,2011:cpr/person/v1/13206597710000000085</atom:id>
3.
...
7.3 ValidFrom- og ValidTo-elementer
Et forretningsobjekt kan have flere versioner, hvilket er repræsenteret med elementerne ValidFrom og ValidTo. Et forretningsobjekt kan ikke have versioner med overlappende gyldighedsperioder, og der kan ikke være "huller" i historikken. Der gives ingen garanti for, hvor langt tilbage historikken rækker.
...
| Code Block | ||
|---|---|---|
| ||
<person>
<cpr>0102451234</cpr>
...
<efternavn>Jensen</efternavn>
...
<validFrom>2010-10-10T10:10:10+01:00</validFrom>
<validTo>2999-01-01T00:00:00+01:00</validTo>
</person> |
3.
...
7.4 DateTime
Data af typen DateTime i svaret fra SKRS vil som udgangspunkt være angivet i lokal tidszone, f.eks. '2018-07-11T08:16:47+02:00'. Der kan dog være tilfælde hvor der anvendes UTC, og anvendere skal derfor kunne håndtere begge datoformater.
3.
...
8 Paginering
Svaret fra SKRS kan maksimalt indeholde et fast antal entry-elementer, da det ikke er praktisk muligt at sende indholdet af et helt register på én gang. Størrelsen af responset kan styres med request-parameteren maxRecords. Servicen har dog en øvre grænse, som træder i kraft hvis parameteren er for stor.
...
Bemærk i øvrigt at der ikke kan anvendes paginering i SRFS.
3.
...
9 Opslagskolonner i SRFS
Dette afsnit beskriver hvilke opslagsmuligheder der tilbydes i SRFS.
...