Page History
...
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.
...
Responset fra SKRS 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.
...
F.eks. for datatypen Person, hvis forretningsobjekter identificeres af CPR-numre, kan en ændring af efternavn resultete resultere i følgende versioner:
Code Block | ||
---|---|---|
| ||
<person> <cpr>0102451234</cpr> ... <efternavn>Hansen</efternavn> ... <validFrom>2000-01-01T01:01:01+01:00</validFrom> <validTo>2010-10-10T10:10:10+01:00</validTo> </person> |
...
3.7 Paginering
Svaret fra SKRS indeholder kan maksimalt indeholde et bestemt 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 man styr styres med request-parameteren maxRecords, . Servicen har dog har servicen en øvre grænse, som træder i kraft hvis parameteren er for stor.
...
Man angiver hvilken side man er interesseret i ved at udfylde offset-parameteren i requestet, som er et revisionsnummer (se afsnit 3.6.2). For at lave et fuldt udtræk sender man således først et request med offset 0, derefter ned med det sidste revisionsnummer man modtog i responset, og så fremdeles. På et tidspunkt vil svaret være tomt, og man er således færdig med at hente data.
...