Opdateringer og hændelser (MAT)

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:

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.

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. 

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.

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”. 

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”. 

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.