Kopiregisterguide (fildownload)

Denne side beskriver hvordan en anvender kan etablere et kopiregister lokalt ved at hente totaldownload og herefter vedligeholde det ved at hente deltadownloads.

Se Eksempel på oprettelse samt vedligeholdelse af kopiregister for fildownload for et mere detaljeret eksempel på hvordan det kan ske.

Et kopiregister er en hel kopi eller en delmængde af et registers data. Der kan være flere årsager til at have et kopiregister, men en af årsagerne er, at data er tilgængeligt indenfor anvenderens egen virksomhed og mindsker egen afhængighed til opslag på Datafordeleren. Det er dog vigtigt at understrege at kopiregisteret skal opdateres løbende for at beholde sin værdi, såfremt aktuelle data er nødvendige i virksomhedens brugsscenarie.

Etablering af et kopiregister initieres ved først at hente et totaldownload af relevante entiteter fra Datafordeleren.

For at finde ud af, hvilke filer der er tilgængelige, benyttes GetAvailableFileDownloads-metoden. Dette gøres ved hjælp af følgende endpoint strukturering:

Ovenstående kald vil returnere følgende (forsimplet):

I ovenstående ses, at der både er et total- og deltautræk tilgængeligt. Når man vil etablere sit kopiregister, er det, som tidligere beskrevet, det samlede totaludtræk man er interesseret i.

I dette scenarie repræsenterer filen "DAR1AdresseTotalJSONBitemporal101.zip" det samlede totaludtræk. Man vil derfor benytte sig af GetFile-metoden, som eksemplificeret nedenfor, til at hente filen:

Man kan også hente det seneste totaludtræk via følgende metode:

 
Vedligeholdelse af kopiregisteret opnås ved brug af deltaudtræk, hvilket sikrer, at kopiregisteret kontinuerligt opdateres med de nyeste data. De tre efterfølgende filer " DAR1AdresseDeltaJSONBitemporal102.zip", "DAR1AdresseDeltaJSONBitemporal103.zip" og "DAR1AdresseDeltaJSONBitemporal104.zip" repræsenterer i dette eksempel hver især deres eget deltaudtræk, bestående af entiteterne tilsvarende det totaludtræk der tidligere var hentet. Hver fil indeholder ændringer siden det forrige deltaudtræk og har et unikt udtræksnummer (henholdsvis 102, 103 og 104, som vist i nedenstående figur, der fungerer til at identificere hver iteration og sikrer korrekt anvendelse af data.

Begrænsninger for slettet data

Mange entiteter er bitemporale, for disse så opdateres registrering- og virkning fra/til felten af registre for at markere data som inaktiv. For entiteter der ikke er bitemporale så slettes data i stedet. Datafordeleren udstiller ikke slettet data, hvilket inkluderer delta- og totaldownloads. For at opdatere et kopiregister med slettet data kan anvendere enten: 

• Hent et nyt totaldownload, der ikke indeholder slettet data.
  • Bemærk: Hvis et register kun har slettet data siden den sidste generation af et bitemporale totaldownload, så kan det nye fildownload indeholde slettet data. Risikoen at dette sker er dog meget lille. Aktuelle (current) og temporale fildownload kan aldrig indeholde slettet data.
• Brug hændelser for at finde ud hvis data er slettet. Se Eksempel på vedligeholdelse af kopiregister med hændelser for hvordan et kopiregister kan vedligeholdes med hændelser.

Se Typer af entitetsbaserede fildownload for de forskellige typer af fildownloads.