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
© Copyright 2024