Etablering af adressekopiregister

Introduktion

DAWA udstiller adresser, adgangsadresse, vejstykker, postnumre og ejerlav i et format, som er velegnet til etablering og vedligehold af en lokal kopi af Danmarks adresser.

I DAWA tilknyttes alle ændringer af adresser et unikt, fortløbende sekvensnummer. Et sekvensnummer svarer dermed til en unik hændelse (oprettelse, ændring eller nedlæggelse) på et objekt.

Når et klientsystem skal vedligeholde et kopiregister anvendes sekvensnummeret til at holde styr på hvilke adresseændringer klientsystemet har udført i den lokale kopi og hvilke ændringer klientsystemet mangler at udføre.

API'erne til replikering udstiller normaliserede adresser. Hvis kopien gemmes i en SQL database vil det være hensigtsmæssigt at have én tabel til hver type.

Udtræk leveres i JSON eller i det kompakte CSV-format (se dataformater). Hændelserne leveres i JSON format.

Etablering af lokalt kopiregister

Fremgangsmåden for etablering af lokalt kopiregister er som følgende:

• Klienten henter det aktuelle sekvensnummer:

  GET /replikering/senestesekvensnummer

• Klienten henter dataudtræk for sekvensnummeret:

  GET /replikering/postnumre?sekvensnummer=990

  GET /replikering/vejstykker?sekvensnummer=990

  GET /replikering/adgangsadresser?sekvensnummer=990

  GET /replikering/adresser?sekvensnummer=990

  GET /replikering/ejerlav?sekvensnummer=990

• Klienten indlæser data i databasen, og har nu etableret et lokalt kopiregister.

For efterfølgende at kunnd indlæse opdateringer skal sekvensnummeret for udtrækket også gemmes i databasen.

Vedligeholdelse af lokalt kopiregister

Fremgangsmåden for vedligeholdelse af lokalt kopiregister er som følgende:

• Klienten undersøger, om der er sket ændringer ved at polle seneste sekvensnummer:

  GET /replikering/senestesekvensnummer

• Hvis klienten konstanterer, at der er sket adresseændringer hentes hændelserne:

  GET /replikering/postnumre/haendelser?sekvensnummerfra=990&sekvensnummertil=1000

  GET /replikering/vejstykker/haendelser?sekvensnummerfra=990&sekvensnummertil=1000

  GET /replikering/adgangsadresser/haendelser?sekvensnummerfra=990&sekvensnummertil=1000

  GET /replikering/adresser/haendelser?sekvensnummerfra=990&sekvensnummertil=1000

  GET /replikering/ejerlav/haendelser?sekvensnummerfra=990&sekvensnummertil=1000

• Klienten opdaterer den lokale kopi på baggrund af hændelserne. Anvendes der en SQL-database hvor der anvendes en tabel pr. datatype vil hver hændelse resultere i ét INSERT, UPDATE eller DELETE statement.
• Med jævne mellemrum (f.eks. dagligt eller ugentligt) bør klienten hente nye udtræk og verificere, at den lokale kopi er opdateret korrekt.

DAWA garanterer ikke referentiel integritet. F.eks. er det muligt at der kan være oprettet adresser med en vejkode og kommunekode, som endnu ikke refererer til et vejstykke. Klientsystemet bør håndtere dette.

Hændelser udstilles i nær realtid. Kildesystemet der ligger til grund for hændelserne er Danmarks Adresseregister (DAR). Klientsystemer skal være opmærksom på, at adressers postnumre og supplerende bynavne p.t. kun opdateres en gang i døgnet.

Hvis man ønsker at vedligeholde en lokal kopi af en delmængde af adresserne (f.eks. en kommune) skal man være opmærksom på, at det er noget mere kompliceret at vedligeholde en lokal kopi, da det i princippet er muligt for en adresse at flytte fra en kommune til en anden. Hvis der anvendes en SQL-database kan det overvejes at replikere alle adresserne og anvende et View, som evt. kan være et Materialized View.