BBR systemdokumentation - dataudveksling

Systembeskrivelse kapitel 6 - Dataudveksling
Indholdsfortegnelse
6. Dataudveksling med andre systemer ............................................................................... 2
6.1 Kontekstdiagram for BBR ................................................................... 3
6.2 Kort om BBR’s dataudveksling ............................................................ 4
6.3 Vedligeholdelse af matrikulære data i BBR ........................................... 6
6.4 Systemspecifikke snitflader ................................................................ 8
6.4.1 Overordnede betragtninger .......................................................... 8
6.4.2 Skabelon til beskrivelse af systemintegration ................................. 9
6.5 Udtræk fra BBR .............................................................................. 10
6.5.1 Total udtræk (Totalkopi) ........................................................... 10
6.5.2 Udtrækkenes formater .............................................................. 11
6.5.3 Udtræk som BBR leverer ........................................................... 11
6.5.3.1 Totaludtræk til MBBL .......................................................... 11
6.5.3.2 BBR Meddelelser til print/e-boks .......................................... 11
6.5.3.3 Udtræk til Danmark Statistik ............................................... 11
6.5.3.4 Udtræk til Statens Arkiver .................................................. 11
6.5.3.5 Udtræk til OIS ................................................................... 11
6.6 Data som indlæses i BBR ................................................................. 12
6.6.1 CPR – BBR (Opdatering af udlejningsforhold) ............................... 12
6.6.2 CPR – BBR (Opdatering af Vejregisteret i BBR) ............................. 16
6.6.3 E-Boks – BBR .......................................................................... 19
6.6.4 AWS – BBR .............................................................................. 19
6.7 Snitflader, som BBR udstiller ............................................................ 20
6.7.1 OIOXML-snitflade for bygninger og boliger (Building Dwelling) ....... 21
6.7.2 Hjælpe-OIOXML-snitflader (Permission og Codelist) ...................... 21
6.7.3 OIS – BBR (Generering af BBR-Meddelelse) ................................. 22
6.7.4 Inddataboks (InputBox) ............................................................ 23
6.7.4.1 Type ”Supplerende varme” ................................................. 24
6.7.4.2 Type ”Matrikulær ændring” ................................................. 24
6.7.4.3 Type ”Fysisk flytning" ......................................................... 25
6.7.5 BBR-FIE (energidata ind i BBR) .................................................. 25
6.7.6 DAR - BBR ............................................................................... 26
6.7.7 CPR – BBR ............................................................................... 27
6.7.8 Eksempel på WSDL’erne ............................................................ 27
6.8 Snitflader som BBR kalder ................................................................ 30
6.8.1 BBR – GST .............................................................................. 30
6.8.2 BBR - ESR ............................................................................... 33
6.8.2.1 Online opslag, som henter hændelser fra ESR ....................... 35
6.8.2.2 On-line opslag, som henter oplysninger fra ESR .................... 44
6.8.2.3 On-line opslag, som sender oplysninger til ESR ..................... 49
6.8.3 BBR – plansystemDK ................................................................ 50
6.8.4 BBR – Bossinf-STB ................................................................... 50
6.8.5 BBR – CPR ............................................................................... 52
6.8.6 BBR – OIS ............................................................................... 52
6.8.7 BBR - AWS .............................................................................. 53
6.8.8 BBR – DAR .............................................................................. 53
6.8.9 BBR – Certificeringscenter ......................................................... 54
6.9 Periodevise kørsler, dataudtræk mv. ................................................. 55
6.9.1 Påmindelser ved overskridelse af tidsfrister ................................. 55
Version 12.0
Januar 2015
Side 1 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1. Dataudveksling med andre systemer
Dataudveksling med andre systemer vil i BBR fortrinsvis foregå som system-tilsystem integration.
Dataudvekslingen sker dels vha. udtræk og dels vha. snitflader.
Snitfladerne kan opdeles i de helt generelle oioxml-snitflader og i de systemspecifikke snitflader.
Dokumentationen (vejledningerne) for oioxml-snitfladerne ligger på bbr.dk og
specifikationerne er tilgængelige på Digitaliser.dk så snart de er godkendte af
ITST.
Version 12.0
Januar 2015
Side 2 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.1 Kontekstdiagram for BBR
Dette diagram illustrerer grafisk BBR’s dataudveksling med øvrige systemer.
OIS
ESR
BBR og adresse data samt BBR medd.
Ejendomsadresser og adresse data hvis aktuelt.
Ejeroplysninger
CPR
Matrikler og ejeroplysninger
FIE
Navn, adresse og ejendomsoply. til BBR medd.
Opdater udlejningsforhold
Energi data
Status
Inddataboks
GST
SFE numre og koordinater
MBBL/
Skat/
Socialminist
eriet
Adresse data
BBR
AWS
BOB data(Via OIS udtræk)
Dataudtræk
Adresse data
BBR Medd.
Print/E-boks
Tilmeldingsliste
BBR DAR interne services
DAR
Plansystem.
dk
Hent certifikater
BBR
data
BBR data
BBR og adresse data pr. år
Certificering
scenter
BBR og adresse data pr. måned
OIO BuildingDwe
lling
DST
Version 12.0
Januar 2015
Statens
arkiver
Side 3 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.2 Kort om BBR’s dataudveksling
GST



AWS


Geografisk sammenhæng for matrikler, benyttes til dannelse og vedligeholdelse af grunde. (se beskrivelse i underafsnit 6 i afsnit 6.3.2.4 BBR –
GST om vedligeholdelse af matrikulære data i BBR)
Kortforsyningen benyttes til at hente koordinater til bygninger og tekniske
anlæg samt søge matrikel i GST på basis af koordinater.
BBR sender adressehændelser til GST.
Nyt BBR henter adressehændelser fra AWS, for at ajourføre BBRs adressedata.
BBR kan også indlæse et totaludtræk fra AWS’en.
Begge muligheder kan implementeres ved at benytte den eksisterende
snitflade, som AWS udstiller. Se mere under følgende link
http://dawa.aws.dk/replikeringdok.
DAR


CPR




BBR kalder DAR online (opret og slet adresse)
DAR kalder BBR online for at hente ejendomsoplysninger samt rettigheder (logon og roller)
BBR henter dagligt oplysninger fra CPR. De skal bruges til at vedligeholde
vejregisteret.
Folkeregistrene skal have adgang til en standard webservice i BBR.
3 gange om året indlæses udlejningsforhold fra CPR. (Opdatering af Udlejningsforhold 2 ved samkøring af ESR, CPR og BBR).
BBR henter adresseoplsyninger i CPR
Plansystem.dk
 BBR henter data fra Plansystem.dk til skærmbilledet ”Ejendoms-oplysninger” (a la det skærmbillede som man tidligere kendte som ”C182” i KMD
BBR).
BOSSINF (snitflade er ikke implementeret)
 Hentning af offentlig støtte i BOSSINF på enhed
Statens Arkiver
 Der skal hvert år afleveres en komplet kopi af landsdækkende BBR-data
(stamdata). Formatet skal overholde krav fra Statens Arkiver.
Danmarks Statistik
 Danmarks Statistik skal kunne foretage online udtræk af landsdækkende
BBR-data (såvel stamdata som sagsdata).
OIS


Daglige online overførsler.
OIS bruges til adresseopslag i forbindelse med BBR-meddelelser.
Version 12.0
Januar 2015
Side 4 af 55
Systembeskrivelse kapitel 6 - Dataudveksling

OIS henter BBR-Meddelelser fra BBR
Skattemappen
 BBR-Meddelelser udsendes via e-mail eller E-boks i PDF-format med et
følgebrev og kan kobles til ”Skattemappen”.
Certificeringscenter
 Denne snitflade bruges i forbindelse med logon med certificater (medarbejder- og virksomhedscertifikater).
Print/e-Boks
 BBR-Meddelelser skal kunne udsendes via e-mail eller E-boks i PDF-format med et følgebrev og kunne kobles til ”Skattemappen”.
 e-Boks leverer liste over de danskere der er tilmeldt E-boks.
OIO-snitflader
 Alle BBR-data skal udstilles via webservices og snitflader i OIOXML-format.
Inddataboksen
 Med Inddataboksen får kommunen mulighed for at godkende rettelser til
udvalgte BBR data. Her gennemfører vi samme maskinel validering og
kvalitetssikring som når data ryger direkte ind.
ESR




FIE

ESR udstiller en lang række hændelser (matrikulære, ejerskifte mm.) som
abonnerer på.
BBR henter ejerforholdskode, ejerlejlighedsoplysninger m.m. i ESR.
I forbindelse med udskrift af BBR-Meddelelser hentes ejere fra ESR.
BBR sender adressehændelser til ESR
Fælles indberetning af energidata.
Version 12.0
Januar 2015
Side 5 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.3 Vedligeholdelse af matrikulære data i BBR
Matrikulære data i BBR vedligeholdes både ved hjælp af ESR og GST’s matrikelsystem miniMAKS.
I det følgende beskrives den implementerede model:
miniMAKS
1
5
ESR
2
5
3
BBR
4
6
1) Matrikulære ændringer sendes til ESR fra miniMAKS.
2) Der foretages sagsbehandling i ESR. ESR tilføjer bl.a. ejendomsnummer; alle
matrikler har et ejendomsnummer tilknyttet i ESR.
3) ESR gemmer matrikulære ændringer i en hændelsestabel, hvor de bliver læst
af BBR (snitflade 4 til 10 i afsnit ”BBR – ESR”).
4) BBR behandler den modtagne hændelse.
5) Nogle hændelser fra ESR, fx oprettelse af en ny matrikel eller ændring af SFEnummer initierer et kald til miniMAKS for at hente den geografiske sammenhæng for den modtagne eller ændrede matrikel. (snitflade 1 i afsnit ”BBR –
GST”)
Version 12.0
Januar 2015
Side 6 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
6) BBR opdaterer matrikulære data på baggrund af den modtagne hændelse og
information.
Fx resulterer en oprettelse af en ny matrikel i ESR i, at matrikelnummeret tilføjes
til en eksisterende grund som denne matrikel hører til eller i en oprettelse af en
ny grund. Opdateringen i BBR afhænger af, om der i forvejen ligger en grund,
som denne matrikel skal knyttes til.
En sletning af et matrikelnummer resulterer i fjernelse af matrikelnummeret fra
dens grund i BBR og grunden slettes hvis den ikke har andre matrikelnumre tilknyttet. ESR sikrer, at der ikke er bygninger på grunden. Eventuelle adresser på
matriklen flyttes til ”UMAT” (uden matrikel).
Ud over opret- og slet-matrikel-hændelser findes der flere ESR-hændelser som
initierer en opdatering af matrikulære data i BBR. De mulige hændelser som
modtages fra ESR er beskrevet i afsnit ”BBR – ESR”.
Version 12.0
Januar 2015
Side 7 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.4 Systemspecifikke snitflader
1.4.1 Overordnede betragtninger
I forbindelse med system-til-system integration er der nogle overordnede overvejelser, der skal foretages for at denne integration kan fungere så optimalt som
muligt. System-til–system integration vil altid introducere en ekstra kompleksitet
i de implicerede systemer, hvad angår tilgængelighed, synkronisering og performance.
Det vil her være hensigtsmæssigt at skelne mellem databærende og data-anvendende system. Ideelt set skal det være det databærende system, der indeholder
dets data og som udstiller dem via et sæt af services, som andre systemer kan
tilgå. Imidlertid giver dette problemer omkring søgning, tilgængelighed og svartider, når det anvendende system til stadighed skal tilgå. Måden hvorpå man
håndterer dette er i reglen ved at introducere dataredundans i de anvendende
systemer, således at de relevante data kan fremfindes på en hurtig måde, hvilket imidlertid giver et problem omkring opdateringer og pålideligheden af de relevante data. Håndteringen af problemstillingen (redundante data vs. opdaterede
data) kan ske på tre forskellige måder:
1) Man opgiver dataredundans og fremfinder de relevante data i det databærende system.
2) Man lader det databærende system opdatere det eller de anvendende systemer.
3) Man anvender en publisher/subscriber mekanisme til at håndtere opdateringen, således at det data-anvendende system abonnerer på ændringer i
det databærende system. På denne måde afkobles relationen mellem de
to systemer og det databærende system skal ikke bekymre sig om at opdatere de anvendende systemer.
Alle tre løsninger har fordele og ulemper. Vanskelighederne ved 1) har allerede
været nævnt, mens 2) introducerer en kompleksitet i det databærende system,
som bliver forøget betragteligt, hvis der er mange systemer der skal opdateres.
Hvis blot et af de systemer der skal opdateres ikke er tilgængeligt, kan opdateringen ikke gennemføres, hvis den skal være pålidelig. I en SOA orienteret verden, er det en løsning der så vidt muligt skal undgås. 3) derimod har ikke disse
vanskeligheder, til gengæld kan den ikke sikre at data er pålidelige.
Nedenstående skema opsummerer de vigtigste forskelle i fordele og ulemper
mellem de forskellige metoder:
Pålidelighed
Tilgængelighed
Simpelhed
1) Ingen dataredundans
+
-
+
2) Opdatering fra databærende system
+
(-)
-
3) Publish/Subscribe
-
+
(+)
I forbindelse med BBR vil det være nødvendigt at inddrage disse overvejelser
med hvert enkelt tilfælde af system-til-system integration.
Version 12.0
Januar 2015
Side 8 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.4.2 Skabelon til beskrivelse af systemintegration
Nedenfor præsenteres en skabelon for de services, der skal udvikles i forbindelse
med BBR’s integration til andre systemer samt nogle eksempler. Disse vil tjene
både til udvikling og dokumentation af de udviklede services. Skabelonen er
godkendt af KOMBIT som model til beskrivelse af de enkelte services.
Klient <den der bruger servicen>
Server <den der udfører servicen>
Beskrivelse: <Overordnet beskrivelse af snitfladen>
Inputparametre: <Hvilke inputparametre skal anvendes>
Outputparametre: <Hvilke outputparametre skal anvendes>
Entitet: <Hvilke entiteter arbejdes der på>
Entitet: <Hvilke entiteter arbejdes der på>
Attributter: <Hvilke attributter>
Attributter: <Hvilke attributter>
Betingelse: <Hvilke betingelser skal programmæssigt være opfyldt>
Resultat: <Resultat af servicens eksekvering,
ie. Hvilken tilstand er serveren i>
Sikkerhed: <Hvilke sikkerhedsmæssige aspekter er involveret>
Fejlhåndtering: <Hvorledes rapporteres fejl til
klienten (afhængig af hvordan servicen implementeres)>
Vurderingsparametre:
Isolation/Uafhængighed: <Hvilken indflydelse
har servicen på systemernes funktionalitet>
On-line tilgængelighed: <Er det nødvendigt at
informationen er tidstro>
Svartider: <Er svartiden kritisk>
Synkronisering: <Er sync af databaser essentiel>
Kompleksitet: <Er servicen kompleks i forhold til
afhængigheder, betingelser og operationer>
Logistik: <Med hvem og hvad skal der aftales>
Overholdelse af Kontrakten:
Kommentarer: <Kommentarer i øvrigt>
To Do: <Hvad skal der gøres>
To Do: <Hvad skal der gøres>
Status: <Status for implementering af service>
Version 12.0
Januar 2015
Side 9 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.5 Udtræk fra BBR
Der kan foretages udtræk af landsdækkende BBR-data (såvel stamdata som
sagsdata).
1.5.1 Total udtræk (Totalkopi)
Total udtræk af BBR-data, foretages på baggrund af den fysiske implementering
af databasen.
Udtrækket laves som semikolonsepareret filer, en fil pr. tabel, med en række pr.
record.
Udtrækket leveres med afblænding af felter der er omfattet af sikkerhedsklassifikation.
Udtrækket består af data fra 26 tabeller (hvor tabellen ”antal” er en tabel der
angiver hvor mange rækker der er i de øvrige tabeller):


























Version 12.0
Januar 2015
AdgangsAdresse
Adressesag
Antal
Brugsenhed
By
Byggesag
Bygning
Ejerskab
Enhed
EnhedEnhedsAdresse
EnhedOpgang
EnhedsAdresse
Etage
Geometri
Grund
KommunaltEjerlav
Kommune
Lokalitet
Matrikel
Notat
Opgang
Postdistrikt
Rum
Tekniskanlaeg
Vej
Vejstykke
Side 10 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.5.2 Udtrækkenes formater
Det er muligt at levere udtræk fra BBR i følgende formater:
Standard formater
OIO-XML og
CSV-filer
Eksempler på modtagere
Skat
MBBL
Danmarks Statistik
Modtagere
OIS
Statens Arkiver
Særlige formater
OIS-XML
Statens Arkivers formater
1.5.3 Udtræk som BBR leverer
Modtager
MBBL/Skat/Socialministeriet
Print/E-boks
Danmarks Statistik
Statens Arkiver
OIS
Data
BBR leverer totaludtræk.
BBR sender BBR Meddelelser til print/til e-boks
BBR leverer BBR og Adresse data
BBR leverer BBR og Adresse data
BBR leverer BBR og Adresse data. Der leveres
dagligt et udtræk med ændringer, der er foretaget i BBR siden sidste udtræk.
1.5.3.1 Totaludtræk til MBBL
BBR leverer totaludtræk til MBBL en gang om året.
1.5.3.2 BBR Meddelelser til print/e-boks
BBR sender BBR Meddelelser til print/til e-boks en gang om ugen.
1.5.3.3 Udtræk til Danmark Statistik
BBR leverer totaludtræk til Danmarks Statistik en gang om måneden.
1.5.3.4 Udtræk til Statens Arkiver
BBR leverer data til Statens Arkiver en gang om året.
1.5.3.5 Udtræk til OIS
Der skal dagligt køres et program der skaber et udtræk, dette udtræk placeres
på et ftp server, hvorfra OIS henter data.
Dataformatet er lavet i overensstemmelse med OIS’s krav til snitflade, som OIS
har beskrevet i dokumentet ”OIS_DBvaert_XML_Snitflade”.
De daglige udtræk består af de ændringer der er foretaget i BBR siden sidste udtræk. De enkelte entiteters timestamp bestemmer, hvilke data der skal overføres. Disse timestamps udløser en xml-record til OIS som følgende:
OpretTimestamp
Version 12.0
Januar 2015
”O” Opret record
Side 11 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
AendrtTimestamp
”R” Ændrings record
OphoertTimestamp
”S” Slette record.
Der vedligeholdes en oversættelsesliste mellem BBR, OIS og OIOXML. Listen indeholder:






BBR’s feltnavn i den fysiske database
BBR-feltets XML navn når det afleveres til OIS
Navnet på det tilsvarende felt/element i OIOXML
OIOXML- metadatabeskrivelsen
OIOXML navnet på engelsk
OIOXML- metadatabeskrivelsen på engelsk
1.6 Data som indlæses i BBR
Afsender
CPR udlejningsforhold
E-boks tilmeldingsliste
CPR veje, vejstykker, vejnavne m.m.
AWS
Data
3 gange om året indlæses BBR data vedr. udlejningsforholdet
E-boks sender tilmeldingsliste til BBR.
BBR indlæser data, som modtages fra CPR (en
gang dagligt).
Der indlæses efter behov totaludtræk af adressedata fra AWS
1.6.1 CPR – BBR (Opdatering af udlejningsforhold)
3 gange om året indlæses udlejningsforhold fra CPR og feltet ”Udlejningsforhold
2” opdateres ved samkøring af ESR, CPR og BBR.
Klient BBR
Server CPR, ESR
Beskrivelse: I forbindelse med opdatering af udlejningsforhold sammenkøres udtræk fra CPR og
ESR med data fra BBR.
Inputparametre:
Outputparametre: Udtræk af alle ejere og lejere i CPR.
Entitet:
Entitet:
Attributter:
Attributter: Udlejningsforhold
Betingelse:
Resultat: Opdatering af udlejningsforhold i BBR.
Sikkerhed: Overførsel af data sker via FTPS.
Fejlhåndtering: I forbindelse med kørslen udskrives en fejlliste.
Vurderingsparametre:
Isolation/Uafhængighed: Alle systemer er nødvendige.
On-line tilgængelighed: Dette er en batch-kørsel.
Svartider: Nej
Version 12.0
Januar 2015
Side 12 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Synkronisering: Nej
Kompleksitet: Middel
Logistik: Data overføres fra ESR og CPR i ”flade
filer” til BBR. Her læses de ind i BBR i tilknyttede
tabeller. Efter indlæsningen køres der en stored
procedure der opdaterer udlejningsforhold.
Overholdelse af Kontrakten:
Kommentarer:
To Do:
To Do:
Håndtering af redundante data vs. opdaterede data: Ingen dataredundans
Status: Implementeret.
Opdatering af udlejningsforhold sker ved samkøring af ESR, BBR og CPR.
I opdatering af udlejningsforhold indgår 3 datasæt:

Udtræk fra ESR som indeholder kommunenr, ejendomsnr, ejerlejlighedsnr
og CPRnr. Dette hentes via FTPS på en FTP-server hos KMD.

Udtræk fra CPR som indeholder oplysninger om CPRnr. og adresse. Dette
hentes via FTPS på en FTP-server hos CSC.
Udtræk fra BBR som indeholder kommunenr, ejendomsnr, ejerlejlighedsnr,
adresse, boligtypekode og anvendelseskode.
Version 12.0
Januar 2015
Side 13 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Når ESR-udtrækket er hentet, læses det ind i tabel ’ESR_Ejer’ i database
JR5000PD i BBR via et SSIS job.
Når udtrækket fra CPR er hentet, læses det ind i tabel ’CPR_Adresse’ i database
JR5010PD i BBR via det job, som indlæser og opdaterer data fra CPR. Jobbet
hedder OpdaterCPRData.exe.
Når data er indlæst køres stored procedure
’bbr_domain.usp_EnhedUpdateBatchUdlejningsforhold2’, som herefter opdaterer
kolonnen ’Udlejningsforhold2’ i tabellen ’Enhed’.
Proceduren opdaterer udlejningsforhold med én af følgende værdier:
1. Udlejet
2. Benyttet af ejer
3. Ikke benyttet
Først opsættes kode 3. Hvis BBR-enheden ikke er i ’CPR_Adresse’ tabellen.
Derefter opsættes kode 2, hvis et CPR nummer fra ’CPR_Adresse’, der bebor en
enhed, matcher tabellen ’ESR_ejer’ på den pågældende ejendom.
De resterende sættes til kode 1.
Tabellerne ESR_ejer, BBR_Adresse og CPR_Adresse er ’arbejdstabeller’ og indgår
derfor ikke i den logiske datamodel.
Kørslen vil ske 3 gange årligt (april, september og december).
Version 12.0
Januar 2015
Side 14 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
KMD ESR
KMD FTP
server
ESR udtræk
ESR
udtræk
SFTP
KMD
Firewall
CSC FTP
server
Nyt BBR
SQL Server
FTPS
Adresse udtræk
fra CPR
Version 12.0
Januar 2015
Nyt BBR
Applikations
server
Indlæsning af
ESR ejere via
SSIS job
Indlæsning af
CPR adresser
via CPR
opdateringspro
gram
Side 15 af 55
Kørsel af stored
procedure som
opdaterer
udlejningsforhold
2 på Enhed
Systembeskrivelse kapitel 6 - Dataudveksling
1.6.2 CPR – BBR (Opdatering af Vejregisteret i BBR)
BBR indlæser data, som modtages fra CPR (en gang dagligt).
Klient BBR
Server CPR
Beskrivelse: I forbindelse med opdatering af vejregisteret hentes dagligt udtræk fra CPR som læses ind i BBR.
Inputparametre:
Outputparametre: Ajourføringsudtræk af Vejregisteret i CPR.
Entitet:
Entitet:
Attributter:
Attributter: Vejregisteret
Betingelse:
Resultat: Opdatering af Vejregisteret i BBR.
Sikkerhed: Overførsel af data sker via FTPS.
Fejlhåndtering: I forbindelse med kørslen udskrives en fejlliste.
Vurderingsparametre:
Isolation/Uafhængighed: Alle systemer er nødvendige.
On-line tilgængelighed: Dette er en batch-kørsel.
Svartider: Nej
Synkronisering: Nej
Kompleksitet: Middel
Logistik: Data overføres fra CPR i ”flade filer” til
BBR. Her læses de ind i BBR, i to tabeller, via
stored procedures.
Overholdelse af Kontrakten:
Kommentarer:
To Do:
To Do:
Håndtering af redundante data vs. opdaterede data: Publish/subscribe
Status: Implementeret.
Opdatering af Vejregisteret i BBR sker ved at hente ajourføringsudtræk fra CPR
og opdatere tabellerne Vej og Vejstykke med ændringerne.
Udtræk fra CPR køres når der er opdateringer til Vejregisteret. Den service der
bruges til at hente og indlæse Vejregisteret køres én gang om dagen.
Når CPR-udtrækket er hentet, læses det ind i tabellerne Vej og Vejstykke via
procedurerne:
Usp_Vej_Delete
Usp_Vej_Insert
Usp_Vej_Update
Usp_Vejstykke_Delete
Usp_Vejstykke_Insert
Usp_Vejstykke_Update
Version 12.0
Januar 2015
Side 16 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Når data er opdateret køres proceduren usp_AdgangsAdresseUpdateDeNorm_vej, som opdaterer de denormaliserede attributter i tabellen AdgangsAdresse. Disse attributter er denormaliserede af hensyn til performance.
Version 12.0
Januar 2015
Side 17 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
KMD
Firewall
CSC FTP
server
Nyt BBR
SQL Server
FTPS
Vejregisterudtræk
fra CPR
Version 12.0
Januar 2015
Nyt BBR
Applikations
server
Indlæsning af
ændringsdata fra CPR
Vejregisteret.
Indlæsningsservice
henter ajourføringsfiler
fra CPR via FTP og
kalder stored procedures
på SQL Serveren, som
opdaterer tabellerne Vej
og Vejregisteret.
Side 18 af 55
Kørsel af
procedurerne:
Usp_Vej_Delete
Usp_Vej_Insert
Usp_Vej_Update
Usp_Vejstykke_Delete
Usp_Vejstykke_Insert
Usp_Vejstykke_Update
Systembeskrivelse kapitel 6 - Dataudveksling
1.6.3 E-Boks – BBR
E-boks sender tilmeldingsliste til BBR. e-Boks leverer liste over de danskere, der
er tilmeldt E-boks
1.6.4 AWS – BBR
BBR kan indlæse et totaludtræk fra AWS’en.
Muligheden implementeres ved at benytte den eksisterende snitflade, som AWS
udstiller. Se mere under følgende link http://dawa.aws.dk/replikeringdok.
Version 12.0
Januar 2015
Side 19 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.7 Snitflader, som BBR udstiller
Der findes to adgange til BBR:


BBR-Kommune, dvs. klienten, som er kommunernes webadgang til BBR
Kommuneklienten, dvs. OIOXML-snitfladerne, som tilgår BBR via en service gateway
Begge adgange tilgår den samme applikationsserver og har dermed adgang til
samme forretningslogik.
I forbindelse med masseopdateringer af BBR vil det være hensigtsmæssigt at benytte sig af den funktionalitet, der er stillet til rådighed via de generelle
OIOXML-baserede snitflader, som sikrer at alle felter kan opdateres (for så vidt
som man har autorisation til det) og at alle forretningsreglerne bliver overholdt.
Kommuneklient
BBR-klient
OWSA-model T
(SSL)
Internet
Https
(SSL)
Service Gateway
Web site
Modul
1
Modul
2
...
Modul
N
Service Agenter
Autentifikation
Præsentationsserver
WCF
Applikationsserver
Service Interface Lag
Service Contract
Batch
Windows
Services
Forretnings Lag
Forretnings
Logik
Forretnings
Entiteter
ASP.NET Providers
Service Adapter
Data Access Lag
Data Access
Logik
Service
Agenter
OIOXML
SQL
Server
Eksterne
Services:
- CPR
- ESR
- OIS
- KMS
BBR’s funktionalitet bliver stillet til rådighed som OIOXML-baserede webservices,
således at de generelt vil kunne tilfredsstille andre systemers behov for data og
opdatering. OIOXML-skemaer og WSDL-beskrivelser publiceres på Digitaliser.dk.
Dokumentationen for oioxml-snitfladerne (vejledningerne) ligger på bbr.dk.
Version 12.0
Januar 2015
Side 20 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Snitflade
OIO BuildingDwelling
OIO Permission
OIO Codelist
OIS GetDatalist
OIO EnergyService (FIE)
OIO InputBox (Inddataboks)
OIO snitflade til DAR
Snitflade til CPR
Data
Igennem OIO BuildingDwelling snitfladen
kan 3. part hente og opdatere BBR data.
Snitfladen Permission tilbyder metoder til at
få oplysninger om feltrettigheder i BBR.
Snitfladen CodeList tilbyder metoder til at få
oplysninger om kodelister i BBR.
OIS henter BBR Meddelelser i BBR.
FIE leverer energidata til BBR ved hjælp af
en OIO snitflade.
Igennem Inddataboks snitfladen kan 3. part
eller BBR Kommune selv (Flytning af bygning) sende BBR data til BBRs Inddataboks,
hvor data kan valideres før data indlæses i
BBR.
BBR stiller en snitflade til DAR til rådighed
for at DAR kan hente ejendomsoplysninger
samt rettigheder fra BBR.
Det er aftalt, at folkeregisteret skal tilgå
BBR-data via de generelle OIOXML-snitflader.
1.7.1 OIOXML-snitflade for bygninger og boliger
(Building Dwelling)
En af de OIOXML-snitflader, som BBR systemet stiller til rådighed, er ”BuildingDwelling.wsdl”. Baggrunden for denne snitflade er, at man ønsker at registrere og
opdatere ”Bygninger og boliger”-data i BBR ved webservicebaseret overførsel fra
et eksternt system i OIOXML-format.
Snitfladen giver – kort sagt – mulighed for fremsøgning samt opdatering af data
om bygninger og boliger i BBR, herunder grunde, bygninger, opgange/indgange,
etager, enheder, tekniske anlæg, rum, brugsenheder og ikke mindst byggesager.
1.7.2 Hjælpe-OIOXML-snitflader (Permission og
Codelist)
BBR stiller 2 hjælpe-OIOXML-snitflader til rådighed. Snitfladerne
henter oplysninger vedr. rettigheder og kodelister fra BBR. Snitfladerne indeholder ingen metoder som opdaterer data i BBR.
Disse hjælpeservices kan benyttes når man arbejder med webservicen, til ”Bygninger og boliger”-delen af BBR (dvs. BuildingDwelling.wsdl).
Version 12.0
Januar 2015
Side 21 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
 Snitfladen Permission tilbyder metoder til at få oplysninger
om feltrettigheder i BBR. Afhængig af hvilke roller man er tildelt i BBR vil man have adgang til at læse, skrive eller
læse/skrive til de enkelte felter.

Snitfladen CodeList tilbyder tre metoder til at få oplysninger
om kodelister i BBR.
1.7.3 OIS – BBR (Generering af BBR-Meddelelse)
Hentning af BBR-Meddelelse ud fra kommunenummer og ejendomsnummer.
Klient OIS
Server BBR
Beskrivelse: OIS kan bestille en BBR-Meddelelse ved at kalde BBR med kommune og ejendomsnummer.
Inputparametre: Kommunenummer og ejendomsnummer.
Outputstruktur: Statuskode, statustekst samt bytearray indeholdende den genererede BBR-Meddelelse i PDF format.
Entitet: Flere
Entitet: Flere
Attributter:
Attributter: Kommunenummer og ejendomsnummer
Betingelse:
Betingelse:
Resultat: Statuskode, statustekst samt bytearray indeholdende
den genererede BBR-Meddelelse i PDF format. Statuskoder og
tekst kan være følgende:
0:
Ok
2:
tur)
RealPropertyStructureType ikke valid (kaldende struk-
3:
Kommunenummer ikke valid
4:
Ejendomsnummer ikke valid
50:
Ejendommen er omfattet af sikkerhedsklassifikation
80:
Database er ikke tilgængelig
90:
Fejl ved generering af BBR-udskrift
200:
Ukendt fejl
Sikkerhed:
Sikkerhed: HTTPS
Fejlhåndtering:
Fejlhåndtering: Fejlkode og fejltekst
Vurderingsparametre:
Isolation/Uafhængighed: OIS kan ikke levere BBR-Meddelelser til
borgerne hvis servicen og BBR systemet ikke er tilgængelig
On-line tilgængelighed: Ikke nødvendigvis tidstro, men bør være
det.
Svartider: ja
Synkronisering: Nej
Kompleksitet: Nej
Logistik:
Overholdelse af Kontrakten:
Kommentarer:
To Do:
Status: Webservice er implementeret.
Version 12.0
Januar 2015
Side 22 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.7.4 Inddataboks (InputBox)
BBR Inddataboks giver mulighed for modtagelse af BBR data fra eksterne interessenter.
Eksterne interessenter kan indsende sager til BBR Inddataboksen via standardiserede snitflader. Sagerne indeholder kort sagt information om indberetteren
samt BBR data, der ønskes indberettet til BBR systemet.
BBR Inddataboksen giver endvidere – via fanebladet Inddataboks - mulighed for
at sagsbehandle disse sager. Hvis sagerne godkendes, opdateres BBR systemet
med de indsendte BBR data.
En indberetter sender data til Inddataboksen via en ekstern applikation eller via
BBR Kommune. Hvem der er indberetteren, hvilke data der sendes og hvilken
applikation der benyttes afhænger af indberetningstypen.
For indberetningstypen ”Supplerende varme” vil indberetteren typisk være ejeren. De indberettede BBR data vil være data vedr. supplerende varme for en
bygning hhv. en enhed. Den eksterne applikation til indberetning af ”Supplerende varme” er under udvikling.
For indberetningstyperne ”Matrikulær ændring” og ”Fysisk flytning” (betegnelsen
”Flytning af bygning” dækker over begge typer) vil indberetteren være en anden
Version 12.0
Januar 2015
Side 23 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
kommune. De indberettede BBR data vil være data vedr. en bygning, som ønskes flyttet til den kommune, som har modtaget Inddataboks sagen.
Sager vedr. flytning af bygninger indberettes igennem BBR Kommune, som gør
det muligt at flytte en bygning og underliggende entiteter til en anden kommune. Læs mere herom i brugervejledning til fanebladet ”Bygninger og Boliger”
for BBR Kommune.
BBR data bliver sammen med indberetterens kontaktoplysninger sendt til Inddataboksen via en webservice.
Så snart indberetningen er modtaget i Inddataboksen, udsendes en kvittering
via e-mail til indberetteren.
Kommunen kan nu tilknytte en sagsbehandler til sagen. Den ansvarlige sagsbehandler vil efterfølgende modtage en e-mail om den nye indberetning.
Sagsbehandleren kan nu overføre, afvise eller godkende sagen. Resultatet af
sagsbehandlingen sendes via e-mail til indberetteren.
Hvis sagen godkendes, opdateres data direkte i BBR.
Hvis sagen overføres til anden afdeling, afsluttes sagen i Inddataboks og sagsbehandlingen foretages uden for Inddataboksens kontekst.
I denne version af Inddataboksen kan indsendte sager have tre typer og det er:
- Supplerende varme
- Matrikulær ændring (bygning)
- Fysisk flytning af bygning
På længere sigt er det planen, at Inddataboksen kan modtage mange forskellige
indberetninger til BBR systemet.
Der vil blive udviklet en webservice til hver type.
1.7.4.1 Type ”Supplerende varme”
Via en snitflade kan Inddataboksen modtage ændringer til feltet ”Supplerende
varme” på bygnings- og enhedsniveau.
Webservicen hedder InputBox.wsdl.
1.7.4.2 Type ”Matrikulær ændring”
Når en kommune ”flytter” en bygning til en anden kommune, drejer det sig i
95% af tilfældene om matrikulære ændringer.
Når en kommune (fraflytter kommunen) ønsker at flytte en bygning (og dens
underliggende entiteter) til en anden kommune (tilflytter kommune), gøres det
på BBR Kommunes ”Bygninger og boliger” faneblad.
Dette resulterer i oprettelse af en Inddataboks sag i tilflytter-kommunen med
type ”Matrikulær ændring”.
Version 12.0
Januar 2015
Side 24 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.7.4.3 Type ”Fysisk flytning"
Når en kommune ”flytter” en bygning til en anden kommune, drejer det sig i
5% af tilfældene om fysiske flytninger, hvor bygningen ændrer placering. Typiske eksempler på fysiske flytninger er husbåde og museumsbygninger.
Når en kommune (fraflytter-kommunen) ønsker at flytte en bygning (og dens
underliggende entiteter) til en anden kommune (tilflytter-kommune), gøres det
på BBR Kommunes ”Bygninger og boliger” faneblad.
Dette resulterer i oprettelse af en Inddataboks sag i tilflytter-kommunen med
type ”Fysisk flytning”.
1.7.5 BBR-FIE (energidata ind i BBR)
Et særskilt dokument beskriver systemdesignet for ”Energidata ind i BBR”, som
dækker over de udvidelser, som laves i BBR for at opfylde kravspecifikationen:
”Kravspecifikation Energiforbrugsindberetning 1.5”. Dette dokument skal læses i
forlængelse af BBR’s systemdokumentation. Endvidere henvises til bekendtgørelse om energiforsyningsselskabernes indberetningspligt til Bygnings- og Boligregistret (BBR) BEK nr 1264 af 16-11-2010.
Version 12.0
Januar 2015
Side 25 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.7.6 DAR - BBR
BBR stiller en snitfalde til rådighed, som DAR kan kalde. Snitfalden har følgende
metoder:
1) AdresseIBrug
Adresser må ikke slettes hvis de er i brug i BBR. Derfor udstiller BBR en
service, som angiver om den er i brug i BBR
DAR kalder BBR via en intern service med information om den adresse,
som skal slettes. BBR returnerer ”false” hvis adressen ikke er i brug eller
”true” hvis den er i brug.
2) HusnummerIBrug
Husnumre må ikke slettes hvis de er i brug i BBR. Derfor udstiller BBR en
service, som angiver om den er i brug i BBR
DAR kalder BBR via en intern service med information om det husnummer, som skal slettes. BBR returnerer ”false” hvis husnummeret ikke er i
brug eller ”true” hvis den er i brug.
3) MatrikelListUdFraEjendomsnummer
Adresser skal kunne fremsøges ud fra ejendomsnummer. BBR udstiller en
service til at hente listen af matrikler ud fra et ejendomsnummer.
DAR kalder BBR via en intern service med et ejendomsnummer. BBR returnerer en liste af de matrikler som findes med det ejendomsnummer.
4) EjendomsnummerHentUdFraMatrikel
Adresser skal kunne fremsøges ud fra ejendomsnummer. BBR udstiller en
service til at hente ejendomsnummeret ud fra en matrikel.
DAR kalder BBR via en intern service med en matrikel. BBR returnerer et
ejendomsnummer ud fra matrikeloplysningen.
5) AutentificerBruger
DAR autentificerer brugere ved at kalde en intern snitflade i BBR.
DAR kalder BBR via en intern service med en brugers login oplysninger.
Hvis oplysninger kan godkendes, returneres brugerens roller til DAR fra
BBR.
Version 12.0
Januar 2015
Side 26 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.7.7 CPR – BBR
Det er aftalt, at folkeregisteret skal tilgå BBR-data via de generelle OIOXML-snitflader. CPR benytter BuildingDwelling snitfladen.
Klient CPR
Server BBR
Beskrivelse: I forbindelse med flytningen af boligregisteret til BBR skal CPR fremover have adgang til hvilke adresser der er oprettet/knyttet til en bolig i BBR via en snitflade.
Inputparametre: Adresse
Outputparametre: Oplysning om, om adressen findes på en bolig
Entitet: Adgangs- og enhedsadresse, Enhed
Entitet: Adgangs- og enhedsadresse, Enhed
Attributter:
Attributter:
Betingelse:
Resultat:
Sikkerhed: Krypteret forbindelse med autorisation via certifikat.
Fejlhåndtering: Fejl logges på klienten.
Vurderingsparametre:
Isolation/Uafhængighed: Der kan opstå inkonsistens, hvis CPR ikke oplyses om at en given
adresse ikke findes i BBR.
On-line tilgængelighed: Systemet bruges til her
og nu opslag ved CPR.
Svartider: Forsinkelser i svartider opleves hos
CPR.
Synkronisering: Den er ønskværdig, men ikke
kritisk.
Kompleksitet: Lav
Logistik: BBR stiller WebService til rådighed for
CPR.
Overholdelse af Kontrakten:
Kommentarer: Data leveres i OIOXML.
To Do:
To Do:
Status:
Det er aftalt, at folkeregisteret skal tilgå BBR-data via de generelle OIOXML-snitflader.
1.7.8 Eksempel på WSDL’erne
Alle services beskrives i et WSDL-dokument. Herunder er et eksempel på et
WSDL-dokument (eksemplet er hentet fra oioxml-snitfladen ”PermissionV1”).
<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="urn:oio:bbr:wsdl:1.0.0" targetNamespace="urn:oio:bbr:wsdl:1.0.0" xmlns:ns="urn:oio:bbr:1.0.0">
<wsdl:types>
<xs:schema targetNamespace="urn:oio:bbr:1.0.0" elementFormDefault="qualified">
Version 12.0
Januar 2015
Side 27 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
<xs:include schemaLocation="http://digitaliser.dk/resource/566724/artefact/EntityPermissionGetRequestStructure.xsd" />
<xs:include schemaLocation="http://digitaliser.dk/resource/566733/artefact/EntityPermissionGetResponseStructure.xsd" />
<xs:include schemaLocation="http://digitaliser.dk/resource/566723/artefact/EntityPermissionGetByEntityRequestStructure.xsd" />
<xs:include schemaLocation="http://digitaliser.dk/resource/566732/artefact/EntityPermissionGetByEntityResponseStructure.xsd" />
<xs:include schemaLocation="http://digitaliser.dk/resource/566704/artefact/EntityGetRequestStructure.xsd" />
<xs:include schemaLocation="http://digitaliser.dk/resource/566722/artefact/EntityGetResponseStructure.xsd" />
</xs:schema>
</wsdl:types>
<wsdl:message name="EntityPermissionGetRequest">
<wsdl:part name="request" element="ns:EntityPermissionGetRequestStructure"/>
</wsdl:message>
<wsdl:message name="EntityPermissionGetResponse">
<wsdl:part name="response" element="ns:EntityPermissionGetResponseStructure"/>
</wsdl:message>
<wsdl:message name="EntityPermissionGetByEntityRequest">
<wsdl:part name="request" element="ns:EntityPermissionGetByEntityRequestStructure"/>
</wsdl:message>
<wsdl:message name="EntityPermissionGetByEntityResponse">
<wsdl:part name="response" element="ns:EntityPermissionGetByEntityResponseStructure"/>
</wsdl:message>
<wsdl:message name="EntityGetRequest">
<wsdl:part name="request" element="ns:EntityGetRequestStructure"/>
</wsdl:message>
<wsdl:message name="EntityGetResponse">
<wsdl:part name="response" element="ns:EntityGetResponseStructure"/>
</wsdl:message>
<wsdl:portType name="PermissionV1">
<wsdl:operation name="EntityPermissionGet">
<wsdl:input name="EntityPermissionGetRequest" message="tns:EntityPermissionGetRequest"/>
<wsdl:output name="EntityPermissionGetResponse" message="tns:EntityPermissionGetResponse"/>
</wsdl:operation>
<wsdl:operation name="EntityPermissionGetByEntity">
<wsdl:input name="EntityPermissionGetByEntityRequest" message="tns:EntityPermissionGetByEntityRequest"/>
<wsdl:output name="EntityPermissionGetByEntityResponse" message="tns:EntityPermissionGetByEntityResponse"/>
</wsdl:operation>
<wsdl:operation name="EntityGet">
<wsdl:input name="EntityGetRequest" message="tns:EntityGetRequest"/>
<wsdl:output name="EntityGetResponse" message="tns:EntityGetResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="PermissionV1" type="tns:PermissionV1">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
Version 12.0
Januar 2015
Side 28 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
<wsdl:operation name="EntityPermissionGet">
<soap:operation soapAction="urn:oio:bbr:wsdl:1.0.0:#EntityPermissionGet" style="document"/>
<wsdl:input name="EntityPermissionGetRequest">
<soap:body parts="request" use="literal"/>
</wsdl:input>
<wsdl:output name="EntityPermissionGetResponse">
<soap:body parts="response" use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="EntityPermissionGetByEntity">
<soap:operation soapAction="urn:oio:bbr:wsdl:1.0.0:#EntityPermissionGetByEntity" style="document"/>
<wsdl:input name="EntityPermissionGetByEntityRequest">
<soap:body parts="request" use="literal"/>
</wsdl:input>
<wsdl:output name="EntityPermissionGetByEntityResponse">
<soap:body parts="response" use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="EntityGet">
<soap:operation soapAction="urn:oio:bbr:wsdl:1.0.0:#EntityGet" style="document"/>
<wsdl:input name="EntityGetRequest">
<soap:body parts="request" use="literal"/>
</wsdl:input>
<wsdl:output name="EntityGetResponse">
<soap:body parts="response" use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="PermissionV1">
<wsdl:port name="PermissionV1" binding="tns:PermissionV1">
<soap:address location=""/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
Version 12.0
Januar 2015
Side 29 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.8 Snitflader som BBR kalder
Snitflade
GST – SFE numre m.m.
GST – aflevering af adressehændelser
GST – geodata til Bygninger, Teknisk anlæg og
Adresser
ESR - hændelser
ESR – hentning af ejeroplysninger/ ejendomsoplysninger m.m.
ESR – aflevering af adressehændelser
Plansystem.dk
BOSSINF
CPR – hentning af ejeroplysninger
OIS – hentning af ejeroplysninger
AWS – hentning af adressesata
DAR
Certificeringscenter
Data
BBR henter SFE nummer og geografisk sammenhæng i forbindelse med vedligeholdelse af matrikulære data.
Når der sker ændringer i adgangsadresser eller
enhedsadresser i BBR, kaldes en webservice hos
GST med de ændrede adresser.
For tekniske anlæg, bygninger:
- BBR henter koordinater til en matrikel
- BBR henter matrikel til givne koordinater
BBR henter hændelser vedr. matrikelopdateringer/
ejerskifte m.m. fra ESR
BBR henter ejeroplysninger/ ejerlejlighedsoplysninger/ ejerforholdskode/ ejendomsoplysninger
m.m. i ESR
Når der sker ændringer i adgangsadresser eller
enhedsadresser i BBR, kaldes en webservice hos
ESR med de ændrede adresser.
Der leveres også ejendomsadresser til ESR.
BBR henter planoplysninger i plansystem.dk
Snitfladen er ikke implementeret.
BBR henter ejeroplysninger i CPR
BBR henter ejeroplysninger i OIS
BBR henter adressedata via AWS.
BBR kalder DAR for at oprette og slette adresser.
Denne snitflade bruges i forbindelse med autentifikation af brugere ved logon med certifikat (medarbejder-, funktions- og virksomhedscertifikater).
1.8.1 BBR – GST
1. Webservice – GSH-oplysninger fra GST
Klient BBR
Server GST
Beskrivelse: Webservicen skal ud fra en matrikelidentifikation returnere en liste med samtlige
matrikelidentifikationer og deres geografiske sammenhæng for den samlede faste ejendom, som
den kaldende matrikelidentifikation indgår i.
Inputparametre: Landsejerlavskode, Matrikelnummer
Outputparametre:
Version 12.0
Januar 2015
Side 30 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
En liste af nedenstående data for samtlige matrikler for den samlede faste ejendom, som den kaldende matrikelidentifikation indgår i:
Landsejerlavskode
Matrikelnummer
SFE nummer
GSHkode (Geografisk SammenHængskode), GSHkode en entydig kode for de matrikelnumre der
er geografisk sammenhængende indenfor en samlet fast ejendom. Koden genereres af GST.
Entitet: Grund, matrikel
Attributter:
Betingelse: Matrikel skal eksistere
Resultat:
Implementering: GST udstiller en webservice
Sikkerhed:
Fejlhåndtering:
Vurderingsparametre:
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Ingen dataredundans
Status: Webservice er implementeret.
2. Ajourføring af adressedata – GST
Klient BBR
Server GST
Beskrivelse: Overfører adressedata til GST ved oprettelse, ændring eller sletning af adgangsadresser og enhedsadresser. Når der sker ændringer i adgangsadresser eller enhedsadresser i
BBR, kaldes en webservice hos GST med de ændrede adresser.
Inputparametre: OIO adressestrukturerne (som defineret på digitaliser.dk):
AddressAccessCreatedRequestStructure
AddressAccessUpdatedRequestStructure
AddressAccessDeletedRequestStructure
AddressSpecificCreatedRequestStructure
AddressSpecificUpdatedRequestStructure
AddressSpecificDeletedRequestStructure
Outputparametre: OIO adressestrukturerne (som defineret på digitaliser.dk):
AddressAccessCreatedResponseStructure
AddressAccessUpdatedResponseStructure
AddressAccessDeletedResponseStructure
AddressSpecificCreatedResponseStructure
AddressSpecificUpdatedResponseStructure
AddressSpecificDeletedResponseStructure
Entitet: AdgangsAdresse og EnhedsAdresse
Entitet: AdgangsAdresse og EnhedsAdresse
Attributter: Alle attributter på AdgangsAdresse og EnhedsAdresse
Attributter: Alle attributter på AdgangsAdresse
og EnhedsAdresse
Betingelse: Alle ændringer på endelige og nye
foreløbige adgangsadresser og enhedsadresser
Version 12.0
Januar 2015
Side 31 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
overføres. Ændringer på sagsadresser overføres
IKKE.
Resultat: adgangsadressen eller enhedsadressen bliver oprettet, ændret eller slettet.
Implementering: GST udstiller en webservice.
Sikkerhed: IP beskyttelse.
Fejlhåndtering: Hvis kaldet går godt, returnerer serveren fejlkode 0. Alt andet opfattes af klienten (BBR) som en fejl, og klienten prøver at
sende opdateringen af sted igen efter et aftalt
mønster.
Vurderingsparametre:
Isolation/Uafhængighed: Hvis GSTs webservice
er nede, prøver BBR at sende hændelsen af sted
igen efter et aftalt mønster. Opdateringen af
adressen i BBR går godt.
On-line tilgængelighed: Operationen er tidstro –
bortset fra, hvis der opstår fejl og hændelser må
”gensendes”.
Svartider: Kaldet mod GST webservicen er ”afkoblet” fra opdateringen af adressen i BBR, så
det vil ikke påvirke svartiderne i BBR.
Synkronisering: Ingen synkroniseringsproblemer
Kompleksitet: Simpel
Logistik: Aftalt med GST
Overholdelse af Kontrakten: Krav 5.1.8
Kommentarer:
Status: Denne webservice sættes i drift 15/12 2010.
3. Hentning af matrikelkoordinater
Klient BBR
Server GST
Beskrivelse: Leverer koordinaterne til en matrikel (centroid punkt)
Inputparametre: Kommunenummer, Matrikelbetegnelse
Outputparametre: Matrikelkoordinater, samt angivelse af nøjagtighedsklasse (”B”), Teknisk
standard (”UF”), kilde til geometri (”2”), revisionsdato (”dagsdato”), retning (”200”) og placering
(”5”).
Entitet: Matrikel, Bygning, Teknisk anlæg
Entitet: Matrikel
Attributter: Matrikelkoordinater
Attributter: Matrikelkoordinater
Betingelse: Matriklen skal eksistere
Resultat: Teknisk anlæg eller bygning får opdateret koordinater med værdierne fra GST.
Implementering: GST udstiller en webservice
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Hvis GSTs webservice
er nede kan ajourføringen kan ikke gennemføres
Version 12.0
Januar 2015
Side 32 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
On-line tilgængelighed: Operationen er tidstro
Svartider: Der vil være et overhead i form af et
kald til et eksternt system
Synkronisering: Ingen synkroniseringsproblemer
Kompleksitet: Simpel
Logistik: Aftales med GST
Overholdelse af Kontrakten: Krav 5.1.4, 2.
punkt
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Ingen dataredundans (idet koordinater kan
opdateres via oioxml-snitfladerne).
Status: Webservice er implementeret.
4. Søgning på matrikel i GST ud fra bygnings/anlægs-koordinater
Klient BBR
Server GST
Beskrivelse: Henter matrikel i GST på basis af bygningskoordinater eller teknisk anlægskoordinater
Inputparametre: Kommunenummer, bygningskoordinater
Outputparametre: Liste af matrikler indenfor koordinaterne
Entitet: Bygninger, tekniske anlæg
Entitet: Matrikel
Attributter:
Attributter: Matrikelbetegnelsen
Betingelse: Bygningskoordinater/Anlægskoordinater skal eksistere
Resultat: Matrikeloplysninger er hentet
Implementering: GST udstiller en webservice
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Hvis BBR er nede kan
forespørgslen ikke gennemføres
On-line tilgængelighed: Operationen er tidstro
Svartider
Synkronisering: Ingen synkroniseringsproblemer
Kompleksitet: Simpel
Logistik: Aftales med BBR
Overholdelse af Kontrakten: Krav 5.1.4
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Ingen dataredundans
Status: Webservice er implementeret.
1.8.2 BBR - ESR
Der kommunikeres med ESR på 3 forskellige måder:
Version 12.0
Januar 2015
Side 33 af 55
Systembeskrivelse kapitel 6 - Dataudveksling

Online opslag som henter ”hændelser” fra ESR (snitflade 1 til 10).
Når der sker opdateringer i ESR, som har betydning for BBR, stiller ESR disse
opdateringer til rådighed via en hændelsestabel, som BBR kan læse i via en
webservice. BBR sørger for, at BBR’s data opdateres med disse ændringer.
Som eksempel kan nævnes, at der oprettes eller opdateres grunde i BBR som
konsekvens af oprettelse eller sletning af matrikler i ESR. Et andet eksempel
er bestilling af BBR-Meddelelser ved ejerskifte i ESR.
Disse hændelser/snitflader er beskrevet i afsnit 6.5.3.1.

Online opslag som henter oplysninger fra ESR (snitflade 11 til 16)
I forbindelse med sagsbehandling i BBR hentes der online ESR-oplysninger.
Som eksempel kan nævnes, at der hentes BBR oplysninger i forbindelse med
skærmbilledet ”Ejendomsoversigten”. Disse kald er beskrevet i afsnit 6.5.3.2.

Online opslag som sender oplysninger til ESR (snitflade 17)
Adresseopdateringer i BBR har betydning for ESR. Derfor sendes disse opdateringer til ESR. Dette kald er beskrevet i afsnit 6.5.3.3.
On-line opslag som henter hændelser fra ESR
1) Opdatering af ejerforholdskode i ESR
2) Ejerskifte
3) Opdatering af etagemeter (tinglyst areal) i ESR
4) Oprettelse af matrikel i ESR
5) Sletning af matrikel i ESR
6) Flytning af matrikler i ESR
7) Approbationer i ESR
8) Opdatering af ejerlavskoder og –tekster i ESR
9) Ret udskrivningsmatrikel i ESR
10) Ret GST_SFENR i ESR
Online opslag som henter oplysninger fra ESR
11) Hent ejerforholdskode i ESR
12) Hent CPRnr/CVRnr/løbenr og alternativ adresse
13) Hent ejerlejligheds-oplysninger
14) Hent ejendomsoplysninger fra ESR til Ejendomsoversigten i BBR
15) Hent markering for ejerlejlighedsmatrikler fra ESR til BBR
Online opslag som sender oplysninger til ESR
Version 12.0
Januar 2015
Side 34 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Ajourføring af adressedata
1.8.2.1 Online opslag, som henter hændelser fra ESR
1. Opdatering af ejerforholdskoden i ESR
Klient BBR
Server ESR
Beskrivelse:
Opdatering af oplysninger om opdaterede ejerforholdskoder i ESR.
Når der ændres i ejerforholdskoden på en ejendom skal ESR gøre oplysningerne tilgængelige for
BBR.
Der er 3 hændelsestyper inden for opdatering af ejerforholdskoden i ESR:

001: ret ejerforholdskode i forbindelse med opret ejer

002: ret ejerforholdskode i forbindelse med historisk ejer

003: ret ejerforholdskode i forbindelse med ret ejer
Inputparametre: Outputparametre: (det er de samme outputparametre ved de 3 hændelsestyper)
MessageType
Kommunenummer
Ejendomsnr
EjerlejlighedsEjdnr
EjendomsRef
Entitet: Grund, Bygning, Teknisk anlæg, enhed
Entitet: Ejer
Attributter: Ejerforholdskode
Attributter: Kommunenummer, Ejerforholdskode, Ejendomsnummer, Ejendomsreference,
Betingelse:
Resultat: Oplysninger giver mulighed for at
opdatere BBR, således at grunden opdateres
med den nye ejerforholdskode. Er der tale om
en moderejendom for ejerlejligheder skal ejerforholdet registreres for de pågældende ejerlejligheder (jf. krav 5.4.2)
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: BBR kan fungere selv
om ESR er nede og ejerforholdskoden ikke er
opdateret. ESR kan fungere selv om BBR er
nede.
On-line tilgængelighed: Operationen er asynkron.
Svartider: Intet overhead
Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: Krav 5.4.3
Version 12.0
Januar 2015
Side 35 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
Status: Webservice er implementeret.
2. Ejerskifte i ESR
Klient BBR
Server ESR
Beskrivelse:
Ejerskifte i ESR
Når der foretages ejerskifte i ESR, skal ESR gøre oplysningerne tilgængelig for BBR, da det skal
medføre en udskrivning af en BBR-Meddelelse.
Der er 2 hændelsestyper inden for opdatering af ejerskifte i ESR:

501: ejerskifte

502: ejerskifte i forbindelse med historisk ejer
Inputparametre: Outputparametre:
MessageType
Kommunenummer
Ejendomsnr
EjendomsRef
Dcprcir
Entitet: Ejendom, Grund, Bygning (ejerlejlighed), Enhed (ejerlejlighed)
Entitet: Ejendom (ejerlejlighed)
Attributter:
Attributter: Kommunenummer, Ejendomsnummer, Ejendomsreference
Betingelse: Ejerskab skal eksistere
Resultat: BBR skal gøre klar til udskrivning af
en BBR-Meddelelse (med årsag ”ejerskifte”)
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: BBR kan fungere selv
om ESR er nede og ejerforholdskoden ikke er opdateret. ESR kan fungere selv om BBR er nede.
On-line tilgængelighed: Operationen er asynkron.
Svartider: Intet overhead
Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: Krav 7.1, 7.7
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
Version 12.0
Januar 2015
Side 36 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Status: Webservice er implementeret.
3. Opdatering af etagemeter (tinglyst areal) i ESR
Klient BBR
Server ESR
Beskrivelse:
Opdatering af oplysninger om etagemeter i ESR.
Når der opdateres i etagemeter (som svarer til feltet ”tinglyst areal” i BBR) skal ESR gøre oplysningen
tilgængelig for BBR.
Der er 1 hændelsestype inden for opdatering af etagemeter (tinglyst areal) i ESR:

101: ret etagemeter
Inputparametre: Outputparametre:
MessageType
Kommunenummer
EjerlejlighedsEjdnr
Artskode
EjendomsRef
Etagemeter
Entitet: Enhed (Ejerlejlighed)
Entitet: Ejendom (Ejerlejlighed)
Attributter: Tinglyst areal
Attributter: Kommunenummer, Ejerlejlighedens
Ejendomsnummer, Ejendomsreference, Etagemeter
Betingelse:
Resultat: Oplysninger giver mulighed for at opdatere BBR-feltet ”tinglyst areal” med etagemeter
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: BBR kan fungere selv om
ESR er nede og tinglyst areal ikke er opdateret.
ESR kan fungere selv om BBR er nede.
On-line tilgængelighed: Operationen er asynkron.
Svartider: Intet overhead
Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: Krav 5.4.5
Version 12.0
Januar 2015
Side 37 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Kommentarer: Kommunen vil under Systemadministration kunne vælge om oplysningen om tinglyst areal skal vises i BBR.
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
Status: Webservice er implementeret.
4. Oprettelse af matrikel i ESR
Klient BBR
Server ESR
Beskrivelse:
ESR opretter en matrikel. Dette skal BBR har besked om så tilsvarende matrikel automatisk oprettes
i BBR.
Der er 1 hændelsestype inden for opret matrikel i ESR:

201: opret matrikel
Inputparametre: Outputparametre:
MessageType
Kommunenummer
Ejendomsnr
Ejerlavskode
Matrikelnr
Matrikelbogstav
Delnr
Ejerlejlighedsnr
Opdelingsnr
Artskode
Udskrivningsmatr
Matrikel_id
Kms_sfenr
Entitet: Grund, matrikel
Entitet: Ejendom, matrikel
Attributter: Fuld matrikelbetegnelse
Betingelse: Ejendommen skal eksistere
Resultat: Oplysninger giver mulighed for at opdatere BBR med nye matrikler
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: BBR kan fungere selv om
ESR er nede og matriklen ikke er opdateret. ESR
kan fungere selv om BBR er nede.
On-line tilgængelighed: Operationen er asynkron.
Svartider: Intet overhead
Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron
Version 12.0
Januar 2015
Side 38 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: en følge af brug af
ESR-matriklen (krav 5.1.1, 51.2, allonge 1, ændringsbilag 32 og 37, se beskrivelse i afsnit 6.1.2)
Kommentarer:
Kommentarer:
Hvis oplysningerne ikke sendes fra ESR når de
opstår, vil det på ejendomme/grunde som allerede er oprettet i BBR, ikke være muligt at placere bygninger på disse matrikler, da matriklerne ikke vil komme til BBR’s kendskab.
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
Status: Webservice er implementeret.
5. Sletning af matrikel i ESR
Klient BBR
Server ESR
Beskrivelse:
ESR sletter en matrikel. Dette skal BBR have besked om så evt. tilsvarende matrikel kan slettes i
BBR.
ESR tjekker i KRR om der er bygninger på matriklen (senere skal der tjekkes op mod BBR).
Hvis der er bygninger på matriklen kan sletningen ikke gennemføres.
Hvis der ikke er bygninger på matriklen gennemføres sletningen og der lægges en hændelse i
hændelsesregisteret.
Der er 1 hændelsestype inden for slet matrikel i ESR:

301: slet matrikel
Inputparametre: Outputparametre:
MessageType
Kommunenummer
Ejendomsnr
Ejerlavskode
Matrikelnr
Matrikelbogstav
Delnr
Ejerlejlighedsnr
Opdelingsnr
Artskode
Udskrivningsmatr
Matrikel_id
Entitet: Grund, matrikel
Entitet: Ejendom, matrikel
Attributter: Fuld matrikelbetegnelse
Betingelse: Ejendommen skal eksistere
Resultat: Oplysninger giver mulighed for at
slette matrikler i BBR
Resultat: Readonly
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Version 12.0
Januar 2015
Side 39 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: BBR kan fungere selv
om ESR er nede og matriklen ikke er opdateret.
ESR kan fungere selv om BBR er nede.
On-line tilgængelighed: Operationen er asynkron.
Svartider: Intet overhead
Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: en følge af brug af
ESR-matriklen (krav 5.1.1, 51.2, allonge 1, ændringsbilag 32 og 37, se beskrivelse i afsnit
6.1.2)
Kommentarer:
Kommentarer:
BBR skal have faciliteter til at flytte en bygning
fra en matrikel til en anden. Denne facilitet
skal implementeres i BBR under alle omstændigheder. Bygningens placering skal synkroniseres til KRR.
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
Status: Webservice er implementeret.
6. Flytning af matrikler i ESR
Klient BBR
Server ESR
Beskrivelse: Der flyttes matrikler mellem to ejendomme i ESR.
Det laves mod BBR som opret og slet af matrikel, se pkt. 5 ”Sletning af matrikler i ESR”.
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
7. Approbationer i ESR
Klient BBR
Server ESR
Beskrivelse:
De foreløbige matrikler oprettes i BBR på linje med almindelige matrikler. Se ”opretning af ny matrikel”.
Når approbationen er gennemført laves en opretning af matriklen, og en sletning af den foreløbige
matrikel. Se pkt. 4 ”Oprettelse af matrikel i ESR” og pkt. 5 ”Sletning af matrikler i ESR”.
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
8. Opdatering af ejerlavskoder og –tekster i ESR
Klient BBR
Version 12.0
Januar 2015
Server ESR
Side 40 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Beskrivelse:
ESR opdaterer i ejerlavskoder og –tekster. Følgende skal gøres tilgængelig for BBR:

Oprettelse af eller ændring i landsejerlavskode

Oprettelse af eller ændring i landsejerlavstekst

Oprettelse af eller ændring i kommunal ejerlavskode
Der er 3 hændelsestyper inden for opdatering af ejerlavskoder og –tekster i ESR:

401: ret ejerlavskode og –tekster

402: opret ejerlavskode og –tekster

403: slet ejerlavskode og -tekster
Inputparametre: Outputparametre:
MessageType
Gl_Kommunenummer
Gl_Landsejerlavskode
Gl_Landsejerlavstekst
Gl_KomEjerlavskode
Gl_KomEjerlavstekst
Ny_kommunenummer
Ny_landsejerlavskode
Ny_landsejerlavstekst
Ny_ejerlavskode
Ny_ejerlavstekst
Entitet: Landsejerlav, kommunalt ejerlav
Attributter: Landsejerlavskode, landsejerlavstekst, kommunal ejerlavskode
Betingelse:
Resultat: Oplysninger giver mulighed for at opdatere BBR med landsejerlavskode, landsejerlavstekst og kommunale ejerlav
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: BBR kan fungere selv
om ESR er nede og ejerlavet ikke er opdateret.
ESR kan fungere selv om BBR er nede.
On-line tilgængelighed: Operationen er asynkron.
Svartider: Intet overhead
Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: Krav 5.1.2
Kommentarer: Første gangs indlæsning i BBR
skal ske via konverteringen.
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
Status: Webservice er implementeret.
Version 12.0
Januar 2015
Side 41 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
9. Ret udskrivningsmatrikel i ESR
Klient BBR
Server ESR
Beskrivelse:
Opdaterer oplysninger om udskrivningsmatriklen i ESR.
Der er 1 hændelsestype inden for ret udskrivningsmatrikel i ESR:

102: ret udskrivningsmatrikel
Inputparametre: Outputparametre:
MessageType
Kommunenummer
Ejendomsnr
Ejerlavskode
Matrikelnr
Matrikelbogstav
Delnr
Ejerlejlighedsnr
Opdelingsnr
Artskode
Udskrivningsmatr
Matrikel_id
Kms_sfenr
Entitet: Enhed (Ejerlejlighed)
Entitet: Matrikel
Attributter: Tinglyst areal
Attributter: Kommunenummer, Ejerlejlighedens
Ejendomsnummer, Ejendomsreference, Etagemeter
Betingelse:
Resultat: Oplysninger giver mulighed for at
opdatere BBR-feltet ”tinglyst areal” med etagemeter
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: BBR kan fungere selv
om ESR er nede og tinglyst areal ikke er opdateret. ESR kan fungere selv om BBR er nede.
On-line tilgængelighed: Operationen er asynkron.
Svartider: Intet overhead
Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten:
Version 12.0
Januar 2015
Side 42 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Kommentarer: Kommunen vil under Systemadministration kunne vælge om oplysningen om
tinglyst areal skal vises i BBR.
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
Status: Webservice er implementeret.
10. Ret GST_SFENR i ESR
Klient BBR
Server ESR
Beskrivelse:
Opdaterer oplysninger om GST_SFENR i ESR.
Der er 1 hændelsestype inden for ret GST_SFENR i ESR:

103: ret KMS_SFENR
Inputparametre: Outputparametre:
MessageType
Kommunenummer
Ejendomsnr
Ejerlavskode
Matrikelnr
Matrikelbogstav
Delnr
Ejerlejlighedsnr
Opdelingsnr
Artskode
Udskrivningsmatr
Matrikel_id
Kms_sfenr
Entitet: Enhed (Ejerlejlighed)
Entitet: Matrikel
Attributter: Tinglyst areal
Attributter: Kommunenummer, Ejerlejlighedens
Ejendomsnummer, Ejendomsreference, Etagemeter
Betingelse:
Resultat: Oplysninger giver mulighed for at
opdatere BBR-feltet ”tinglyst areal” med etagemeter
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: BBR kan fungere selv
om ESR er nede og tinglyst areal ikke er opdateret. ESR kan fungere selv om BBR er nede.
On-line tilgængelighed: Operationen er asynkron.
Svartider: Intet overhead
Version 12.0
Januar 2015
Side 43 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten:
Kommentarer: Kommunen vil under Systemadministration kunne vælge om oplysningen om
tinglyst areal skal vises i BBR.
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
Status: Webservice er implementeret.
1.8.2.2 On-line opslag, som henter oplysninger fra ESR
11.
Hent ejerforholdskode i ESR
Klient BBR
Server ESR
Beskrivelse:
Henter oplysninger om ejerforholdskode i ESR.
Når BBR opretter en grund skal ejerforholdskoden hentes i ESR.
Når BBR opretter en enhed, bygning eller teknisk anlæg som er en ejerlejlighed, skal ejerforholdskoden hentes i ESR.
Inputparametre: Kommunenummer, Ejendomsnummer, Ejerlejlighedsejendomsnummer (udfyldes ved artskode 02 og 32), Ejendomsreference
Outputparametre: Kommunenummer, Ejendomsnummer, Ejerlejlighedsejendomsnummer (udfyldes ved artskode 02 og 32), Ejendomsreference, Ejerforholdskode
Entitet: Grund, Bygning, Teknisk anlæg, Enhed (ejerlejlighed)
Entitet: Ejendom
Attributter:
Attributter: Kommunenummer, Ejendomsnummer, Ejerlejlighedsejendomsnummer, Ejendomsreference, Ejerforholdskode
Betingelse: Ejendommen skal eksistere
Resultat: De hentede oplysninger giver mulighed for at opdatere BBR med oplysningerne,
således at grunden opdateres med ejerforholdskode. Er der tale om en moderejendom
for ejerlejligheder skal ejerforholdet registreres
for de pågældende ejerlejligheder (jf. krav
5.4.2)
Implementering: ESR udstiller en service til
hentning af ejerforholdskoden
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Oprettelsen af entiteten kan ikke gennemføres
On-line tilgængelighed: Operationen er tidstro
Svartider: Der vil være et overhead i form af et
kald til et eksternt system
Version 12.0
Januar 2015
Side 44 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Synkronisering: Ingen synkroniseringsproblemer
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: Krav 5.4.1
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe.
Status: Webservice er implementeret.
12.
Hent CPRnr/CVRnr/løbenr og alternativ adresse
Klient BBR
Server ESR
Beskrivelse:
Henter ejers CPRnr/CVRnr/løbenr i forbindelse med udskrivning af fx BBR-Meddelelse. I forbindelse med udlejningsforhold dannes der desuden et udtræk, der skal sammenholdes med udtræk
fra CPR.
Inputparametre: Kommunenummer, Ejendomsnummer, Ejertype (altid ”a”)
Outputparametre: Liste af Ejeres CPR-numre eller CVR-numre eller løbenr samt alternativ
adresse. Samt om adressen er adressebeskyttet. Markering for administrator eller ejer. Ejertype
(kun for ejere). Administratorkode (kun for adminstratorer)
Entitet: Bygning, enhed
Entitet: Ejer, ejendom
Attributter:
Attributter: CPRnr eller CVRnr eller løbenr og
alternativ adresse
Betingelse: Ejendommen skal eksistere
Resultat: Liste af ejere.
Der kan kaldes videre til OIS for at få navn og
adresse til adressering af fx BBR-Meddelelser.
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Udskrivningen af ejermeddelelse kan ikke gennemføres/ajourføringen
af Udlejningskode kan ikke gennemføres
On-line tilgængelighed: Operationen er tidstro
Svartider: Der vil være et overhead i form af et
kald til et eksternt system
Synkronisering: Ingen synkroniseringsproblemer
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: krav 7.2, EBST nota
med ændringer til krav 5.3
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Ingen dataredundans
Status: Webservice er implementeret.
Version 12.0
Januar 2015
Side 45 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
13) Hent ejerlejligheds-oplysninger
Klient BBR
Server ESR
Beskrivelse:
Ved oprettelse af en ejerlejlighed hentes ejerlejlighedsoplysninger fra ESR. Samtidig kontrolleres
det at ejerlejligheden eksisterer i ESR
Inputparametre: Kommunenummer, matrikelnummer, ejerlejlighedsejendomsnr.
Outputparametre: Ejerlejlighedsnr., etagemeter, ejerforholdskode, liste af matrikelbetegnelser
Entitet: Enhed, Bygning, Teknisk Anlæg
Entitet: Ejendom, matrikel
Attributter: Fuld matrikelbetegnelse, etagemeter, ejerforholdskode
Betingelse: Ejendommen skal eksistere
Resultat: Enheden (ejerlejligheden) kan opdateres med aktuelle ejerlejlighedsoplysninger.
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Oprettelse af grund
kan ikke gennemføres
On-line tilgængelighed: Operationen er tidstro
Svartider: Der vil være et overhead i form af et
kald til et eksternt system
Synkronisering: Ingen synkroniseringsproblemer
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: Krav 5.4.5
Kommentarer: Matrikelbetegnelsen skal ikke
benyttes direkte i BBR, men videre i synkroniseringen med KMD-BBR (og KKR).
Kommentarer:
Hvis der i BBR flyttes en bygning – indeholdende ejerlejligheder - fra en matrikel til en anden matrikel skal der på ny hentes oplysninger
om ejerlejligheden.
Håndtering af redundante data vs. opdaterede data: Publish/Subscribe
Status: Webservice er implementeret.
14) Hent ejendomsoplysninger fra ESR til Ejendomsoversigten i BBR
Klient BBR
Server ESR
Beskrivelse:
Ved dannelse af Ejendomsoversigten hentes matrikeloplysninger i ESR.
Inputparametre:
Kommunenummer
Ejendomsnr.
Landsejerlavskode
Ejerlavskode
Version 12.0
Januar 2015
Side 46 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Matrikelnr
Matrikelbogstav
Delnr
Opdelingsnr
Artskode
Outputparametre:
Returkode
Systemkode
Tekst
Ejerlavskode
Matrikelnr
Matrikelbogstav
Delnr
Opdelingsnr
Artskode
Zonestatus
Cnote (noteringskode)
Udskrivningsmatr
Fmatar (matrikelareal)
Fvej (Heraf vejareal)
Fdivar (Diverse areal)
Plantype
Plantypetekst
Plannr
Plannavn
Entitet: Grund
Entitet: Matrikel
Attributter:
Betingelse: Ejendommen skal eksistere
Resultat:
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Oprettelse af grund
kan ikke gennemføres
On-line tilgængelighed: Operationen er tidstro
Svartider: Der vil være et overhead i form af et
kald til et eksternt system
Synkronisering: Ingen synkroniseringsproblemer
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: Appendiks 1 i Allonge 1 - ”Ekstra krav” og ”Ejendomsoplysninger”.
Kommentarer:
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Ingen dataredundans
Status: Webservice er implementeret.
Version 12.0
Januar 2015
Side 47 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
15) Hent markering for ejerlejlighedsmatrikler fra ESR til
BBR
Klient BBR
Server ESR
Beskrivelse:
Hent markering for ejerlejlighedsmatrikler fra ESR til BBR
Inputparametre:
Kommunenummer
Ejendomsnr
Ejerlavskode
Matrikelnr
Matrikelbogstav
Delnr
Ejerlejlighedsnr
Opdelingsnr
Artskode
Outputparametre:
Matrikelmarkering
Returkode
Systemkode
Tekst
Entitet: Grund
Entitet: Matrikel
Attributter:
Betingelse: Ejendommen skal eksistere
Resultat:
Implementering: ESR udstiller en service
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Oprettelse af grund
kan ikke gennemføres
On-line tilgængelighed: Operationen er tidstro
Svartider: Der vil være et overhead i form af et
kald til et eksternt system
Synkronisering: Ingen synkroniseringsproblemer
Kompleksitet: Simpel
Logistik: Aftales med KMD/ESR
Overholdelse af Kontrakten: Appendiks 1 i Allonge 1 - ”Ekstra krav” og ”Ejendomsoplysninger”.
Kommentarer:
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Ingen dataredundans
Status: Webservice er implementeret.
Version 12.0
Januar 2015
Side 48 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.8.2.3 On-line opslag, som sender oplysninger til ESR
16) Ajourføring af adressedata – ESR
Klient BBR
Server ESR
Beskrivelse:
Overfører adressedata til ESR ved oprettelse af, eller ændring af adgangs- eller enhedsadresse
Inputparametre: Kommunenummer, Matrikelnummer, Ejendomsnummer, adresse (adgangseller enhedsadresse)
Outputparametre: OK
Entitet:
Entitet: Adgangs- og Enhedsadresse
Attributter:
Attributter:
Betingelse:
Resultat: ESR adressedata opdateres
Implementering: ESR udstiller en webservice
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Hvis ESRs webservice
er nede kan ajourføringen ikke gennemføres
On-line tilgængelighed: Operationen er tidstro
Svartider: Der vil være et overhead i form af et
kald til et eksternt system
Synkronisering: Ingen synkroniseringsproblemer
Kompleksitet: Simpel
Logistik: Aftales med ESR
Overholdelse af Kontrakten: Krav 5.1.8
Kommentarer:
Håndtering af redundante data vs. opdaterede data: Opdatering fra databærende system
Status: Webservice er implementeret.
Version 12.0
Januar 2015
Side 49 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.8.3 BBR – plansystemDK
BBR henter planoplysninger ved plansystemDK.
Klient BBR
Server PlansystemDK
Beskrivelse:
Ved dannelse af skærmbilledet ”ejendomsoversigten” hentes planoplysninger i PlansystemDK.
http://matplan.plansystem.dk/pdk2mat/MatPlan
Inputparametre: landsEjerlavsKode + matrikelnummer
Outputparametre: et antal planer med angivelse af plannavn, id, status og type
Entitet:
Entitet:
Attributter:
Attributter:
Betingelse:
Resultat:
Implementering:
Der kaldes en webservice ved PlansystemDK.
Sikkerhed:
Fejlhåndtering:
Selv om webservicen til PlansystemDK fejler, vil
ejendomsoversigten i BBR blive vist, dog vises
den uden planoplysninger fra PlansystemDK.
Hvis webservicen til PlansystemDK fejler, vil brugeren blive præsenteret for en besked (”Der
kunne ikke hentes data fra PlansystemDK”).
Vurderingsparametre:
Kommentarer:
Status:
Webservice er implementeret.
1.8.4 BBR – Bossinf-STB
Det har været meningen, at kode for offentlig støtte skulle overføres til BBR.
Snitfladen er dog ikke blevet implementeret.
Klient BBR
Server Bossinf
Beskrivelse:
Opdatering af kode for offentlig støtte i BBR
Inputparametre:
Outputparametre: Offentlig støtte (ja/nej)
Entitet: Enhed
Entitet: Ejendom
Attributter: offentlig støtte
Attributter: Offentlig støtte
Betingelse: Enheden skal eksistere
Resultat: Enheden opdateres med den angivne kode
Implementering: Bossinf udstiller en hændelsestabel som BBR tilgår via en webservice.
Version 12.0
Januar 2015
Side 50 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Sikkerhed: Autentificering er nødvendig
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: BBR kan fungere selv
om Bossinf er nede og offentlig støtte ikke er
opdateret. Bossinf kan fungere selv om BBR er
nede.
On-line tilgængelighed: Operationen er ikke
nødvendigvis tidstro, afhængig af implementering
Synkronisering: Der kan være synkroniseringsproblemer, hvis opdateringen ikke er
tidstro
Kompleksitet: Simpel
Overholdelse af Kontrakten: Krav 6.2.1.4
Kommentarer: Koden overføres ikke til KMDBBR i dag.
To Do: KOMBIT afklarer med Bossinf om overførslen
Version 12.0
Januar 2015
Side 51 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.8.5 BBR – CPR
BBR henter navn og adresse ud fra et CPR nummer.
Klient BBR
Server CPR
Beskrivelse: I forbindelse med adressering af bl.a. BBR-Meddelelse skal man bruge ejerens navn
og adresse.
Inputparametre: CPR-nummer
Outputparametre: Navn og Adresse
Entitet: Flere
Entitet: Flere
Attributter:
Attributter: Navn og Adresse
Betingelse:
Resultat: Mulighed for at påtrykke navn og
adresse på bl.a. BBR-Meddelelse.
Sikkerhed: Autorisation ud fra brugernavn og
password.
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Hvis man ikke kan foretage opslaget, så er det ikke muligt at få ”oversat” CPRnr og dermed ikke muligt at adressere
bl.a. BBR-Meddelelse.
On-line tilgængelighed: Ikke nødvendigvis tidstro.
Svartider: I forbindelse med masseudskrivninger
er svartiden kritisk.
Synkronisering: Nej
Kompleksitet: Nej
Logistik: KOMBIT stiller snitfladerne til rådighed.
Overholdelse af Kontrakten:
Kommentarer: Servicen benyttes kun hvis der
er adressebeskyttelse (da navn og adresse da
ikke kan leveres fra OIS) eller det ikke er ejeren
man skal adressere til.
To Do:
To Do: KOMBIT aftaler med CPR.
Håndtering af redundante data vs. opdaterede data: Ingen dataredundans
Status: Webservice er implementeret.
1.8.6 BBR – OIS
Hentning af navn og adresse ud fra kommunenummer og ejendomsnummer.
Klient BBR
Server OIS
Beskrivelse: I forbindelse med adressering af bl.a. BBR-Meddelelse skal man bruge ejerens navn
og adresse.
Inputparametre: Kommunenummer, ejendomsnummer og CPRnr/CVRnr/løbenr
Version 12.0
Januar 2015
Side 52 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
Outputparametre: Liste af ejere med følgende pr. ejer: navn, adresse, CPRnr/CVRnr/løbenr.,
adressebeskyttelse, markering for administrator eller ejer, ESR-ejer status (0,1,2,3))
Entitet: Flere
Entitet: Flere
Attributter:
Attributter: Kommunenummer og ejendomsnummer
Betingelse:
Resultat: Liste af ejere som kan sammenlignes
med det CPRnr/CVRnr som der skal sendes fx
BBR-Meddelelse til. Sammenligningen munder ud
i at der kan påtrykkes navn og adresse på bl.a.
BBR-Meddelelse.
Sikkerhed: Ingen
Fejlhåndtering: En fejlkode til klienten
Vurderingsparametre:
Isolation/Uafhængighed: Hvis man ikke kan foretage opslaget, så er det ikke muligt at finde frem
til navn og adresse, og dermed ikke muligt at
adressere bl.a. BBR-Meddelelse.
On-line tilgængelighed: Ikke nødvendigvis tidstro.
Svartider: I forbindelse med masseudskrivninger
er svartiden kritisk.
Synkronisering: Nej
Kompleksitet: Nej
Logistik: KOMBIT stiller snitfladerne til rådighed.
Overholdelse af Kontrakten:
Kommentarer:
To Do:
To Do: KOMBIT aftaler med OIS.
Håndtering af redundante data vs. opdaterede data: Ingen dataredundans
Status: Webservice er implementeret.
1.8.7 BBR - AWS
BBR har brug for at opretholde en kopi af adressedata.
BBR henter adresse data fra AWS Suiten. Dette gøres ved hjælp af AWS Suitens
replikerings API. En service kaldet AWS Suiten, og får de seneste adressehændelser og opdateret BBR hermed.
Muligheden implementeres ved at benytte den eksisterende snitflade, som AWS
udstiller. Se mere under følgende link http://dawa.aws.dk/replikeringdok.
1.8.8 BBR – DAR
BBR kalder en snitflade hos DAR for at oprette og slette adresser:
1) AdresseOpret
Når enheder oprettes i BBR med en enhedsadresse, som ikke findes i forvejen, skal DAR kaldes for at oprette adressen, hvis brugeren har den
nødvendige rolle.
Version 12.0
Januar 2015
Side 53 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
BBR kalder DAR via en intern service med den nye enheds adresse. Hvis
adressen ikke findes i forvejen, opretter DAR adressen og returnerer en
”OK” besked. Findes adressen allerede returneres en ”OK” besked med
det samme.
1) AdresseSlet
Når enheder slettes i BBR med en enhedsadresse, som ikke benyttes på
andre BBR entiteter, og det ikke er den sidste enhedsadresse til en adgangsadresse, skal DAR slette adressen.
BBR kalder DAR via en intern service med den adresse, som skal slettes.
DAR returnerer ”OK” besked når adressen er slettet.
1.8.9 BBR – Certificeringscenter
Denne snitflade bruges i forbindelse med autentifikation af brugere ved logon
med certifikat (medarbejder-, funktions- og virksomhedscertifikater).
Version 12.0
Januar 2015
Side 54 af 55
Systembeskrivelse kapitel 6 - Dataudveksling
1.9 Periodevise kørsler, dataudtræk mv.
Dette afsnit indeholder en beskrivelse af forskellige faciliteter i BBR til at sikre
datakonsistens mellem systemer, udtræk til andre systemer, samt andre opgaver, der skal udføres periodevis.
1.9.1 Påmindelser ved overskridelse af tidsfrister
Det vil ved en månedlig daglig kørsel blive kontrolleret om tidsfrister for midlertidige tilladelser er overholdt. Hvis ikke vil der, hvis kommunen beder om det (opsætningsparameter), blive afsendt en e-mail til den af kommunen angivne email adresse.
Version 12.0
Januar 2015
Side 55 af 55