Indledning

Denne side forklarer med eksempler hvilke hændelser der udsendes af MAT.

Overordnet findes tre typer af hændelsestriggers - Create, Update, Delete - som beskrevet på siden Hændelser (MAT) samt den generelle dokumentation af hændelser på siden Hændelser på Datafordeleren.

Eksempelvis:

  • BygningPaaFremmedGrundPunkt Create
  • Ejerlejlighed Update
  • Jordstykke Delete

Når opdateringsdata overføres fra Matriklen til Datafordeleren påhæftes hver enkelt forekomst en hændelsestrigger – en af ovenstående tre typer eller ”No Event”.

Hændelser udsendes generelt pr. objekt forekomst og ikke pr. række, der opdateres.

Matriklen genererer pt. hændelser for følgende objekttyper:

  • MatrikulærSag
  • SamletFastEjendom
  • Jordstykke*
  • Ejerlejlighed
  • BygningPaaFremmedGrundPunkt
  • Matrikelskel

* Bemærk, at objekttypen Jordstykke ikke indeholder geometri - det registreres på Lodflade. Oftest vil en opdatering af et jordstykkes lodflade også resultere i opdatering af jordstykket - og dermed resultere i en hændelse, men ikke altid)

Hændelser fra Matriklen er generelt ikke egnet til at holde et kopi-datasæt ajourført. Her henvises til Datafordeleren - guide til kopiregistre.








Generelle regler for generering af hændelser

Generelt sker alle opdateringer i Matriklen via en matrikulær sag. En sag vil i langt de fleste tilfælde forårsage opdatering af flere matrikulære elementer i én og samme transaktion. Objekttypen ”Matrikulær sag” kan dog godt opdateres uden det nødvendigvis medfører opdatering af sagens matrikulære elementer. Dette kan fx ske ved et skift af sagens status, jf. Begreber (MAT).


Nedenstående tabel beskriver et generelt overblik over hændelser i objekters livscyklus:

Hændelsestype

Regel

Bemærkning

CREATE

Dannes når et forretningsobjekt fødes, dvs. når en ny Id_LokalId opstår - uafhængig af objektets status.

Se CREATE - Oprettelse af nye matrikulære element 


UPDATE

Dannes ved alle andre opdateringer - uafhængig af status.

Se UPDATE - Opdatering af matrikulære elementer 

Dette gælder således også ved statusskift som fx:

Foreløbig -> Gældende

Foreløbig -> Ikke Gennemført

Gældende -> Foreløbig

DELETE

Dannes når et forretningsobjekt udgår, dvs. der dannes en række med status ”Historisk” eller ”Ikke gennemført”.

Se DELETE - Nedlæggelse af matrikulære elementer 

For MatrikulærSag vil der aldrig opstå en DELETE, da en sag
forretningsmæssigt set ikke bliver historisk, når den afsluttes. En sag vil således udløse en Update hændelse ved fx afslutning, aflysning eller annullering.




Generelt er den foreløbige og gældende registrering af matrikulære elementer uafhængige af hinanden. Der kan således ske ændringer af hhv.:

  • Den (eller de) foreløbige registrering uden der samtidig sker ændringer ved den tilsvarende gældende registrering af samme element.
  • den gældende registrering uden der samtidig sker ændringer ved den (eller de) tilsvarende foreløbige registrering af samme element.

Den eneste undtagelse fra ovenstående er ved sagsafslutning. Den nye gældende registrering, som her foretages, afløser både den foreløbige og den gældende registrering af samme element, som er tilknyttet samme sag. Der kan dog fortsat være foreløbige registreringer, der er tilknyttet andre sager – også hvis fx elementet er blevet historisk i den netop afsluttede sag.






Eksempler på hændelser

De viste eksempler viser, at registreringstider og virkningstider følges ad, hvilket er i overensstemmelse med den nuværende praksis. Der kan dog ske en ændring af denne praksis, hvilket ikke vil medføre ændringer af de principper, som opdateringerne registreres ud fra, men anvenderne bør fra starten tage højde for at der kan være forskel på registrerings- og virkningstid.

I de viste eksempler er skrivning markeret med fed skrift, og repræsenterer således den payload som udsendes med hændelsen. Kolonnen ”Hændelse” længst til højre er ikke en del af data.



CREATE - Oprettelse af nye matrikulære element

I eksemplet er vist oprettelse af et jordstykke, men samme princip gælder for øvrige matrikulære elementer.

Datamæssigt oprettes det nye jordstykke ved følgende datarække:

ID_LOKALID

MATRIKEL-NUMMER

DELNUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

Hændelse

3

Delnr. 7

Delnr. 7

19-01-15 16:00:00

NULL

19-01-15 16:00:00

NULL

Foreløbig

Nyoprettelse

101

 CREATE

Bemærk, at matrikulære elementer ikke nødvendigvis fødes med status foreløbig. De kan i visse tilfælde også fødes med status gældende, jf. Begreber (MAT).






UPDATE - Opdatering af matrikulære elementer

I Matriklen kan der være tale om fire forskellige former for opdatering:

  1. Almindelig opdatering
  2. Oprettelse af foreløbig version
  3. Sagsafslutning med lukning af foreløbig versioner
  4. Aflysning/annullering med lukning af foreløbige versioner






1. Almindelig opdatering

Denne form for opdatering sker f.eks i disse tilfælde:

  • Opdatering af foreløbige versioner, som fortsætter med at være foreløbige.
  • Sagsafslutning af matrikulære elementer, hvor der ikke har været foreløbig registrering (jf. livscyklus).
  • Opdatering af Matrikulær Sag.

Data opdateres generelt ved at udføre følgende:

  1. Eksisterende række afregistreres ved at sætte RegistreringTil = Opdateringstidspunkt.
  2. Der oprettes to nye rækker:
    1. En der er en kopi af den afregistrerede række, men hvor VirkningTil er udfyldt med virkningstiden.
    2. En der viser den fremtidige situation, hvor status er Gældende og VirkningFra er lig VirkningTil jf. 2.a. 




Eksempel – opdatering af foreløbig version, som fortsætter med at være foreløbig

FØR opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DELNUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

3

Delnr. 4

Delnr. 4

19-01-15 16:00:00

NULL

19-01-15 16:00:00

NULL

Foreløbig

Nyoprettelse

101

EFTER opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DELNUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

Hændelse

3

Delnr. 4

Delnr. 4

19-01-15 16:00:00

NULL

19-01-15 16:00:00

20-01-15 10:00:00

Foreløbig

Nyoprettelse

101


3

Delnr. 4

Delnr. 4

19-01-15 16:00:00

20-01-15 10:00:00

20-01-15 10:00:00

NULL

Foreløbig

Nyoprettelse

101

 

3

Delnr. 4

Delnr. 4

20-01-15 10:00:00

NULL

20-01-15 10:00:00

NULL

Foreløbig

Nyoprettelse

101

UPDATE







2. Oprettelse af foreløbig version

Når der i en matrikulær sag defineres og udstilles matrikulære forandringer, der ved sagsafslutning vil ændre på et gældende matrikulært element, så sker der ingen ændringer af den tilsvarende gældende version af elementet. Derfor vil opdateringen ligne det der sker ved oprettelse af nye matrikulære elementer, selvom der i dette tilfælde er tale om en opdatering af et eksisterende element.


Eksempel – oprettelse af foreløbig version

FØR opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DELNUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

1

1a

NULL

01-01-70 00:00:00

NULL

01-01-70 00:00:00

NULL

Gældende

NULL

7

EFTER opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DELNUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

Hændelse

1

1a

NULL

01-01-70 00:00:00

NULL

01-01-70 00:00:00

NULL

Gældende

NULL

7


1

1a

NULL

19-01-15 16:00:00

NULL

19-01-15 16:00:00

NULL

Foreløbig

Ændring

101

UPDATE







3. Sagsafslutning med lukning af foreløbig version

Denne type opdatering adskiller sig fra almindelige opdateringer ved at der vil være både en foreløbig og en gældende version af et matrikulært element, der skal ”lukkes” med registrerings- og virkningstid samtidig med der oprettes en ny version med status ”Gældende”. 


Eksempel – sagsafslutning med lukning af foreløbig version

FØR opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DEL-NUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

1

1a

NULL

01-01-70 00:00:00

NULL

01-01-70 00:00:00

NULL

Gældende

NULL

7

1

1a

NULL

20-01-15 10:00:00

NULL

20-01-15 10:00:00

NULL

Foreløbig

Ændring

101

EFTER opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DEL-NUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

Hændelse

1

1a

NULL

01-01-70 00:00:00

NULL

01-01-70 00:00:00

23-01-2015 11:00:00

Gældende

NULL

7


1

1a

NULL

20-01-15 10:00:00

NULL

20-01-15 10:00:00

23-01-2015 11:00:00

Foreløbig

Ændring

101


1

1a

NULL

01-01-70 00:00:00

23-01-15 11:00:00

23-01-15 11:00:00

NULL

Gældende

NULL

7


1

1a

NULL

23-01-15 11:00:00

NULL

23-01-15 11:00:00

NULL

Gældende

NULL

101

UPDATE

1

1a

NULL

20-01-15 10:00:00

23-01-15 11:00:00

20-01-15 10:00:00

NULL

Foreløbig

Ændring

101








4. Aflysning/annullering med lukning af foreløbige versioner

Ved denne type opdatering ”lukkes” alle sagens foreløbige forekomster med registrerings- og virkningstid. For foreløbigt ændrede og foreløbigt slettede objekter skal dette betragtes som ”Update”, da forretningsobjektet lever videre i en ”Gældende” forekomst.

Ved aflysning/annullering oprettes der desuden for nye objekter en ny række med status ”Ikke gennemført”. 



Eksempel – aflysning med lukning af foreløbig version

FØR opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DEL-NUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

1

1a

NULL

01-01-70 00:00:00

NULL

01-01-70 00:00:00


Gældende

NULL

7

1

1a

NULL

20-01-15 10:00:00

NULL

20-01-15 10:00:00

NULL

Foreløbig

Ændring

101

EFTER opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DEL-NUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

Hændelse

1

1a

NULL

01-01-70 00:00:00

NULL

01-01-70 00:00:00

NULL

Gældende

NULL

7


1

1a

NULL

20-01-15 10:00:00

NULL

20-01-15 10:00:00

23-01-2015  11:00:00

Foreløbig

Ændring

101


1

1a

NULL

20-01-15 10:00:00

23-01-15 11:00:00

20-01-15 10:00:00

NULL

Foreløbig

Ændring

101

UPDATE





DELETE - Nedlæggelse af matrikulære elementer

Matrikulære elementer nedlægges generelt efter samme principper som ved opdatering. Eneste forskel er status i rækken der viser den fremtidige situation. Dvs. der udføres følgende:

  1. Eksisterende række afregistreres ved at sætte RegistreringTil = Opdateringstidspunkt.
  2. Der oprettes to nye rækker
    1. En der er en kopi af den afregistrerede række, men hvor VirkningTil er udfyldt med virkningstiden.
    2. En der viser den fremtidige situation, hvor status er enten ”Ikke gennemført” eller ”Historisk” og VirkningFra er lig VirkningTil jf. 2.a.


Eksempel – nedlæggelse af foreløbigt matrikulært element

FØR opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DEL-NUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

4

Delnr. 7

Delnr. 7

19-01-15 16:00:00

NULL

19-01-15 16:00:00

NULL

Foreløbig

Nyoprettelse

101

EFTER opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DEL-NUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

Hændelse

4

Delnr. 7

Delnr. 7

19-01-15 16:00:00

NULL

19-01-15 16:00:00

20-01-15 10:00:00

Foreløbig

Nyoprettelse

101


4

Delnr. 7

Delnr. 7

19-01-15 16:00:00

20-01-15 10:00:00

20-01-15 10:00:00

NULL

Foreløbig

Nyoprettelse

101

 

4

Delnr. 7

Delnr. 7

20-01-15 10:00:00

NULL

20-01-15 10:00:00

NULL

Ikke gennemført

Nyoprettelse

101

DELETE


Eksempel – nedlæggelse af gældende matrikulært element

FØR opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DEL-NUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

2

1b

NULL

01-01-83 00:00:00

NULL

01-01-83 00:00:00

NULL

Gældende

NULL

8

EFTER opdatering:

ID_LOKALID

MATRIKEL-NUMMER

DEL-NUMMER

VIRKNINGFRA

VIRKNINGTIL

REGISTRERING
FRA

REGISTRERING
TIL

STATUS

PAATAENKT
HANDLING

SENESTESAG
LOKALID

Hændelse

2

1b

NULL

01-01-83 00:00:00

NULL

01-01-83 00:00:00

23-01-15 11:00:00

Gældende

NULL

8


2

1b

NULL

01-01-83 00:00:00

23-01-15 11:00:00

23-01-15 11:00:00

NULL

Gældende

NULL

8

 

2

1b

NULL

23-01-15 11:00:00

NULL

23-01-15 11:00:00

NULL

Historisk

NULL

101

DELETE