Grunddata – eksempler på anvendelse af bitemporalitet

Formål med eksempler

Formålet med eksemplerne i nedenstående er at illustrere hvorledes bitemporalitet er tænkt i Grunddataprogrammet. Siden udstiller eksempler, der grafisk viser sammenhængen mellem registreringstid og virkningstid på et teoretiske niveau.

Eksemplerne er fiktive, og ikke udtryk for hvorledes Danmarks Adresseregister (DAR) er modelleret eller implementeret og de anførte eksempler stemmer derfor ikke overens med forretningsreglerne for Danmarks Adresseregister (DAR).

Ønsker du konkrete eksempler fra Danmarks Adresseregister (DAR) kan du tilgå dem på siden Datafordeleren - eksempel på anvendelse af bitemporalitet  eller i de registerspecifikke tjenestekataloger; Filudtræk (DAR)  og REST (DAR) .

Opbygning af eksempler

Virkningsperioder og registreringsperioder er i eksemplerne for overskueligheds skyld angivet som datoer. De registrerede informationer i de respektive registersystemers tabeller vil naturligvis være af typen ”timestamp” i overensstemmelse med Grunddataprogrammets modelregler, og som udstilles på Datafordeleren.

Eventuelle registreringer forud for den kontekst, som anvendes i eksemplerne er ikke medtaget.

Der er, ud over parametrene til dobbelthistorik, medtaget 2 yderligere elementer:

• Indhold, der med udgangspunkt i NavngivenVej, illustrerer de forretningsmæssige ændringer i eksemplerne.

• ID, der er et løbenummer, som er medtaget for at skabe en entydig sammenhæng mellem tabel og illustration. ID vil ikke fremgå af databasen.

I tabellerne er der anvendt følgende farver:

• Sort tekst betyder eksisterende information i registersystemet

• Rød tekst betyder ændringer til eksisterende information i registersystemet

• Blå tekst betyder nye informationer i registersystemet

 I figurer til illustration af de enkelte eksempler er anvendt to farver til illustration af dobbelthistorikken:

• Rød farve anvendes til at illustrere virkningstiden på en forekomst

• Blå farve anvendes til at illustrere registreringstider på samme forekomst

Teksten der ses over den røde linje, er forekomstens objektstatus i henhold objektets livscyklus.

Rettelse til samme virkningstid: I eksemplet registreres der den 27.01.2015 en rettelse af en stavefejl i vejnavnet med tilbagevirkende kraft fra 01.01.2015.

Ændring i status: I eksemplet registreres det den 16.02.2015 at den navngivne vej gøres gældende pr. 01.03.2015.

Ændring med ny virkningstid: I eksemplet registreres det den 17.12.2017 at den navngivne vej skiftede navn pr. 15.12.2017.

Sletning ved statusskifte: I eksemplet registreres det den 16.05.2018 at den navngivne vej nedlægges pr. 20.05.2018.

Genaktivering ved statusskifte: I eksemplet registreres det den 05.06.2019, at den nedlagte navngivne vej skal genaktiveres pr. 01.07.2019.

Fortryd nedlæggelse: I eksemplet registreres det den 05.06.2019, at nedlæggelsen af den navngivne vej skal fortrydes.

Sletning (ikke ved statusskifte): I eksemplet registreres det den 23.08.2020, at den navngivne vej skal slettes pr. 01.09.2020.

Tilføjelse af historik: I eksemplet registreres det den 13.04.2022, at den navngivne vej havde et andet navn i perioden 11.11.2017 – 03.03.2018.

Samlet eksempel: I dette afsnit vises et total-billede af forekomsterne i registersystem, for de ovenstående eksempler, hvis de alle foretages på det samme forretningsobjekt, i den rækkefølge ovenstående eksempler er beskrevet fra oprettelse via forandringer til sletning.

Hvis eksemplet ordnes efter de forekomster, der er gældende ved afslutningstidspunktet for eksemplet, 13.04.2022, ser det således ud:

Eksempel med flere samtidige versioner

Dette afsnit beskriver startpunktet for de efterfølgende eksempler med flere samtidige versioner. Der indgår ikke flere samtidige versioner i startpunktet.

Udgangspunktet er en Navngiven vej, der har gennemløbet følgende forløb:

• Registreringstid 1, 18.12.2014: Oprettet som foreløbig med virkning fra 01.01.2015
• Registreringstid 2, 27.01.2015: Rettelse af stavefejl, uændret virkningstid
• Registreringstid 3, 16.02.2015: Navngiven vej gøres gældende med virkning fra 01.03.2015

Illustreret giver dette følgende registreringer:

Ny samtidig version oprettes: I eksemplet registreres det den 23.12.2017, at der oprettes en ny version af den Navngivne vej som foreløbig pr. 01.12.2017.

Ny version gøres gældende og gammel version udgår: I eksemplet registreres det den 05.02.2018, at den nye foreløbige version skal gøres gældende pr. 01.12.2017.

Eksempel med flere objekter

I nedenstående eksempel er dataeksemplet udvidet således, at der er flere sæt registreringstid og virkningstid, der skal tages i betragtning for at finde de ønskede data. Eksemplet er forholdsvist simpelt, hvor der skal kombineres data for Vej og Postnummer. 

Vej

Postnummer

Ønsker man at kombinere ovenstående data, dvs. at man gerne vil have vejnavn + postnummer, er det vigtigt at være helt præcis med angivelse af de bitemporale attributter.

Eksempel for Virkningstid alene, dvs. uden angivelse af registreringstid: Her antager vi, at registreringstid skal være dags dato, samt at det kun er Gældende objekter, vi er interesseret i.

Virkningstid = 01-02-2018, udvælges ID= 7 fra Vej og ID=3 fra Postnummer og det datamæssige resultat bliver:

Rustvej, 1234 København V

Virkningstid = 20-11-2017, udvælges ID= 6 fra Vej og ID=3 fra Postnummer og det datamæssige resultat bliver:

Københavnvej, 1234 København V

Eksempel hvor Registreringstid også anvendes, kombineret med Virkningstid, og stadig kun Gældende objekter.

Inkluderes Registreringstid således at Virkningstid = 20-11-2017 og Registreringstid = 01-02-2018, udvælges ID = 4 fra Vej og ID = 2 fra Postnummer og det datamæssige resultat bliver:

Københavnsvej, 1235 København V

Ændres tider således at Virkningstid = 20-11-2017 og Registreringstid = 05-02-2018, udvælges ID = 6 fra Vej og ID = 2 fra Postnummer og det datamæssige resultat bliver:

Københavnvej, 1235 København V