BBR OIOXML. Vejledning til OIOXML snitflade for Bygninger og boliger BuildingDwelling.wsdl. Tillæg til BuildingDwellingV5. BuildingDwellingV6

Transkript

1 OIOXML Vejledning til OIOXML snitflade for Bygninger og boliger BuildingDwelling.wsdl Tillæg til BuildingDwellingV5 / Ændringer i BuildingDwellingV6 En vejledning rettet mod 3. part.

2 Indholdsfortegnelse 1. Introduktion Ændrede felter i BuildingDwellingV Ændret kodeliste til felt Byggeskadeforsikringsselskab for bygning Ændret kodeliste til felterne Nøjagtighedsklasse (Kvalitet af koordinatsæt) og Kilde til Geometri (Kilde til koordinatsæt) i strukturen ConstructionPoint Nye felter i BuildingDwellingV Nyt felt vedr. støjisolering SoundProofingYearIdentifier for enhed Nyt felt ConstructionPointAdditionalInformationCode i understrukturen ConstructionPoint for bygninger og teknsisk anlæg... 8 Snitfladebeskrivelse Side 2 af 9

3 1. Introduktion Dette tillæg henvender sig til brugere af OIO XML snitfladen BuildingDwelling. OIO BuildingDwelling snitfladen har eksisteret/eksisterer i 6 versioner. BuildingDwellingV1 er blevet udfaset den i forbindelse med at Nyt release 1.3 er blevet sat i drift. BuildingDwellingV2 er blevet udfaset den i forbindelse med at Nyt release 1.4 er blevet sat i drift. BuildingDwellingV3 udfases den i forbindelse med at Nyt release 1.5 sættes i drift. BuildingDwellingV4 udfases den i forbindelse med at Nyt release sættes i drift. BuildingDwellingV5 har været i drift siden , og denne version fortsætter med at eksistere, indtil der kommer en version 7 af snitfladen. BuildingDwellingV6 er pr den nyeste version af snitfladen. Denne vejledning henvender sig til alle brugere af snitfladen: Brugere af version 1, version 2, version 3 og version 4 af snitfladen skal overgå til en nyere version, hvis dette ikke allerede er sket. Denne vejledning giver dem et godt overblik over ændringer i version 6. Tilsvarende findes der dokumenter, som beskriver ændringer i version 2, 3, 4 og 5. Disse tillæg/dokumenter findes på Brugere af version 5 af snitfladen kan fortsætte med at benytte version 5, dog skal brugerne være opmærksomme på de i denne vejledning beskrevne uhensigtsmæssigheder, som er forbundet med dette. Brugerne af version 5 skal være opmærksomme på, at snitfladen udgår, når version 7 af snitfladen sættes i drift, og de opfordres derfor til at gå over til version 6 ved førstkommende mulighed. Denne vejledning giver dem et godt overblik over ændringer i version 6. Brugere af version 6 af snitfladen kan benytte denne vejledning for at få et hurtigt overblik over ændringer i version 6 i forhold til version 5. Snitfladebeskrivelse Side 3 af 9

4 I produktionsmiljø findes snitfladernes endpoint her: Snitfladernes dokumentation, snitfladernes wsdl-dokumenter for både produktions- og demoversionen vil man kunne finde på 's demoserver: 2. Ændrede felter i BuildingDwellingV Ændret kodeliste til felt Byggeskadeforsikringsselskab for bygning Feltet Byggeskadeforsikringsselskab (BuildingDamageInsuranceCompanyCode), som findes i strukturen BuildingInsurance på bygning har ændret kodeliste fra version 5 til version 6. Der er blevt tilføjet koderne 14 og 15 og der er blevet fjernet kode 09. Kodeliste i BuildingDwellingV5: 00 - Ingen byggeskadeforsikring 01 - Tryg 02 - Topdanmark 04 - Codan 05 - If forsikring 06 - Alm. Brand 07 - Danske Forsikring 08 Caplloyd A/S 09 Midtjysk Forsikring 10 Købstædernes Forsikring 11 ALKA 12 Frida Forsikring Agentur 13 NemForsikring 99 Ingen forsikring på grund af dispensation Kodeliste i BuildingDwellingV6: 00 - Ingen byggeskadeforsikring 01 - Tryg 02 - Topdanmark 04 - Codan 05 - If forsikring 06 - Alm. Brand 07 - Danske Forsikring 08 Caplloyd A/S 10 Købstædernes Forsikring 11 ALKA 12 Frida Forsikring Agentur 13 NemForsikring 14 AXA 15 Husejernes Forsikring 99 Ingen forsikring på grund af dispensation Snitfladebeskrivelse Side 4 af 9

5 Håndtering af ændringen i BuildingDwellingV5: Da betydningen af koderne ikke har ændret sig, returneres feltet gennem BuildingDwellingV5 snitfladen og feltet kan indberettes så længe man ikke prøver at overskrive en eksisterende kode 14 eller 15. Kode 09 er ikke blevet indberettet i systemet. Dette betyder i detaljer: Get metoderne og søgemetoderne leverer kun de gamle koder. Hvis en bygning har kode 14 eller 15, returneres feltet ikke, men der returneres null i stedet for. Hvis man opretter eller opdaterer en bygning og sender BuildingInsurance strukturen med hvor indholdet for feltet BuildingDamageInsuranceCompanyCode er forskelligt fra det eksisterende feltindhold, gives der en en sandsynlighedsbesked (ResponseReasonIdentifier=5000). Det gælder både, hvis man opdaterer feltet med en værdi og når man ikke angiver feltet, dvs. prøver at nullstille feltet. Sandsynlighedsbeskeden advarer om, at feltet har fået en ny kodeliste i version 6 af snitfladen. Hvis man gennemtvinger oprettelsen/opdateringen, bliver feltet oprettet/opdateret med den angivne værdi hhv. nullstillet dog med undtagelse af 2 situationer: o Når man ikke angiver feltet (nullstiller feltet) og den eksisterende værdi er kode 14 eller 15, vil feltet ikke blive nullstillet. o Når man angiver værdi 09 vil feltet ikke blive opdateret. Hvis man opretter eller opdaterer en bygning og ikke sender BuildingInsurance strukturen med, betyder det, at man ikke ønsker at ajourføre alle felter i strukturen. I givet fald gives der heller ikke nogen advarsel Ændret kodeliste til felterne Nøjagtighedsklasse (Kvalitet af koordinatsæt) og Kilde til Geometri (Kilde til koordinatsæt) i strukturen ConstructionPoint Felterne Nøjagtighedsklasse (ConstructionPointQualityClassCode) og Kilde til geometri (ConstructionPointSourceCode), som findes i strukturen ConstructionPoint på teknisk anlæg og bygning har ændret kodeliste fra version 5 til version 6. Kodeliste i BuildingDwellingV5 for nøjagtighedsklasse: Koder: 1a 1b 1c 1d 1e Snitfladebeskrivelse Side 5 af 9

6 6 7 U - uden koordinater stedfæstelse ukendt Kodeliste i BuildingDwellingV5 for kilde til geometri: Koder: 1: Matrikelkort 2: Teknisk kort, TK-3-standard 3: Teknisk kort, TK-1-standard 4: TOP10DK 5: T0 6: Digitalt ortofoto 7: Stedfæstet adresse De nye kodelister fremgår af nedenstående tabel. Ændrede kodelister i ConstructionPoint Feltnavn i OIOXML navn Kommentar Kvalitet for koordinatsæt ConstructionPointQualityClassCode Feltets kodeliste 1 Sikker geokodning 3 Usikker geokodning Kilde til koordinatsæt 2 Næsten sikker geokodning ConstructionPointSourceCode Værdien null tillades ikke. Feltets kodeliste K Kommune L Landinspektør E Ejer M Maskinelt dannet Værdien null tillades ikke. Angiver den part som senest har ajourført koordinatsættet for bygningen. M henviser til at koordinatsættet er maskinelt dannet, mens K henviser til, at oplysningen er verificeret af kommunen. For nuværende er det ikke muligt for ejere og landinspektører at ajourfører koordinater i, men systemet er forbe- Snitfladebeskrivelse Side 6 af 9

7 Ændrede kodelister i ConstructionPoint Feltnavn i OIOXML navn Kommentar redt til det. Se også afsnit 3.2 vedr. et nyt felt i strukturen ConstructionPoint. Initialværdier af disse nye felter I perioden fra den 1. juli og ca. 2 uger fremaf vil der for alle bygninger og tekniske anlæg i bliver hentet koordinater fra GST. Deres kilde vil være M, deres nøjagtighedsklasse vil være 3 og kode for supplerende oplysning om koordinatsæt vil være 31 (se afsnit 3.2). Hvis der ikke kan hentes et koordinatsæt fra GST (f.eks. fordi bygningen/teknisk anlæg ligger på en ESR matrikel uden tilhørende GST matrikel) vil koordinater være 0, kilden M, nøjagtighedsklassen 3 og kode for supplerende oplysning om koordinatsæt null. Koordinatsæt som i dag har en nøjagtighedsklasse 1a, som er bedre end 1e vil ikke får hentet nye koordianter, men vil beholde de angivne koordinater. Deres kilde vil være M, men deres nøjagtighedsklasse vil være 2 og kode for supplerende oplysning om koordinatsæt null. Håndtering af ændringen i BuildingDwellingV5: Da betydningen af koderne har ændret sig afgørende, returneres felterne Nøjagtighedsaklasse og Kilde til Geometri ikke længere igennem BuildingDwellingV5 snitfladen. Desuden vil alle felter i strukturen ConstructionPoint ikke kunne indberettes igennem BuildingDwelling5. Dette betyder i detaljer: Det er alene selve koordinaterne (struktur GeographicPointLocation) som leveres i strukturen ConstructionPoint ved en GET metode i BuidlingDwelling 5. Hvis man opretter eller opdaterer en bygning hhv. teknisk anlæg og sender ConstructionPoint strukturen vil felterne i strukturen blive ignoreret. Der gives dog en sandsynlighedsbesked (ResponseReasonIdentifier=5000), der advarer om, at man skal benytte BuildingDwellibng 6 hvis man vil opdatere geometri felterne. Hvis man gennemtvinger oprettelsen/opdateringen, bliver alle felter i ConstructionPoint strukturen ignoreret. 3. Nye felter i BuildingDwellingV Nyt felt vedr. støjisolering SoundProofingYearIdentifier for enhed Der er blevet tilføjet et nyt felt til enheder i strukturen BuildingUnitInformation på enhed niveau. Nyt felt i BuildingUnitInformation Feltnavn i OIOXML navn Kommentar Støjisolering SoundProofingYearIdentifier Årstal for støjisolering af Snitfladebeskrivelse Side 7 af 9

8 Nyt felt i BuildingUnitInformation Feltnavn i OIOXML navn Kommentar boligen med tilskud fra Banedanmark Håndtering af ændringen i BuildingDwellingV5: Ændringen behøves ikke at blive håndteret. Man skal bare være opmærksom på, at feltet ikke leveres som en del af BuildingUnitInformation strukturen i version Nyt felt ConstructionPointAdditionalInformationCode i understrukturen ConstructionPoint for bygninger og teknsisk anlæg Strukturen ConstructionPoint har fået tilføjet et nyt felt, som skal ses i sammenhang med de i afsnit 2.2. beskrevne ændrede felter. Nyt felt i ConstructionPoint Feltnavn i OIOXML navn Kommentar Supplerende oplysning om koordinatsæt ConstructionPointAdditional- InformationCode Som supplement oplyses om koordinatsættet er så nøjagtigt, at det ligger indenfor den geografiske afgrænsning af bygningen eller om det blot vides at koordinatsættet ligger på den rigtige matrikel. Tillige oplyses om bygningen ligger under jorden og dermed ikke fremgår af luftfotos. Kodeliste: 11 Koordinatsæt ligger i bygningen/det tekniskeanlæg (over jorden) 12 Koordinatsæt ligger i bygningen/det tekniske anlæg (under jorden) 21 Koordinatsæt ligger i bygningen/det tekniske anlæg (over jorden) 22 Koordinatsæt ligger i bygningen/det tekniske anlæg (under jorden) 31 Koordinatsæt ligger på matriklen Snitfladebeskrivelse Side 8 af 9

9 Nyt felt i ConstructionPoint Feltnavn i OIOXML navn Kommentar 32 Ukendt Feltet er ikke krævet. Hvis feltet supplerende oplysning om koordinatsæt indberettes, udføres der følgende valideringer: Hvis feltet angives som 11 eller 12, skal Kvalitet af koordinatsæt være angivet med værdi 1. Tilsvarende gælder hvis feltet angives som 21 eller 22 - så skal Kvalitet af koordinatsæt være angivet med værdi 2 og hvis feltet angives som 31 eller 32, skal Kvalitet af koordinatsæt være angivet med værdi 3. Håndtering af ændringen i BuildingDwellingV5: Ændringen behøves ikke at blive håndteret. Man skal bare være opmærksom på, at feltet ikke leveres som en del af ConstructionPoint strukturen i version 5. Snitfladebeskrivelse Side 9 af 9