ServicenDenne service giver mulighed for at hente komplette kopier af stamdata-registre. Dette giver anvendere mulighed for at ajourføre en lokal kopi af et stamdata-register. Adgangen er begrænset af den aftale der indgås med NSP-operatøren. RegisteroversigtHer følger en oversigt, der kort beskriver indhold for hvert enkelt register. Det skal bemærkes, at registernavn i nedenstående tabel skal tages bogstavligt, når der skabes et request mod servicen. Registernavn | Alias | Beskrivelse |
---|
autorisationsregisteret | Autorisationsregisteret | Indeholder informationer om hvilke sundhedsfaglige uddannelser en given person har gennemgået og er blevet autoriseret til af Sundhedsstyrelsen. Se også SAES - autorisations enkeltopslagsservice | bemyndigelsesservice | Bemyndigelsesregisteret | Indeholder informationer om delegerede rettigheder mellem personer til brug i sundheds IT-systemer. | cpr | CPR registeret | Indeholder informationer om borgere i Danmark, herunder navne, adresse, familerelationer og børn. | ddv | Det Danske Vaccinationsregister | Indeholder informationer om borgeres vaccinationer | dkma | Medicinpriser eller 'Taksten' | Indeholder informationer om godkendte lægemidler, herunder priser, indholdsstoffer, indikationer, opbevaringsbetingelser, tilskudsregler, ATC mm. | doseringsforslag | Doseringsforslag | Indeholder informationer om doseringsenheder og doseringsforslag der består af to relaterede datasæt: Doseringsenheder knytter en enhed til et lægemiddel; doseringsforslag knytter et antal forslag til doseringer til et lægemiddel. | sikrede | Sygesikringsregisteret | Indeholder sygesikringsinformationer om den enkelte borger herunder, hvilken yder gruppe 1 sikrede er tilknyttet (”egen læge” relationen). | sks | SKS-registeret eller Sundhedsvæsenets Klassifikationssystem | Indeholder klassifikationer af sundhedsvæsenets institutioner. | sor | Sundhedsvæsenets Organisationsregister | Indeholder detaljerede informationer om sundhedsvæsenets institutioner og personer med ydernummer. | tilskudsblanket | Tilskudsblanket | Indeholder et uddrag fra taksten, med informationer om, hvilke blanketter der bruges til hvilke tilskud. | vitamin | Stærke vitaminer | Indeholder information om det godkendte sortiment af lægemidler af typerne stærke vitamin- og mineralpræparater, naturlægemidler samt radioaktive lægemidler, med oplysninger om bl.a. lægemidlernes form, styrke, indholdsstoffer, administrationsveje m.m. Disse er udeladt i 'Taksten'. | yderregister | Yderregisteret | Indeholder detaljerede informationer om ydere og personer tilknyttet. |
Der findes en generet oversigt med alle udstillede registre og deres datatyper, som automatisk opdateres løbende. Denne oversigt er nyttig når en anvender skal opbygge et request mod SKRS idet der bl.a. skal angives en datatype og version for det data der ønskes leveret. Denne information indeholdes i nævnte oversigt. Adgang til servicenSKRS er tilgængelig på alle NSP installationer. Servicen er udstillet som en DGWS service. Alle kald til service logges. WhitelistingServicen er underlagt whitelistningbegrænsning. Denne whitelistning er baseret på CVR nummeret, der er indeholdt i anvendte id-kort kombineret med et registernavn, datatypenavn og version. Der skal anmodes om whitelistning hos NSP operatøren gennem en supporthenvendelse SikkerhedsniveauServicen kræver id-kort af niveau 3, dvs. id-kort udstillet med et VOCES eller FOCES certifikat. ReplikeringDer vil være en kort forsinkelse efter modtagelse af en ny udgave af register indtil ændringerne kan hentes ud via servicen. Grunden til dette er at data skal replikeres fra centralt ud til alle NSP installationer. Der er ikke nogen garanti for hvor aktuel datagrundlaget er. Test dataServicen er ligeledes installeret på de eksterne testmiljøer, hvor den er fungerende i testføderationen, men er underlagt samme adgangskrav som i produktion. Adgang til testmiljøer er beskrevet her. Servicens datagrundlag er baseret på data specifik generet til testmiljøerne. En beskrivelse af testdata findes her. Specielt kan alle personer på testmiljøet ses her (kræver login). ServicekaldHerunder er nævnt endpoint samt servicekald for SKRS. Bemærk at ID-kort og MedCom information er fjernet fra SOAP-eksempelerne i svar herunder samt SOAP-header indhold i svar for, at lette overblikket. EndpointsDer findes et enkelt endpoint til denne service: - http://[host]:[port]/stamdata-batch-copy-ws/service/StamdataReplication
Operation replicateDenne operation bruges til at sende replikerings-requestet til SKRS. Svaret er SOAP, hvor i der findes et ATOM-feed, som har det reele indhold der ønskes kopieret. De til enhver tid mulige felter i det reelle indhold er defineret ved en række XML-skemaer. Der kan angives en række værdier til parametre i requestet, som beskrevet i nedenstående tabel: Parameternavn | Beskrivelse |
---|
register | Registernavnet der ønskes udtræk fra, som bekrevet på tidligere nævnte oversigt | datatype | Datatypen som bekrevet på tidligere nævnte oversigt | version | Af hensyn til bagudkompabilitet versioneres udtræksfunktionaliteten for hvert enkelt register. Seneste tilgængelige version er bekrevet på tidligere nævnte oversigt | offset | En parameter, der angiver hvorfra i servicens udtræk af ændrede data svaret skal påbegyndes. Fra begyndelsen angives med '0' (nul). I hvert svar fra SKRS findes et revisionsnummer på en entitet, eksempelvis <atom:id>tag:nsi.dk,2011:cpr/person/v1/13667186340000000001</atom:id>, hvor sidste del, navnlig 13667186340000000001 angiver hvilket offset entiteten har. Denne værdi kan bruges som offset ifbm. paginering. | maxRecords | Bruges til at begrænse antallet af entitieter, som returneres i hvert svar. Der eksisterer en øvre grænse defineret af servicen, som ikke kan overstyres af anvendere. |
Et eksempel på en SOAP-besked i et kald til denne operation: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<Security xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<Timestamp xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<Created>2014-01-31T12:39:30+01:00</Created>
</Timestamp>
<saml:Assertion xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion" IssueInstant="2014-01-31T11:34:30Z" Version="2.0" id="IDCard">
...
...
</saml:Assertion>
</Security>
<Header xmlns="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd">
...
...
</Header>
</soapenv:Header>
<soapenv:Body>
<ns1:ReplicationRequest xmlns:ns1="http://nsi.dk/2011/10/21/StamdataKrs/">
<register>cpr</register>
<datatype>person</datatype>
<version>1</version>
<offset>0</offset>
<maxRecords>1</maxRecords>
</ns1:ReplicationRequest>
</soapenv:Body></soapenv:Envelope> |
Svaret fra dette kald: <?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Header>
...
...
</S:Header>
<S:Body>
<ns7:ReplicationResponse xmlns:ns2="http://www.w3.org/2000/09/xmldsig#" xmlns:ns3="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns4="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns5="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns6="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns7="http://nsi.dk/2011/10/21/StamdataKrs/">
<atom:feed xmlns:atom="http://www.w3.org/2005/Atom">
<atom:id>tag:nsi.dk,2011:cpr/person/v1</atom:id>
<atom:updated>2014-01-31T11:39:30.418Z</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/13667186340000000001</atom:id>
<atom:title />
<atom:updated>2013-04-23T12:03:54.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>0101010000</cpr>
<koen>K</koen>
<fornavn>Lene</fornavn>
<mellemnavn>Johansson</mellemnavn>
<efternavn>Sørensen</efternavn>
<coNavn />
<lokalitet />
<vejnavn>Weidekampsgade</vejnavn>
<bygningsnummer />
<husnummer>40A</husnummer>
<etage />
<sideDoerNummer />
<bynavn />
<postnummer>8860</postnummer>
<postdistrikt>Ulstrup</postdistrikt>
<status>01</status>
<gaeldendeCPR>0101010000</gaeldendeCPR>
<foedselsdato>1901-01-01</foedselsdato>
<stilling />
<vejKode>6564</vejKode>
<kommuneKode>661</kommuneKode>
<validFrom>2013-04-23T14:03:54.000+02:00</validFrom>
<validTo>2999-12-31T00:00:00.000+01:00</validTo>
</person:person>
</atom:content>
</atom:entry>
</atom:feed>
</ns7:ReplicationResponse>
</S:Body>
</S:Envelope> |
Eksempel kodeTilhørende eksempelkode kan findes på http://svn.nspop.dk/public/guides/latest, specielt under modulet skrs. Eksempelkoden indeholder 1 eksempel på kald af servicen: Metodenavn | Beskrivelse |
---|
personRequestExample | Svarer til eksempel i afsnit Operation replicate, dog med et større antal iterationer så der returneres information for 5 bogere istedet for 1, som vist i nærværende tekst. Eksempelkoden henter information om en borger fra CPR-registeret. |
Eksemplerne anvender følgende FOCES-certifikat: Keystorefil | CVR-RID |
---|
Statens_Serum_Institut_FOCES.jks | CVR:46837428-FID:92421325 |
CVR-nummer indeholdt i det benyttede certifikat er whitelistet på testmiljøer. Endvidere har dette CVR-nummer rettighed til at læse fra alle registre. |