- Created by Maria Klostermann Tapdrup, last modified on Sept 21, 2021
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 2 Next »
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 Datafordeler - 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. | |
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 (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 | 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).
UPDATE - Opdatering af matrikulære elementer
I Matriklen kan der være tale om fire forskellige former for opdatering:
- Almindelig opdatering
- Oprettelse af foreløbig version
- Sagsafslutning med lukning af foreløbig versioner
- 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:
- Eksisterende række afregistreres ved at sætte RegistreringTil = Opdateringstidspunkt.
- Der oprettes to nye rækker:
- En der er en kopi af den afregistrerede række, men hvor VirkningTil er udfyldt med virkningstiden.
- 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 | 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 |
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 | 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 |
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 | 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 |
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 | 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 |
- No labels