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:
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:
* 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 Datafordeler - guide til kopiregistre.
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. | |
UPDATE | Dannes ved alle andre opdateringer - uafhængig af status. | 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”. | For MatrikulærSag vil der aldrig opstå en DELETE, da en sag |
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 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.
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.
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 | REGISTRERING | STATUS | PAATAENKT | SENESTESAG | 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).
I Matriklen kan der være tale om fire forskellige former for opdatering:
Denne form for opdatering sker f.eks i disse tilfælde:
Data opdateres generelt ved at udføre følgende:
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 | REGISTRERING | STATUS | PAATAENKT | SENESTESAG |
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 | REGISTRERING | STATUS | PAATAENKT | SENESTESAG | 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 |
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.
FØR opdatering:
ID_LOKALID | MATRIKEL-NUMMER | DELNUMMER | VIRKNINGFRA | VIRKNINGTIL | REGISTRERING | REGISTRERING | STATUS | PAATAENKT | SENESTESAG |
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 | REGISTRERING | STATUS | PAATAENKT | SENESTESAG | 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 |
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 | REGISTRERING | STATUS | PAATAENKT | SENESTESAG |
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 | REGISTRERING | STATUS | PAATAENKT | SENESTESAG | 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 |
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 | REGISTRERING | STATUS | PAATAENKT | SENESTESAG |
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 | REGISTRERING | STATUS | PAATAENKT | SENESTESAG | 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 |