...

...

Kaldet til Fleropslagsservicen er formelt specificeret i WSDL’en stamdata_rfs.wsdl, der kan rekvireres ved henvendelse til NSP-operatøren.

...

<hostnavn>:8080/stamdata-batch-copy-ws-rfs/service/StamdataReplication?wsdl

Service til kald af rfs med som kan benyttet filter:
<hostnavn>:8080/stamdata-batch-copy-ws-rfs/service/StamdataReplication-20240227

og wsdl kan hentes ved at sætte ?wsdl efter, altså:

<hostnavn>:8080/stamdata-batch-copy-ws-rfs/service/StamdataReplication-20240227?wsdl

3.4.1     Eksempel på kald til KRS

...

Som klient sender man et ReplicationRequest til servicen.

Forespørgsel:

<?xml version="1.0" encoding="UTF-8"?>

...

    <ns1:ReplicationRequest xmlns:ns1="http://nsi.dk/2021/03/03/StamdataRfs/">
        <register>cpr</register>
       <datatype>person</datatype>
       <version>1</version>
       <registerVersion>1</registerVersion>
       <idList>
           <id>1112579876</id>
           <id>2211657418</id>
       </idList>
       <filter>filter 1</filter>
   </ns1:ReplicationRequest>

...

Headeren skal indeholde en DGWS 1.0.1 header.

Hvis filter er angivet vil response der blive filteret felter fra svaret. Hvis intet filter angivet svaret det samme som for KRS, og vil gerfor ikke blive gennemgået igen.

Strukturen af faults er den samme Strukturen af responses og faults er den samme som for KRS, og vil gerfor ikke blive gennemgået igen.

3

...

Her følger et mere detaljeret output fra KRS. Tolkning af dette er beskrevet i afsnittet efter.

...

.4.3     Eksempel på svar ved brug af et filter til RFS

...

...

...

...

...

3.5     Detaljeret svar fra KRS

Her følger et mere detaljeret output fra KRS. Tolkning af dette er beskrevet i afsnittet efter.

  <atom:feed xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://nsi.dk/-/stamdata/3.0/cpr">

    <atom:id>tag:nsi.dk,2011:cpr/person/v1</atom:id>

    <atom:updated>2011-11-07T09:56:12.278Z</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/13206597710000000085</atom:id>

      <atom:title/>

      <atom:updated>2011-11-07T09:56:11.000Z</atom:updated>

      <atom:content type="application/xml">

        <person>

          <cpr>0102451234</cpr>

          <koen>M</koen>

          <fornavn>Hans</fornavn>

          <mellemnavn/>

          <efternavn>Hansen</efternavn>

          <coNavn></coNavn>

          <lokalitet/>

          <vejnavn>Ligusterv&#xE6;nget</vejnavn>

          <bygningsnummer>42</bygningsnummer>

          <husnummer>123</husnummer>

          <etage>12</etage>

          <sideDoerNummer>th.</sideDoerNummer>

          <bynavn>Enby</bynavn>

          <postnummer>1448</postnummer>

          <postdistrikt>N&#xF8;ddebo</postdistrikt>

          <status>01</status>

          <gaeldendeCPR>3105459876</gaeldendeCPR>

          <foedselsdato>1947-12-24T00:00:00+01:00</foedselsdato>

          <stilling/>

          <vejKode>740</vejKode>

          <kommuneKode>314</kommuneKode>

          <validFrom>2011-11-07T10:56:21+01:00</validFrom>

          <validTo>2012-11-07T10:56:11+01:00</validTo>

        </person>

      </atom:content>

    </atom:entry>

  </atom:feed>

3.6     Parsing af output

    <atom:id>tag:nsi.dk,2011:cpr/person/v1</atom:id>

    <atom:updated>2011-11-07T09:56:12.278Z</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/13206597710000000085</atom:id>

      <atom:title/>

      <atom:updated>2011-11-07T09:56:11.000Z</atom:updated>

      <atom:content type="application/xml">

        <person>

          <cpr>0102451234</cpr>

          <koen>M</koen>

          <fornavn>Hans</fornavn>

          <mellemnavn/>

          <efternavn>Hansen</efternavn>

          <coNavn></coNavn>

          <lokalitet/>

          <vejnavn>Ligusterv&#xE6;nget</vejnavn>

          <bygningsnummer>42</bygningsnummer>

          <husnummer>123</husnummer>

          <etage>12</etage>

          <sideDoerNummer>th.</sideDoerNummer>

          <bynavn>Enby</bynavn>

          <postnummer>1448</postnummer>

          <postdistrikt>N&#xF8;ddebo</postdistrikt>

          <status>01</status>

          <gaeldendeCPR>3105459876</gaeldendeCPR>

          <foedselsdato>1947-12-24T00:00:00+01:00</foedselsdato>

          <stilling/>

          <vejKode>740</vejKode>

          <kommuneKode>314</kommuneKode>

          <validFrom>2011-11-07T10:56:21+01:00</validFrom>

          <validTo>2012-11-07T10:56:11+01:00</validTo>

        </person>

      </atom:content>

    </atom:entry>

  </atom:feed>

3.6     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.

...

I dette eksempel kaldes servicen med et CPR der ikke har værge og fældremålhar værge og fældremål

Request

Request i form af curl udtryk.

curl -H "Accept: application/json" http://stamdatahost/stamdata-personinformation/v1/person/2209632741/custody

Response

Der svares med HTTP statuskode 404. 

{ }

5.4.6 Eksempel 10: Navn hentes

I dette eksempel kaldes servicen med et CPR nummer der eksisterer, og personen har 3 navne (fornavn, mellem og efternavn).

Request

Request i form af curl udtryk.

curl -H "Accept: application/json" http://stamdatahost/stamdata-personinformation/v1/person/22096327412209632770/custodyname

Response

Der svares med HTTP statuskode 404200. 

{"givenName":"Helle","middleName":"Louise","familyName":"Eskesen","nameForAddressing":"Helle Eskesen"}

5.4.

...

7 Eksempel

...

7: Navn hentes på person der ikke findes

I dette eksempel kaldes servicen med et CPR nummer der eksisterer, og personen har 3 navne (fornavn, mellem og efternavn)IKKE eksisterer.

Request

Request i form af curl udtryk.

curl -H "Accept: application/json" http://stamdatahost/stamdata-personinformation/v1/person/22096327702209632771/name

Response

Der svares med HTTP statuskode 200.

{"givenName":"Helle","middleName":"Louise","familyName":"Eskesen","nameForAddressing":"Helle Eskesen"}

...

404. Bemærk at Content-Type headeren også er application/json når HTTP koden 404 skyldes at CPR nummeret ikke findes.

{ }

Eksempel 11: Find afdøde personer

I dette eksempel kaldes servicen med et CPR nummer der IKKE eksistereren liste af CPR numre og en dato. Servicen returnere en liste af person id'er fra input listen, som tilhører afdøde personer, som døde før tidspunktet i inputtet.

Request

Request i form af curl udtryk.

curl -H "Accept: application/json" http://stamdatahost/stamdata-personinformation/v1/person/2209632771/namedeceased?cpr=0304784567&cpr=1508902650&dato=2023-07-21T17:32:28

Response

Der svares med HTTP statuskode 404. Bemærk at Content-Type headeren også er application/json når HTTP koden 404 skyldes at CPR nummeret ikke findesHTTP statuskode 200.

{ }

Eksempel 11: Find afdøde personer

I dette eksempel kaldes servicen med en liste af CPR numre og en dato. Servicen returnere en liste af person id'er fra input listen, som tilhører afdøde personer, som døde før tidspunktet i inputtet.

Request

Request i form af curl udtryk.

curl -H "Accept: application/json" http://stamdatahost/stamdata-personinformation/v1/person/deceased?cpr=0304784567&cpr=1508902650&dato=2023-07-21T17:32:28

Response

Der svares med HTTP statuskode 200.

[{"cpr":"0304784567"},{"cpr":"1508902650"}]

6     Stamdata Filter Management Service (SFMS)

...

[{"cpr":"0304784567"},{"cpr":"1508902650"}]

6     Stamdata Filter Management Service (SFMS)

6.1    Struktur af kald til SFM

Opret et nyt filter tager følgende inputs:

Slet filter tager følgende inputs:

6.2    Fejlsituationer

Hvis der er en fejl i forespørgslen, eller der opstår en fejl på serveren, vil servicen returnere en fejlmelding af typen FilterFaultResponseType med en beskrivelse af fejlen. Hvis forespørgslen går godt, returnerer servicen en besked af typen FilterResponseType, der indeholder en ”status”-element med status "OK".

6.3    Endpoints eksempel

Forespørgsel på at lave et nyt filter:

...

Forespørgsel på at slette et filter:

...

...

...

...

...

...

...

...

Svar:

Fejl:

...

6.4    EndPoints

Der findes følgende endpoints:

• http://stamdatahost:8080/filter-management-ws-sfm/service/FilterManagement

...

[1]                                          Det er forventningen, at det er i nær fremtid bliver muligt at adgangsstyre på system-niveau.

...