Dataudveksling med andre systemer... 2

Transkript

1 Indholdsfortegnelse 6. Dataudveksling med andre systemer Overordnede betragtninger Oversigt over integration mellem Nyt BBR og andre systemer Skabelon til systemintegration Integration mellem Nyt BBR og andre systemer OIOXML-snitflader til hentning og opdatering af BBR-data fra andre systemer BBR KMS BBR ESR BBR Bossinf-STB BBR CPR/OIS Periodevise kørsler, dataudtræk mv BBR-Levering og opdatering af adressekoordinater Masseopdatering...29 Version 4 Side 1 af 29

2 6. Dataudveksling med andre systemer Dataudveksling med andre systemer vil i Nyt BBR fortrinsvis foregå som systemtil-system integration. 6.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 dataanvendende 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 opsumerer de vigtigste forskelle i fordele og ulemper mellem de forskellige metoder: Pålidelighed Tilgængelighed Simpelhed 1) Ingen dataredundans ) Opdatering fra databærende system + (-) - 3) Publish/Subscribe - + (+) Version 4 Side 2 af 29

3 I forbindelse med Nyt BBR vil det være nødvendigt at inddrage disse overvejelser med hvert enkelt tilfælde af system-til-system integration. 6.2 Oversigt over integration mellem Nyt BBR og andre systemer I det følgende beskrives overordnet hvilke systemer der skal integreres i forbindelse med hvilke hændelser: BBR/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) Hent ejerforholdskode i Nyt BBR 10) Hent CPRnr/CVRnr 11) Hent matrikel-oplysninger 12) Hent ejerlejligheds-oplysninger BBR/BOSSINF 1) Hentning af offentlig støtte i BOSSINF på enhed BBR/KMS 1) Hentning af matrikelkode og ejerlavskode i KMS 2) Ajourføring af adressedata BBR/CPR/OIS 1) Hentning af adresser ud fra CPR-nummer i hhv. OIS og CPR 2) Opslag fra CPR af adresse i Nyt BBR 3) Opdatering af Udlejningsforhold 2 ved samkøring af ESR, CPR og NYT BBR. Derudover er der nogle potentielle snitflader ud fra det notat der har erstattet de oprindelige krav. Version 4 Side 3 af 29

4 Data fra andre offentlige systemer Kræver nærmere afklaring fra Kommune Holding vedrørende: Fredningsforhold og bevaringsværdi fra Kulturarvsstyrelsen Husleje/udlejningsforhold (fra ejere) Tilskud til energibesparende varmeinstallationer Oplysninger fra skorstensfejere (supplerende varme) Arbejdstilsynet. Version 4 Side 4 af 29

5 6.3 Skabelon til systemintegration Nedenfor præsenteres en skabelon for de services, der skal udvikles i forbindelse med NYT 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 Kommune Holding 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)> 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 i øvrigt> <For udvikling af klienten> <Hvad skal der gøres> <For udvikling af servicen> <Hvad skal der gøres> Version 4 Side 5 af 29

6 6.4 Integration mellem Nyt BBR og andre systemer OIOXML-snitflader til hentning og opdatering af BBR-data fra andre systemer NYT BBR s funktionalitet vil blive 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 i infostrukturbasen. Der defineres én snitflade pr. niveau til hentning af data. Som udgangspunkt vil det være muligt at benytte Klasse 0 felter, de obligatoriske identifikationer, som udsøgningskriterium. Til opdatering defineres også én snitflade pr. niveau. Den forudsættes at den tekniske nøgle benyttes som identifikation. Alle opdateringer af denne vej går via Modtageboksen. Herudover specificeres følgende specifikke OIOXML-services: BBR KMS 1. Hentning af matrikelkode og ejerlavskode i KMS Server KMS Beskrivelse: Henter matrikeloplysninger fra KMS i forbindelse med oprettelse af ny grund Inputparametre: Kommunenummer, ejendomsnummer Outputparametre: Matrikel, Landsejerlav Entitet: Aktuel grund/ejendom, matrikel Attributter: Matrikelnummer, Landsejerlav Betingelse: Ejendommen skal eksistere Resultat: Readonly Implementering: KMS udstiller en webservice Isolation/Uafhængighed: Oprettelse af grund kan ikke gennemføres On-line tilgængelighed: Operationen er tidstro Version 4 Side 6 af 29

7 Svartider: Der vil være et overhead i form af et kald til et eksternt system Synkronisering: Ingen synkroniseringsproblemer Logistik: Aftales med KMS Overholdelse af Kontrakten: Krav 5.1.1, Implementere en webservices Tidsfristen: Kommune Holding aftaler webservice med KMS 2. Ajourføring af adressedata - KMS Server KMS Beskrivelse: Overfører adressedata til KMS ved oprettelse af, eller ændring af adgangsadresse Inputparametre: Kommunenummer, Matrikelnummer, Ejendomsnummer, adgangsadresse Outputparametre: OK Entitet: Grund Attributter: Adgangsadresse Entitet: Matrikel Attributter: Adgangsadresse Betingelse: Matriklen skal eksistere Resultat: Matriklens adgangsadresse er ændret Implementering: KMS udstiller en webservice Isolation/Uafhængighed: Ajourføringen kan ikke gennemgø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 Logistik: Aftales med KMS Overholdelse af Kontrakten: Krav Kommune Holding aftaler webservice med KMS Version 4 Side 7 af 29

8 3. Hentning af matrikelkoordinater Server KMS Beskrivelse: Leverer koordinaterne til en matrikel Inputparametre: Kommunenummer, Matrikelbetegnelse Outputparametre: Matrikelkoordinater, adressekoordinaterne samt angivelse af nøjagtighedsklasse ( B ), Teknisk standard ( UF ), kilde til geometri ( 2 ), revisionsdato ( dagsdato ), retning ( 200 ) og placering ( 5 ). Entitet: Matrikel, Adgangsadresser, Bygning Attributter: Matrikelkoordinater Entitet: Matrikel Attributter: Matrikelkoordinater Betingelse: Matriklen skal eksistere Resultat: Implementering: KMS udstiller en webservice Isolation/Uafhængighed: Ajourføringen kan ikke gennemgø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 Logistik: Aftales med KMS Overholdelse af Kontrakten: Krav Kommune Holding aftaler webservice med KMS Version 4 Side 8 af 29

9 4. Søgning af matrikel i KMS på basis af adressekoordinater Klient NYT BBR Server KMS Beskrivelse: Henter matrikel på basis af adressekoordinater fra KMS Inputparametre: Kommunenummer, adressekoordinater Outputparametre: Liste af matrikler indenfor koordinaterne Entitet: Attributter: Entitet: Matrikler Attributter: Matrikel Betingelse: Resultat: Implementering: KMS udstiller en webservice Isolation/Uafhængighed: Hvis nyt BBR er nede kan forespørgslen ikke gennemføres On-line tilgængelighed: Operationen er tidstro Svartider Synkronisering: Ingen synkroniseringsproblemer Logistik: Aftales med nyt BBR Overholdelse af Kontrakten: Krav Kommune Holding aftaler webservice med KMS Version 4 Side 9 af 29

10 5. Søgning af matrikel i KMS på basis af bygningskoordinater Server KMS Beskrivelse: Henter matrikel i KMS på basis af bygningskoordinater Inputparametre: Kommunenummer, bygningskoordinater Outputparametre: Liste af matrikler indenfor koordinaterne Entitet: Bygninger Attributter: Entitet: Matrikel Attributter: Matrikelbetegnelsen Betingelse: Resultat: Implementering: KMS udstiller en webservice Isolation/Uafhængighed: Hvis nyt BBR er nede kan forespørgslen ikke gennemføres On-line tilgængelighed: Operationen er tidstro Svartider Synkronisering: Ingen synkroniseringsproblemer Logistik: Aftales med nyt BBR Overholdelse af Kontrakten: Krav Kommune Holding aftaler webservice med KMS Version 4 Side 10 af 29

11 6.4.3 BBR ESR 1. Opdatering af ejerforholdskoden i ESR 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ængelig for Nyt BBR. Inputparametre: - Outputparametre: Kommunenummer, Ejendomsnummer, Ejerlejlighedsejendomsnummer (udfyldes ved artskode 02 og 32), Ejendomsreference, Ejerforholdskode Entitet: Grund, Bygning, Teknisk anlæg, enhed Attributter: Ejerforholdskode Entitet: Ejendom Attributter: Kommunenummer, Ejerforholdskode, Ejendomsnummer, Ejendomsreference, Betingelse: Grunden skal eksistere Resultat: Oplysninger giver mulighed for at opdatere Nyt 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 Isolation/Uafhængighed: Nyt BBR kan fungere selv om ESR er nede og ejerforholdskoden ikke er opdateret. ESR kan fungere selv om Nyt BBR er nede. On-line tilgængelighed: Operationen er asynkron. Svartider: Intet overhead Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Krav Version 4 Side 11 af 29

12 2. Ejerskifte i ESR Server ESR Beskrivelse: Ejerskifte i ESR Når der foretages ejerskifte i ESR, skal ESR gøre oplysningerne tilgængelig for Nyt BBR, da det skal medføre en udskrivning af en BBR-Meddelelse. Inputparametre: - Outputparametre: Kommunenummer, Ejendomsnummer, Ejendomsreference Entitet: Ejendom, Grund, Bygning (ejerlejlighed), Enhed (ejerlejlighed) Attributter: Entitet: Ejendom (ejerlejlighed) Attributter: Kommunenummer, Ejendomsnummer, Ejendomsreference Betingelse: Resultat: Nyt BBR skal gøre klar til udskrivning af en BBR-Meddelelse (med årsag ejerskifte ) Implementering: ESR udstiller en service Isolation/Uafhængighed: Nyt BBR kan fungere selv om ESR er nede og ejerforholdskoden ikke er opdateret. ESR kan fungere selv om Nyt BBR er nede. On-line tilgængelighed: Operationen er asynkron. Svartider: Intet overhead Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Krav 7.1, 7.7 Version 4 Side 12 af 29

13 3. Opdatering af etagemeter (tinglyst areal) i ESR Server ESR Beskrivelse: Opdatering af oplysninger om opdatering af etagemeter i ESR. Når der opdateres i etagemeter (som svarer til feltet tinglyst areal i Nyt BBR) skal ESR gøre oplysningen tilgængelig for Nyt BBR. Det gøres ved at ESR via en service sender oplysningen sammen med tilhørende identifikation af ejendommen til Nyt BBR. Inputparametre: - Outputparametre: Kommunenummer, Ejendomsnummer, Ejendomsreference, 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 Isolation/Uafhængighed: Nyt BBR kan fungere selv om ESR er nede og ejerforholdskoden ikke er opdateret. ESR kan fungere selv om Nyt BBR er nede. On-line tilgængelighed: Operationen er asynkron. Svartider: Intet overhead Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Krav Version 4 Side 13 af 29

14 4. Oprettelse af matrikel i ESR Server ESR Beskrivelse: ESR opretter en matrikel. Dette skal Nyt BBR har besked om så tilsvarende matrikel automatisk oprettes i Nyt BBR. Inputparametre: - Outputparametre: Kommunenummer, ejendomsnummer, fuld matrikelbetegnelse Entitet: Grund, matrikel Entitet: Ejendom, matrikel Attributter: Fuld matrikelbetegnelse Betingelse: Ejendommen skal eksistere Resultat: Oplysninger giver mulighed for at opdatere Nyt BBR med nye matrikler Implementering: ESR udstiller en service Isolation/Uafhængighed: Nyt BBR kan fungere selv om ESR er nede og matriklen ikke er opdateret. ESR kan fungere selv om Nyt BBR er nede. On-line tilgængelighed: Operationen er asynkron. Svartider: Intet overhead Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Ingen direkte krav i kravspecifikationen, men en følge af brug af ESRmatriklen Hvis oplysningerne ikke sendes fra ESR når de opstår, vil det på ejendomme/grunde som allerede er oprettet i Nyt BBR, ikke være muligt at placere bygninger på disse matrikler, da matriklerne ikke vil komme til Nyt BBR s kendskab. Version 4 Side 14 af 29

15 5. Sletning af matrikel i ESR Server ESR Beskrivelse: ESR sletter en matrikel. Dette skal Nyt BBR have besked om så evt. tilsvarende matrikel kan slettes i Nyt BBR. ESR tjekker i KRR om der er bygninger på matriklen (senere skal der tjekkes op mod Nyt 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. Inputparametre: - Outputparametre: Kommunenummer, Ejendomsnummer, fuld matrikelbetegnelse Entitet: Grund, matrikel Entitet: Ejendom, matrikel Attributter: Fuld matrikelbetegnelse Betingelse: Ejendommen skal eksistere Resultat: Oplysninger giver mulighed for at slette matrikler i Nyt BBR Resultat: Readonly Implementering: ESR udstiller en service Isolation/Uafhængighed: Nyt BBR kan fungere selv om ESR er nede og matriklen ikke er opdateret. ESR kan fungere selv om Nyt BBR er nede. On-line tilgængelighed: Operationen er asynkron. Svartider: Intet overhead Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Ingen direkte krav i kravspecifikationen, men en følge af brug af ESRmatriklen Nyt BBR skal have faciliteter til at flytte en bygning fra en matrikel til en anden. Denne facilitet skal implementeres i Nyt BBR under alle omstændigheder. Bygningens placering skal synkroniseres til KRR. Version 4 Side 15 af 29

16 6. Flytning af matrikler i ESR Server ESR Beskrivelse: Der flyttes matrikler mellem to ejendomme i ESR. Det laves mod Nyt BBR som opret og slet af matrikel, se pkt. 5 Sletning af matrikler i ESR. 7. Approbationer i ESR Server ESR Beskrivelse: De foreløbige matrikler oprettes i Nyt BBR på linie 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 matrikeler i ESR. 8. Ajourføring af adressedata - ESR Server ESR Beskrivelse: Overfører adressedata til ESR ved oprettelse af, eller ændring af adgangsadresse Inputparametre: Kommunenummer, Matrikelnummer, Ejendomsnummer, adgangsadresse Outputparametre: OK Entitet: Matrikel Attributter: Adgangsadresse Entitet: Matrikel Attributter: Adgangsadresse Betingelse: Matriklen skal eksistere Resultat: Matriklens adgangsadresse er ændret Implementering: ESR udstiller en webservice Isolation/Uafhængighed: Ajourføringen kan ikke gennemgø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 Logistik: Aftales med ESR Overholdelse af Kontrakten: Krav Kommune Holding aftaler webservice med ESR Version 4 Side 16 af 29

17 8. Opdatering af ejerlavskoder og tekster i ESR Server ESR Beskrivelse: ESR opdaterer i ejerlavskoder og tekster. Følgende skal gøres tilgængelig for Nyt BBR: Oprettelse af eller ændring i landsejerlavskode Oprettelse af eller ændring i landsejerlavstekst Oprettelse af eller ændring i kommunal ejerlavskode Inputparametre: - Outputparametre: Kommunenummer, landsejerlavskode, landsejerlavstekst, kommunal ejerlavskode Resultat: Oplysninger giver mulighed for at opdatere Nyt BBR med landsejerlavskode, landsejerlavstekst og kommunale ejerlav Entitet: Landsejerlav, kommunalt ejerlav Attributter: Landsejerlavskode, landsejerlavstekst, kommunal ejerlavskode Betingelse: Implementering: ESR udstiller en service Isolation/Uafhængighed: Nyt BBR kan fungere selv om ESR er nede og ejerlavet ikke er opdateret. ESR kan fungere selv om Nyt BBR er nede. On-line tilgængelighed: Operationen er asynkron. Svartider: Intet overhead Synkronisering: Der kan være minimale synkroniseringsproblemer, da opdateringen er asynkron Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Krav Første gangs indlæsning i Nyt BBR skal ske via konverteringen. Version 4 Side 17 af 29

18 9) Hent ejerforholdskode i ESR Server ESR Beskrivelse: Henter oplysninger om ejerforholdskode i ESR. Når Nyt BBR opretter en grund skal ejerforholdskoden hentes i ESR. Når Nyt 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 Nyt 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 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 Synkronisering: Ingen synkroniseringsproblemer Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Krav Version 4 Side 18 af 29

19 10) Hent CPRnr/CVRnr Server ESR Beskrivelse: Henter ejers CPRnr/CVRnr i forbindelse med udskrivning af BBR-Meddelelse. I forbindelse med udlejningsforhold to dannes der desuden et udtræk, der skal sammenholdes med udtræk fra CPR. Inputparametre: Kommunenummer, Ejendomsnummer, Ejendomsreference Outputparametre: Liste af Ejeres CPR-numre eller CVR-numre Entitet: Bygning, enhed Attributter: Entitet: Ejer, ejendom Attributter: CPRnr eller CVRnr Betingelse: Ejendommen skal eksistere Resultat: Der kan kaldes videre til OIS for at få navn og adresse til adressering af BBR- Meddelelser. Implementering: ESR udstiller en service Isolation/Uafhængighed: Udskrivningen af ejermeddelelse kan ikke gennemføres/ajourføringen af Udlejningskode 2 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 Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: krav 7.2, EBST nota med ændringer til krav 5.3 Ejendomsreferencen er medtaget i snitfladen aht. fremtiden Version 4 Side 19 af 29

20 11) Hent matrikel-oplysninger Server ESR Beskrivelse: Ved oprettelse af en grund hentes matrikeloplysninger fra ESR og ved samme lejlighed kontrolleres at ejendommen eksisterer i ESR Inputparametre: Kommunenummer, ejendomsnummer Outputparametre: Liste af fulde matrikelreferencer tilknyttet den pågældende ejendom Entitet: Grund Entitet: Ejendom, matrikel Attributter: Matrikelreferencer Betingelse: Ejendommen skal eksistere Resultat: Der kan oprettes matrikler i Nyt BBR og laves relationer mellem Grund og matrikler Implementering: ESR pusher information til Nyt BBR. 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 Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Krav 5.1.1, 5.1.2, Da der skal kunne være ubebyggede grunde i Nyt BBR skal alle matrikler fra ESR over i Nyt BBR, på nær matrikler med artskode 02 og 32 (ejerlejlighedsmatrikler). Se bilag 1 for den samlede oversigt over matrikler som vil være synlige i Nyt BBR. ESR indeholder ikke grunde, alle matrikler vil derfor blive placeret på en grund, og Nyt BBR skal have faciliteter til at flytte matrikler mellem grunde. Version 4 Side 20 af 29

21 12) Hent ejerlejligheds-oplysninger 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 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 Logistik: Aftales med KMD/ESR Overholdelse af Kontrakten: Krav Matrikelbetegnelsen skal ikke benyttes direkte i Nyt BBR, men videre i synkroniseringen med det gamle BBR (og KKR). Hvis der i Nyt BBR flyttes en bygning indeholdende ejerlejligheder - fra en matrikel til en anden matrikel skal der på ny hentes oplysninger om ejerlejligheden. Version 4 Side 21 af 29

22 6.4.4 BBR Bossinf-STB Overførsel af kode for offentlig støtte skal overføres til Nyt BBR Klient Bossinf Server Nyt BBR Beskrivelse: Opdatering af kode for offentlig støtte i Nyt BBR Inputparametre: Kommunenummer, Enhedsadresse Outputparametre: Entitet: Enhed Attributter: offentlig støtte Entitet: Enhed Attributter: Offentlig støtte Betingelse: Enheden skal eksistere Resultat: Enheden opdateres med den angivne kode Implementering: Nyt BBR udstiller en webservice til opdatering af det tinglyste areal. Isolation/Uafhængighed: Nyt BBR kan fungere selv om Bossinf er nede og det tingslyste areal ikke er opdateret. Bossinf kan fungere selv om Nyt 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 Overholdelse af Kontrakten: Krav Koden overføres ikke til KMD-BBR i dag. Kommune Holding afklarer med Bossinf om overførslen Version 4 Side 22 af 29

23 6.4.5 BBR CPR/OIS 1. Hentning af adresser ud fra CPR-nummer i hhv. OIS og CPR Server OIS / CPR Beskrivelse: I forbindelse med udskrift af BBR-meddelelse skal man finde ejerens adresse ud fra CPR nummer. Denne oversættelse skal ske enten i fht. OIS eller CPR. I første omgang anvender man OIS, men hvis adressen har adressebeskyttelse, så slår man i stedet op i CPR. Inputparametre: CPR-nummer Outputparametre: Adresse Entitet: Flere Attributter: Entitet: Flere Attributter: Betingelse: Resultat: Mulighed for at påtrykke adresse på ejermeddelelse. Sikkerhed: Autorisation ud fra certifikat. Isolation/Uafhængighed: Hvis man ikke kan foretage opslaget, så er det ikke muligt at udskrive ejermeddelelsen. On-line tilgængelighed: Ikke nødvendigvis tidstro. Svartider: I forbindelse med masseudskrivninger er svartiden kritisk. Synkronisering: Nej Kompleksitet: Nej Logistik: KH stiller snitfladerne til rådighed. Overholdelse af Kontrakten: Mangler endelige aftaler. Version 4 Side 23 af 29

24 2. Opslag fra CPR af adresse i Nyt BBR Klient CPR Server Nyt BBR Beskrivelse: I forbindelse med flytningen af boligregisteret til Nyt BBR skal CPR fremover have adgang til hvilke adresser der er oprettet i Nyt BBR via en snitflade. Inputparametre: Adresse Outputparametre: Oplysning om, om adressen findes Entitet: Adgangs- og enhedsadresse Attributter: Entitet: Adgangs- og enhedsadresse Attributter: Betingelse: Resultat: Sikkerhed: Krypteret forbindelse med autorisation via certifikat. Fejlhåndtering: Fejl logges på klienten. Isolation/Uafhængighed: Der kan opstå inkonsistens, hvis CPR ikke oplyses om at en given adresse ikke findes i Nyt 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: Nyt BBR stiller WebService til rådighed for CPR. Overholdelse af Kontrakten: Data leveres i OIOXML. Version 4 Side 24 af 29

25 3. Opdatering af Udlejningsforhold 2 ved samkøring af ESR, CPR og Nyt BBR. Server CPR, ESR Beskrivelse: I forbindelse med opdatering af udlejningsforhold sammenkøres udtræk fra CPR og ESR med data fra Nyt BBR. Inputparametre: Outputparametre: Udtræk af alle ejere og lejere i CPR. Entitet: Attributter: Entitet: Attributter: Udlejningsforhold2 Betingelse: Resultat: Opdatering af udlejningsforhold 2 i Nyt BBR. Sikkerhed: Overførsel af data sker via FTP. Der mangler afklaring omkring, hvordan denne forbindelse krypteres. Fejlhåndtering: I forbindelse med kørslen udskrives en fejlliste. 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 ESR og CPR i flade filer til Nyt BBR. Overholdelse af Kontrakten: Version 4 Side 25 af 29

26 6.4.6 Periodevise kørsler, dataudtræk mv. Dette afsnit indeholder en beskrivelse af forskellige faciliteter i Nyt BBR til at sikre datakonsistens mellem systemer, udtræk til andre systemer, samt andre opgaver, der skal udføres periodevis Samkøring af CPR, ESR og Nyt BBR vedr. Udlejningsforhold 2. Kan ske ved BBR/ESR service 3 og BBR-CPR service 6, men vil ikke være hensigtsmæssigt pga. performance. Samkøringen kræver udtræk fra henholdsvis ESR og CPR, hvorefter de relevante data fra de forskellige systemer sammenholdes og feltet Udlejningskode 2 sættes med den korrekte værdi. Kørslen vil ske på halvårlig basis Påmindelser ved overskridelse af tidsfrister Det vil ved en 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 adresse Data fra Nyt BBR til OIS Der skal dagligt kører 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 OISs 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 Nyt 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 AendrtTimestamp OphoertTimestamp O Opret record R Ændrings record S Slette record BBR-Levering og opdatering af adressekoordinater 1. Levering af adressekoordinater fra Nyt BBR Klient Kommune eller kommunens GIS leverandør Server Nyt BBR Beskrivelse: Kommunerne hhv. kommunernes GIS leverandører skal have mulighed for at hente adgangsadresser med deres koordinater fra Nyt BBR. Der sendes et antal søgekriterier og der leveres de adresser med koordinater (Euref89 zone 32) tilbage, som opfylder søgekriterierne. Inputparametre: AdgangsadresseID (UUID) Kommunenummer Vejkode Landsejerlavskode Kommuneejerlavskode Matrikelnummer og bogstav Version 4 Side 26 af 29

27 Ejendomsnummer Status Nøjagtighedsklasse Kode for teknisk standard Kilde til adressegeometri Outputparametre: AdgangsadresseID (UUID) Kommunenummer Vejkode Vejnavn hvis gyldig Husnummer og husbogstav Lokalitet Bynavn Postnummer hvis gyldig Postdistrikt Landsejerlavskode - hvis adressen har tilknyttet matrikelnr. Kommuneejerlavskode Matrikelnummer og bogstav - hvis adressen har tilknyttet matrikelnr. Ejendomsnummer - hvis adressen har tilknyttet ejendomsnr. Kilde til adgangsadresse Antal referencer til enhed Oprettelsesdato Godkendelsesdato Ikrafttrædelsesdato Seneste ændringsdato Dato for nedlæggelse Journalnummer ESDH-Reference Initialer på sagsbehandler Status AdressepunktID (UUID) Nøjagtighedsklasse Kode for teknisk standard Kilde til adressegeometri Revisionsdato Easting koordinat (tidl. X) (Euref89 zone 32) Northing koordinat (tidl. Y) (Euref89 zone 32) Retningsvinkel Tekstplacering for husnummer Entitet: Adgangsadresse Entitet: Adgangsadresse Attributter: Attributter: AdgangsadresseID (UUID) Kommunenummer Vejkode Vejnavn Husnummer og husbogstav Lokalitet Bynavn Postnummer Postdistrikt Landsejerlavskode Kommuneejerlavskode Matrikelnummer og bogstav Ejendomsnummer Kilde til adgangsadresse Antal referencer til enhed Oprettelsesdato Godkendelsesdato Ikrafttrædelsesdato Seneste ændringsdato Dato for nedlæggelse Journalnummer ESDH-Reference Initialer på sagsbehandler Version 4 Side 27 af 29

28 Status AdressepunktID (UUID) Nøjagtighedsklasse Kode for teknisk standard Kilde til adressegeometri Revisionsdato Easting koordinat (tidl. X) (Euref89 zone 32) Northing koordinat (tidl. Y) (Euref89 zone 32) Retningsvinkel Tekstplacering for husnummer Betingelse: Resultat: Adgangsadresser som opfylder søgekriterier leveres med deres koordinater. Sikkerhed: OWSA Model T Fejlhåndtering: Fejlkode returneres til klienten Isolation/Uafhængighed: Ingen indflydelse på Nyt BBR s funktionalitet.. On-line tilgængelighed: Operationen behøver ikke nødvendigvis være tidstro. Svartider: Ikke kritisk Synkronisering: Kompleksitet: Lav Logistik: Nyt BBR stiller WebService til rådighed for eksterne dataleverandører. Overholdelse af Kontrakten: Der benyttes OIOXML. 2. Opdatering af adressekoordinater i Nyt BBR Klient Kommune eller kommunens GIS leverandør Server Nyt BBR Beskrivelse: Kommunerne hhv. kommunernes GIS leverandører skal have mulighed for at opdatere adressekoordinater i Nyt BBR. Der sendes en eller flere adresser med deres koordinater (Euref89 zone 32) og som resultat får man en besked om, om opdateringen er gået godt. Hvis ikke opdateringen kunne accepteres, leveres der en fejltekst. Inputparametre: AdgangsadresseID Kommunenummer Vejkode Husnummer og husbogstav Nøjagtighedsklasse Kode for teknisk standard Kilde til adressegeometri Revisionsdato KoordinatsystemID her Euref89 zone 32 Easting koordinat (tidl. X) Northing koordinat (tidl. Y) Retningsvinkel Tekstplacering for husnummer Version 4 Side 28 af 29

29 Outputparametre: Returkode og tekst Entitet: Adgangsadresse Attributter: Entitet: Adgangsadresse Attributter: AdgangsadresseID Kommunenummer Vejkode Husnummer og husbogstav Nøjagtighedsklasse Kode for teknisk standard Kilde til adressegeometri Revisionsdato KoordinatsystemID her Euref89 zone 32 Easting koordinat (tidl. X) Northing koordinat (tidl. Y) Retningsvinkel Tekstplacering for husnummer Betingelse: Koordinaterne opdateres hvis - revisionsdato <= dagsdato - nøjagtighedsklasse er bedre end den eksisterende Resultat: Opdatering af adressekoordinater for adgangsadressen Sikkerhed: OWSA Model T Fejlhåndtering: Fejlkode returneres til klienten Isolation/Uafhængighed: Nyt BBR kan fungere selv om adressekoordinater ikke er opdaterede. On-line tilgængelighed: Operationen behøver ikke nødvendigvis være tidstro. Svartider: Ikke kritisk Synkronisering: Kompleksitet: Lav Logistik: Nyt BBR stiller WebService til rådighed for eksterne dataleverandører. Overholdelse af Kontrakten: Krav Der benyttes OIOXML. 6.5 Masseopdatering I forbindelse med masseopdateringer af Nyt 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 forretningsregler bliver overholdt. Version 4 Side 29 af 29