Indholdsfortegnelse. Systembeskrivelse kapitel 6 - Dataudveksling

Transkript

1 Indholdsfortegnelse 6. Dataudveksling med andre systemer Kontekstdiagram for BBR Kort om BBR s dataudveksling Vedligeholdelse af matrikulære data i BBR Systemspecifikke snitflader Overordnede betragtninger Skabelon til beskrivelse af systemintegration Udtræk fra BBR Total udtræk (Totalkopi) Udtrækkenes formater Udtræk som BBR leverer Totaludtræk til MBBL BBR Meddelelser til print/e-boks Udtræk til Danmark Statistik Udtræk til Statens Arkiver Udtræk til OIS Data som indlæses i BBR CPR BBR (Opdatering af udlejningsforhold) CPR BBR (Opdatering af Vejregisteret i BBR) E-Boks BBR AWS BBR Snitflader, som BBR udstiller OIOXML-snitflade for bygninger og boliger (Building Dwelling) Hjælpe-OIOXML-snitflader (Permission og Codelist) OIS BBR (Generering af BBR-Meddelelse) Inddataboks (InputBox) Type Supplerende varme Type Matrikulær ændring Type Fysisk flytning" BBR-FIE (energidata ind i BBR) DAR - BBR CPR BBR Eksempel på WSDL erne Snitflader som BBR kalder BBR GST BBR - ESR Online opslag, som henter hændelser fra ESR On-line opslag, som henter oplysninger fra ESR On-line opslag, som sender oplysninger til ESR BBR plansystemdk BBR Bossinf-STB BBR CPR BBR OIS BBR - AWS BBR DAR BBR Certificeringscenter Periodevise kørsler, dataudtræk mv Påmindelser ved overskridelse af tidsfrister Version 12.0 Side 1 af 55

2 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 Side 2 af 55

3 1.1 Kontekstdiagram for BBR Dette diagram illustrerer grafisk BBR s dataudveksling med øvrige systemer. ESR OIS BBR og adresse data samt BBR medd. Ejendomsadresser og adresse data hvis aktuelt. FIE Matrikler og ejeroplysninger Ejeroplysninger CPR Inddataboks Status Energi data Navn, adresse og ejendomsoply. til BBR medd. Opdater udlejningsforhold GST SFE numre og koordinater MBBL/ Skat/ Socialminist eriet Dataudtræk BBR Adresse data BOB data(via OIS udtræk) Adresse data AWS BBR Medd. Print/E-boks Tilmeldingsliste BBR DAR interne services DAR Plansystem. dk BBR data BBR data BBR og adresse data pr. måned Hent certifikater BBR og adresse data pr. år Certificering scenter OIO - BuildingDwe lling DST Statens arkiver Version 12.0 Side 3 af 55

4 1.2 Kort om BBR s dataudveksling GST Geografisk sammenhæng for matrikler, benyttes til dannelse og vedligeholdelse af grunde. (se beskrivelse i underafsnit 6 i afsnit 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. AWS 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 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 Side 4 af 55

5 OIS henter BBR-Meddelelser fra BBR Skattemappen BBR-Meddelelser udsendes via 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 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 Side 5 af 55

6 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 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 Side 6 af 55

7 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 Side 7 af 55

8 1.4 Systemspecifikke snitflader 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 Side 8 af 55

9 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å> Attributter: <Hvilke attributter> Entitet: <Hvilke entiteter arbejdes der på> 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 Side 9 af 55

10 1.5 Udtræk fra BBR Der kan foretages udtræk af landsdækkende BBR-data (såvel stamdata som sagsdata) 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): 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 Version 12.0 Side 10 af 55

11 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 Særlige formater OIS-XML Statens Arkivers formater Eksempler på modtagere Skat MBBL Danmarks Statistik Modtagere OIS Statens Arkiver Udtræk som BBR leverer Modtager Data MBBL/Skat/Socialministeriet BBR leverer totaludtræk. Print/E-boks BBR sender BBR Meddelelser til print/til e-boks Danmarks Statistik BBR leverer BBR og Adresse data Statens Arkiver BBR leverer BBR og Adresse data OIS BBR leverer BBR og Adresse data. Der leveres dagligt et udtræk med ændringer, der er foretaget i BBR siden sidste udtræk Totaludtræk til MBBL BBR leverer totaludtræk til MBBL en gang om året BBR Meddelelser til print/e-boks BBR sender BBR Meddelelser til print/til e-boks en gang om ugen Udtræk til Danmark Statistik BBR leverer totaludtræk til Danmarks Statistik en gang om måneden Udtræk til Statens Arkiver BBR leverer data til Statens Arkiver en gang om året 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 O Opret record Version 12.0 Side 11 af 55

12 AendrtTimestamp OphoertTimestamp R Ændrings record 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 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: Attributter: Entitet: 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 Side 12 af 55

13 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 Side 13 af 55

14 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 Side 14 af 55

15 KMD ESR KMD FTP server ESR udtræk ESR udtræk SFTP KMD Firewall Nyt BBR Applikations server Nyt BBR SQL Server CSC FTP server FTPS Adresse udtræk fra CPR Indlæsning af ESR ejere via SSIS job Indlæsning af CPR adresser via CPR opdateringspro gram Kørsel af stored procedure som opdaterer udlejningsforhold 2 på Enhed Version 12.0 Side 15 af 55

16 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: Attributter: Entitet: 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 Side 16 af 55

17 Når data er opdateret køres proceduren usp_adgangsadresseupdatedenorm_vej, som opdaterer de denormaliserede attributter i tabellen Adgangs- Adresse. Disse attributter er denormaliserede af hensyn til performance. Version 12.0 Side 17 af 55

18 KMD Firewall Nyt BBR Applikations server Nyt BBR SQL Server CSC FTP server FTPS Vejregisterudtræk fra CPR 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. Kørsel af procedurerne: Usp_Vej_Delete Usp_Vej_Insert Usp_Vej_Update Usp_Vejstykke_Delete Usp_Vejstykke_Insert Usp_Vejstykke_Update Version 12.0 Side 18 af 55

19 1.6.3 E-Boks BBR E-boks sender tilmeldingsliste til BBR. e-boks leverer liste over de danskere, der er tilmeldt E-boks 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 Version 12.0 Side 19 af 55

20 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. BBR-klient Kommuneklient Https (SSL) Internet OWSA-model T (SSL) Præsentationsserver Modul 1 Web site Modul 2... Modul N Service Agenter Service Gateway Autentifikation Applikationsserver WCF Service Interface Lag Batch Service Contract Service Adapter Windows Services Forretnings Lag Forretnings Logik Forretnings Entiteter ASP.NET Providers 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 Side 20 af 55

21 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 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 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 Side 21 af 55

22 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 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 Attributter: Betingelse: Entitet: Flere Attributter: Kommunenummer og ejendomsnummer 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: RealPropertyStructureType ikke valid (kaldende struktur) 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: Fejlhåndtering: Sikkerhed: HTTPS 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 Side 22 af 55

23 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 Side 23 af 55

24 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 til indberetteren. Kommunen kan nu tilknytte en sagsbehandler til sagen. Den ansvarlige sagsbehandler vil efterfølgende modtage en om den nye indberetning. Sagsbehandleren kan nu overføre, afvise eller godkende sagen. Resultatet af sagsbehandlingen sendes via 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 Type Supplerende varme Via en snitflade kan Inddataboksen modtage ændringer til feltet Supplerende varme på bygnings- og enhedsniveau. Webservicen hedder InputBox.wsdl 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 Side 24 af 55

25 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 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 Version 12.0 Side 25 af 55

26 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 Side 26 af 55

27 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 Attributter: Entitet: Adgangs- og enhedsadresse, Enhed Attributter: To Do: Status: 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: Det er aftalt, at folkeregisteret skal tilgå BBR-data via de generelle OIOXML-snitflader 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=" xmlns:soap=" xmlns:http=" xmlns:xs=" xmlns:soapenc=" xmlns:mime=" xmlns:tns="urn:oio:bbr:wsdl:1.0.0" target- Namespace="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 Side 27 af 55

28 <xs:include schemalocation=" /> <xs:include schemalocation=" /> <xs:include schemalocation=" ByEntityRequestStructure.xsd" /> <xs:include schemalocation=" ByEntityResponseStructure.xsd" /> <xs:include schemalocation=" RequestStructure.xsd" /> <xs:include schemalocation=" ResponseStructure.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:entitypermissionget- ByEntityRequest"/> <wsdl:output name="entitypermissiongetbyentityresponse" message="tns:entitypermissionget- ByEntityResponse"/> </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=" Version 12.0 Side 28 af 55

29 <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 Side 29 af 55

30 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 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 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 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) 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 Side 30 af 55

31 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 Attributter: Alle attributter på Adgangs- Adresse og EnhedsAdresse Entitet: 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 Side 31 af 55

32 Status: Denne webservice sættes i drift 15/ 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 Kommentarer: 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 Attributter: Matrikelkoordinater Entitet: Matrikel 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 Side 32 af 55

33 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 Attributter: Entitet: Matrikel 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 Kommentarer: Håndtering af redundante data vs. opdaterede data: Ingen dataredundans Status: Webservice er implementeret BBR - ESR Der kommunikeres med ESR på 3 forskellige måder: Version 12.0 Side 33 af 55

34 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 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 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 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 Side 34 af 55

35 Ajourføring af adressedata 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 Attributter: Ejerforholdskode Entitet: Ejer 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 Version 12.0 Side 35 af 55

36 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) Attributter: Entitet: Ejendom (ejerlejlighed) 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 Side 36 af 55

37 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) Attributter: Tinglyst areal Entitet: Ejendom (Ejerlejlighed) 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 Version 12.0 Side 37 af 55

38 Håndtering af redundante data vs. opdaterede data: Publish/Subscribe. Status: Webservice er implementeret. Kommentarer: Kommunen vil under Systemadministration kunne vælge om oplysningen om tinglyst areal skal vises i BBR. 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 Side 38 af 55

39 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: 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. Kommentarer: 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 Side 39 af 55

40 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: 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. Kommentarer: 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 Server ESR Version 12.0 Side 40 af 55

41 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 Resultat: Oplysninger giver mulighed for at opdatere BBR med landsejerlavskode, landsejerlavstekst og kommunale ejerlav Entitet: Landsejerlav, kommunalt ejerlav Attributter: Landsejerlavskode, landsejerlavstekst, kommunal ejerlavskode Betingelse: 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 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 Side 41 af 55

42 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) Attributter: Tinglyst areal Entitet: Matrikel 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 Side 42 af 55

43 Håndtering af redundante data vs. opdaterede data: Publish/Subscribe. Status: Webservice er implementeret. Kommentarer: Kommunen vil under Systemadministration kunne vælge om oplysningen om tinglyst areal skal vises i BBR. 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) Attributter: Tinglyst areal Entitet: Matrikel 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 Side 43 af 55

44 Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron Kompleksitet: Simpel Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Håndtering af redundante data vs. opdaterede data: Publish/Subscribe. Status: Webservice er implementeret. Kommentarer: Kommunen vil under Systemadministration kunne vælge om oplysningen om tinglyst areal skal vises i BBR 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) Attributter: Entitet: Ejendom 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 Side 44 af 55

45 Synkronisering: Ingen synkroniseringsproblemer Kompleksitet: Simpel Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Krav 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 Attributter: Entitet: Ejer, ejendom 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 Side 45 af 55

46 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 Kommentarer: Matrikelbetegnelsen skal ikke benyttes direkte i BBR, men videre i synkroniseringen med KMD-BBR (og KKR). Hvis der i BBR flyttes en bygning indeholdende ejerlejligheder - fra en matrikel til en anden matrikel skal der på ny hentes oplysninger om ejerlejligheden. Kommentarer: 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 Side 46 af 55

47 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 Side 47 af 55

48 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 Side 48 af 55

49 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: Attributter: Entitet: Adgangs- og Enhedsadresse 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 Kommentarer: Håndtering af redundante data vs. opdaterede data: Opdatering fra databærende system Status: Webservice er implementeret. Version 12.0 Side 49 af 55

50 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. Inputparametre: landsejerlavskode + matrikelnummer Outputparametre: et antal planer med angivelse af plannavn, id, status og type Entitet: Attributter: Entitet: 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 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 Attributter: offentlig støtte Entitet: Ejendom 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 Side 50 af 55

51 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 Kommentarer: Koden overføres ikke til KMD- BBR i dag. To Do: KOMBIT afklarer med Bossinf om overførslen Version 12.0 Side 51 af 55

52 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 Attributter: Entitet: Flere 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 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 Side 52 af 55

53 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 Attributter: Entitet: Flere 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 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 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 Side 53 af 55

54 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 BBR Certificeringscenter Denne snitflade bruges i forbindelse med autentifikation af brugere ved logon med certifikat (medarbejder-, funktions- og virksomhedscertifikater). Version 12.0 Side 54 af 55

55 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 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 til den af kommunen angivne e- mail adresse. Version 12.0 Side 55 af 55