Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Display Metadata | ||
---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Siden beskriver registerspecifikke forhold af implementeringsnær karakter, som anvendere skal være opmærksom på ved anvendelse af tjenester og data for Danmarks Adresseregister (DAR)
Læs mere om bitemporalitet og start på siden Datafordeleren - introduktion til bitemporalitet.
Find eksempler på bitemporalitet i DAR data på siderne Datafordeleren - eks. på anvendelse af bitemporalitetog Grunddata – eksempel på anvendelse af bitemporalitet.
Table of Contents |
---|
Generelle forhold i DAR for tjenester
Adresseregisterets (DAR) tjenester på Datafordeleren har disse temporale søgemuligheder:
Søgeparameter: tidsperiode
Dvs. søgning med kombinationer af parametrene:
- RegistreringstidFraRegistreringFra
- RegistreringstidTilRegistreringTil
- VirkningstidFraVirkningFra
- VirkningTilVirkningstidTil
I DAR har disse parametre defaultværdien tidspunktet for eksekveringstidspunktet for søgningen (dvs. tjenesten returnerer objekter, der er registrerede og gældende på tidspunktet, hvor søgningen foregår).
Søgeparameter: status
Udfaldsrummet for parameteren Status i DAR er:
1: Intern forberedelse
2: Foreløbig
3: Gældende
4: Nedlagt
5: Henlagt
6: Slettet
7: Ikke i brug
8: I brug
9: Udgået
Hvis en DAR REST service både skal vise historisk og aktuelt data, kan VirkningFra eller RegistreringFra benyttes. De to parametre må ikke benyttes samtidigt. Hvis et af parametrene anvendes fås alle hhv. virknings- eller registreringsversioner af objektet.
VirkningTil kan bruges i kombination med VirkningFra, hvis virkningshistorikken for et bestemt tidsrum skal findes.
RegistreringTil kan bruges i kombination med RegistreringFra, hvis registreringshistorikken for et bestemt tidsrum skal findes.
Søgeparameter: status
Udfaldsrummet finder du Udfaldsrummet kan også findes på: http://danmarksadresser.dk/livscyklus.
Specifikke detaljer for DARs tjenester og data
Formålet med dette dokument er at samle dokumentation om anvendelsen af bitemporalitet i DAR. Dokumentet er en besvarelse af den opgavebeskrivelse, som Digitaliseringsstyrelsen har udarbejdet [BITEMP]. De følgende afsnit vil besvare de punkter, som er listet i opgavebeskrivelsen. For hvert spørgsmål skrives et kort, overordnet svar, og der henvises til eksisterende dokumentation for yderligere uddybning. I tilfælde af at et spørgsmål ikke er belyst i eksisterende dokumentation, skrives et mere uddybende svar i dette dokument.
Det antages at læseren har et grundlæggende kendskab til DAR’s domænemodel og bitemporalitet generelt. Læs mere på http://grunddatamodel.datafordeler.dk/.
Historik og bitemporalitet
Der skelnes i dette afsnit mellem konverterede data og post-go-live data. Konverterede data er data som er konverteret/importeret inden go-live, og post-go-live data er de data som er opstået efter go-live, f.eks. ved registrering gennem DAR’s brugergrænseflade, ved hændelsesprocessering og lignende.For konverterede data er præcisionen af virkningstid som den var i kildedata fra DAR 0.9 – hvilket er en præcision på ned til millisekund – og SDFE NyeData (objekter: NavngivenVej og NavngivenVejKommunedel) – hvilket er en præcision på ned til minut.
Præcisering af angivelsen af virkningstid
Rent teknisk opererer DAR med en præcision på mikrosekunder, også for data før go07-05-live2018, som blot har 0’er for disses decimaler under deres tidligere præcision og ned til mikrosekunder.
Opsummeret:
- Konverteret:
NavngivenVej og NavngivenVejKommunedel: Minut præcision
Andre objekter: Millisekund præcision
Post-go-live:Alle objekter: Mikrosekund præcision
Virkningstidshistorik for forretningsobjekterne
DAR data er dannet ud fra data fra BBR, DAGI samt data sammenstillet ud fra CPR-vejregister med GeoDanmarkdata. Virkningstidshistorik for forretningsobjekter afhænger derfor af om hvilke objekter man kigger på data fra Nye Data-projektet (NavngivenVej, NavngivenVejKommunedel & Adressepunkter af typen ”vejpunkt”, også kaldet Vejpunkter) eller data fra DAR 0.9 (resterende objekter).
For data fra DAR 0.9 BBR er den tidligste registrerede VirkningFra-dato den 5. februar 2000 – bortset fra Adgangspunkter som først blev oprettet ved udgangen af 2006. Langt hovedparten af danske adresser har VirkningFra på denne dato, og det er derfor rimeligt at antage at datoen er en konverteringsdato for BBR (som DAR var en underdel af på daværende tidspunkt) eller lignende. Virkningstidshistorikken for DAR 0.9 fra denne dag og fremefter må derfor antages at være retvisende, med det forbehold at data har været gennem flere konverteringer siden data., man skal dog være opmærksom på data der vedrører kommune og kommunekode-vejkode som udgangspunkt er retvisende fra 01-01-2007. Husnummerets (adgangsadressens) relation til BBR-objekt har retvisende virkningshistorik fra 04-07-2018.
For data For data fra Nye Data-projektet er virkningstidshistorikken baseret på bl.a. CPR Vej. Bl.a. har 88% af alle veje Vejregister, er angivet 1. januar 1900 som tidligste VirkningFra. Historikken herfra kan derfor antages ikke at være retvisende og at der kun kan regnes med vejes navngivenvejes historisk fra DAR 1.0’s idriftsættelsestidspunkt 07-05-2018 og fremadrettet.
Opsummeret:
NavngivenVej, NavngivenVejKommunedel og Vejpunkter har retvisende virkningshistorik fra 2018-05-07
Adressepunkter har retvisende virkningshistorik fra 2007-01-01
For adgangspunkter er tidligste VirkningFra 04-07-1996, disse data er dog først retvisende fra 01-01-2007
For vejpunkter er tidligste VirkningFra 01-01-2007, disse data er dog først retvisende fra 07-05-2018Resterende objekter har retvisende historik fra 2000-02-05
Historik for registreret data i registret
DAR har registrerede data fra konverteringstidspunktet for DAR 1.0 og fremefter. Dette betyder at alle konverterede data har RegistreringFra ’2018-05-03 16:58:34.000000’ (UTC), og at dette er det tidligste registreringstidspunkt i systemet.
Forhold for fastholdelsen af bitemporal information for historiske data før grunddatamodellen blev indført
DAR har kun virkningshistorik inden skiftet til Grunddatamodellen, og dermed ingen tidligere registreringshistorik.
Oprindelsestidspunkt
Ved brug af data fra Danmarks Adresseregister (DAR) skal vil registrerings- og virkningstid ikke gå længere tilbage end 2018-05-06T00:00:00.000000+02:00.
På dette tidspunkt er registret implementeret som grunddata på Datafordeleren.
Vælges en tidligere registrerings- og virkningstid kan der være manglende eller ufuldstændige data.
Modelregler
Beskrivelse af implementering af modelreglerne for bitemporalitet herunder eventuelle afvigelser
DAR følger grunddatareglerne for virknings- og registreringstid.
DAR videregiver den fulde historik for begge tidsdomæner siden DAR 1.0’s idriftsættelse (07-05-2018). Her henvises til Livscyklus på Danmarksadresser.dk, for beskrivelse af de mulige livscyklus-værdier samt skift imellem dem.
Statusværdier og livscyklus
Beskrivelse af værdier for status
DAR anvender ikke samtidigt virkende objektforekomster.
Statusværdier og relationer
Beskrivelse af statusværdier der er meningsfyldte at betragte ved relationer mellem forretningsobjekter internt i et register og på tværs af registre
DAR har ikke samtidigt virkende objektforekomster, og derfor kan der ikke eksistere samtidigt virkende statusværdier. Generelt er kun ”meningsfulde” sammenhænge tilladt – f.eks. kan der ikke være en gældende Adresse under et foreløbigt Husnummer.
Som for interne relationer i registret, så er ”meningsløse” sammenhænge ikke tilladt at oprette i DAR, f.eks. gældende Husnummer der sættes til at referere til nedlagt GeoDK Bygning – disse vil dog godt kunne forekomme i historisk data eller når BBR endnu ikke har modtaget og behandlet hændelser om ændringer i andre registre.
- Bygnings- og Boligregistret (BBR)
DAR vedligeholder en relation fra Husnummer til Bygning og TekniskAnlæg i BBR. Der kan refereres til BBR-objekter med følgende status-værdier: Opført, MidlertidigAfsluttet, DelvistAfsluttet, UnderOpførsel, Projekteret
- .
- Danmarks Administrative Geografiske Inddeling (DAGI)
DAR vedligeholder relationer fra Husnummer til DAGI-inddelingerne Afstemningsområde, Kommuneinddeling, Menighedsrådsafstemningsområde, Postnummer, Sogneinddeling og SupplerendeBynavn. DAR vedligeholder desuden relationer fra NavngivenVej til DAGI-
- inddelingerne Kommuneinddeling, Postnummer og SupplerendeBynavn.
Offentlige DAGI objekter har altid status ”vedtaget” og kan relateres til af DAR objekter uanset status.
- GeoDanmark Vektor
DAR vedligeholder relationer fra
- hhv. Husnummer og Navngivenvej til GeoDanmark-objekterne Bygning og Vejmidte.
- GeoDanmark Vektor Bygninger og Vejmidter har altid status ”registreret” og kan relateres til af DAR objekter uanset status.
- Matriklen (MAT)
DAR vedligeholder relationer fra Husnummer til
- MAT Jordstykke.
Følgende er de mulige
- MAT Jordstykke statusser per DAR Husnummer status. Der er mange kombinationer der kan finde sted, da data opdateres asynkront og
- f.eks. et nedlagt
- MAT Jordstykke først på et senere tidspunkt har effekt på DAR Husnumre, når hændelsen om denne nedlæggelse modtages og behandles.
Appendix: Statusværdier på tværs af DAR objekter
Tabellerne i de følgende afsnit er derfor konstrueret ved at se på hvilke sammenhænge der fandtes i en kopi af DAR’s produktionsdatabase fra 3. juli 2018.Husnummer | Jordstykke |
Foreløbig | Gældende / Foreløbig / Historisk / Ikke Gennemført |
Gældende | Gældende / Foreløbig / Historisk / Ikke Gennemført |
Nedlagt | Gældende / Foreløbig / Historisk / Ikke Gennemført |
Henlagt | Gældende / Foreløbig / Historisk / Ikke Gennemført |
Adresse-Husnummer
Adresse status
Husnummer status
Antal forekomster
Foreløbig
Foreløbig
12971
Foreløbig
Gældende
3739
Gældende
Gældende
3668623
Gældende
Nedlagt
13
Nedlagt
Gældende
42503
Nedlagt
Nedlagt
48469
Henlagt
Foreløbig
279
Henlagt
Gældende
1559
Henlagt
Nedlagt
88
Henlagt
Henlagt
5802
Husnummer-Adressepunkt
Husnummer status
Adgangspunkt status
Antal forekomster
Foreløbig
Ikke i brug
3671
Foreløbig
I brug
45
Gældende
I brug
2482092
Nedlagt
Slettet
45104
Nedlagt
I brug
399
Nedlagt
Udgået
679
Henlagt
Ikke i brug
20
Henlagt
1
Henlagt
Udgået
7302
Husnummer-Vejpunkt
Husnummer status
Vejpunkt status
Antal forekomster
Foreløbig
Ikke i brug
1133
Foreløbig
I brug
2583
Gældende
I brug
2482092
Nedlagt
I brug
45503
Nedlagt
Udgået
679
Henlagt
I brug
7382
Husnummer-NavngivenVej
Husnummer status
NavngivenVej status
Antal forekomster
Foreløbig
Foreløbig
42
Foreløbig
Gældende
3665
Gældende
Gældende
2482072
Nedlagt
Gældende
41309
Nedlagt
Nedlagt
42
Henlagt
Foreløbig
3
Henlagt
Gældende
6998
Henlagt
Henlagt
17
Husnummer-NavngivenVejKommunedel
Husnummer status
NavngivenVejKommunedel status
Antal forekomster
Foreløbig
Gældende
3708
Gældende
Gældende
2482072
Nedlagt
Gældende
41309
Nedlagt
Nedlagt
42
Henlagt
Gældende
7005
Henlagt
Nedlagt
13
NavngivenVejKommunedel-NavngivenVej
NavngivenVejKommunedel status
NavngivenVej status
Antal forekomster
Gældende
Foreløbig
30
Gældende
Gældende
110914
Nedlagt
Foreløbig
1
Nedlagt
Gældende
2
Nedlagt
Nedlagt
17
Nedlagt
Henlagt
12
Tilgængelige søgeparametre i DARs tjenester
Metode | Tjeneste-type | TIL-FRA (søgning med periode) | Tidspunkt (søgning med tidspunkt) | Status |
adresse | REST |
RegistreringFra = NOW() |
RegistreringTil = NOW() |
VirkningFra = NOW() |
VirkningTil = NOW() | status=NULL | |
husnummer | REST |
RegistreringFra = NOW() |
RegistreringTil = NOW() |
VirkningFra = NOW() |
VirkningTil = NOW() | status=NULL | |
navngivenvejkommunedel | REST |
RegistreringFra = NOW() |
RegistreringTil = NOW() |
VirkningFra = NOW() |
VirkningTil = NOW() | status=NULL | |
navngivenvej | REST |
RegistreringFra = NOW() |
RegistreringTil = NOW() |
VirkningFra = NOW() |
VirkningTil = NOW() |
status=NULL | |
supplerendebynavn | REST |
RegistreringFra = NOW() |
RegistreringTil = NOW() |
VirkningFra = NOW() |
VirkningTil = NOW() | status=NULL | |
postnummer | REST |
RegistreringFra = NOW() |
RegistreringTil = NOW() |
VirkningFra = NOW() |
VirkningTil = NOW() | status=NULL | |||
husnummerTilJordstykke | REST | Ingen temporale søgeparametre | ||
husnummerTilAdresse | REST | Ingen temporale søgeparametre | ||
adresseTilHusnummer | REST | Ingen temporale søgeparametre | ||
DAR-Totaludtraek | Filudtræk |
RegistreringFra = NOW() |
RegistreringTil = NOW() |
VirkningFra = NOW() |
VirkningTil = NOW() | status=NULL |