Page History
Navitabs | ||||||
---|---|---|---|---|---|---|
| ||||||
Denne "Kom Godt i Gang Guide" omhandler SKRS (Stamdata Kopi Register Service). Guiden er beregnet til it-faglige personer som skal til eller er i gang med at udvikle systemer, der skal integrere med SKRS på platformen. Det anbefales at Platformsintroduktion læses inden denne guide.
Numbered Headings | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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. Neden for anførte datasamlinger/registre er derfor ikke tilgængelige for alle. Se liste over hvad der er tilgængeligt her: NSP services#Datasamlinger 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 bogstaveligt, når der skabes et request mod servicen.
Der findes en genereret 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 servicen 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 et register, indtil ændringerne kan hentes ud via servicen. Grunden til dette er at data skal replikeres ud til alle NSP-installationer fra centralt hold. Der er ikke nogen garanti for hvor aktuelt 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 og adgang til testdata findes her. ServicekaldHerunder er nævnt endpoint samt servicekald for SKRS. Bemærk at ID-kort og MedCom-information er fjernet fra SOAP-eksemplerne i svar herunder samt SOAP-header indhold, for at lette overblikket. EndpointsDer findes et enkelt endpoint til denne service:
Operation replicateDenne operation bruges til at sende replikerings-requestet til SKRS. Svaret er SOAP, hvori der findes et ATOM-feed, som har det reelle 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:
Et eksempel på en SOAP-besked i et kald til denne operation:
Svaret fra dette kald:
BemærkningerServicen vedligeholder historik på entiteter. I det ovenstående eksempel-svar findes felterne Eksempel kodeTilhørende eksempelkode kan findes på http://svn.nspop.dk/public/guides/latest, specielt under modulet skrs. Eksempelkoden indeholder et eksempel på kald af servicen:
Eksemplerne anvender følgende FOCES-certifikat:
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. |