OIOXML Vejledning til OIOXML snitflade for Bygninger og boliger BuildingDwelling.wsdl Tillæg til BuildingDwellingV3 / Ændringer i BuildingDwellingV4 En vejledning rettet mod 3. part.
Indholdsfortegnelse 1. Introduktion... 3 2. Identændringer i BuildingDwellingV3 og BuildingDwellingV4... 5 2.1. Nye muligheder for identændringer for bygning, teknisk anlæg og opgang... 5 2.2. Ny metode SiteMoveEntities for grund... 5 3. Slet historiske entiteter i BuildingDwellingV4... 5 4. Ændrede felter i BuildingDwellingV4... 6 4.1. Ændret kodeliste til feltet Boligtype for enhed... 6 4.2. Ændret kodeliste til feltet Offentlig støtte for enhed... 6 4.3. Ændret kodeliste til feltet Tagdækningsmateriale og Supplerende tagdækningsmateriale for bygning... 7 4.4. Ændret kodeliste til felt Byggeskadeforsikringsselskab for bygning... 9 4.5. Ændret navn til feltet Dato for pålæg fra Stormrådet for bygning... 10 Snitfladebeskrivelse Side 2 af 10
1. Introduktion Dette tillæg henvender sig til brugere af OIO XML snitfladen BuildingDwelling. OIO BuildingDwelling snitfladen har eksisteret/eksisterer i 4 versioner. BuildingDwellingV1 er blevet udfaset den 20.06.2011 i forbindelse med at Nyt release 1.3 er blevet sat i drift. BuildingDwellingV2 udfases pr. 09.02.2012, når Nyt release 1.4 sættes i drift. BuildingDwellingV3 har været i drift siden 20. 06. 2011, og denne version fortsætter med at eksistere, indtil der kommer en version 5 af snitfladen. BuildingDwellingV4 er pr. 9.02.2012 den nyeste version af snitfladen. Denne vejledning henvender sig til alle brugere af snitfladen: Brugere af version 1 og version 2 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 4. Tilsvarende findes der dokumenter, som beskriver ændringer i version 2 og 3. Disse tillæg/dokumenter findes på http://demo.bbrkommune.dk/services/ under Webservices BuildingDwellingV1 Tillæg og Webservices BuildingDwellingV2 Tillæg. Brugere af version 3 af snitfladen kan fortsætte med at benytte version 3, dog skal brugerne være opmærksomme på de i denne vejledning beskrevne uhensigtsmæssigheder, som er forbundet med dette. Brugerne af version 3 skal være opmærksomme på, at snitfladen udgår, når version 5 af snitfladen sættes i drift, og de opfordres derfor til at gå over til version 4 ved førstkommende mulighed. Denne vejledning giver dem et godt overblik over ændringer i version 4. Brugere af version 4 af snitfladen kan benytte denne vejledning for at få et hurtigt overblik over ændringer i version 4 i forhold til version 3. Snitfladebeskrivelse Side 3 af 10
I produktionsmiljø findes snitfladernes endpoint her: https://bbr-kommune.dk/services/servicegateway/buildingdwellingservicev3.svc https://bbr-kommune.dk/services/servicegateway/buildingdwellingservicev4.svc Snitfladernes dokumentation, snitfladernes wsdl-dokumenter for både produktions- og demoversionen vil man kunne finde på 's demoserver: http://demo.bbr-kommune.dk/services/ Snitfladebeskrivelse Side 4 af 10
2. Identændringer i BuildingDwellingV3 og BuildingDwellingV4 I Nyt release 1.4 er der blevet implementeret nye muligheder for identændringer. 2.1. Nye muligheder for identændringer for bygning, teknisk anlæg og opgang Der er kommet nye muligheder for identændringer for bygninger, tekniske anlæg og opgange. Disse identændringer er både tilgængelige igennem BuildingDwellingV3 og BuildingDwellingV4, idet de ikke har haft betydning for snitfladens skemaer, men alene har betydet ændringer i systemets server lag. Der henvises til brugervejledningen for BuildingDwellingV4 for en nærmere beskrivelse af disse. Ændringen behøver ikke at blive håndteret. Man skal bare være opmærksom på, at disse muligheder nu er til rådighed i version 3. 2.2. Ny metode SiteMoveEntities for grund Der er en enkelt identændring på grund hhv. matrikel niveau, som kun kan benyttes igennem BuildingDwellingV4. Det drejer sig om metoden SiteMoveEntities på entiteten grund. Metoden gør det muligt at flytte alle entiteter (dvs. bygninger og tekniske anlæg), som ligger på én matrikel, til en anden matrikel. Den nye matrikel kan enten ligge på samme grund/ejendom eller på en anden grund/ejendom. Der henvises til brugervejledningen for Building- DwellingV4 for en nærmere beskrivelse af denne funktion. Ændringen behøver ikke at blive håndteret. Man skal bare være opmærksom på, at funktionen ikke er til rådighed i version 3. 3. Slet historiske entiteter i BuildingDwellingV4 I Kommune version 1.4 er muligheden for sletning af historiske stamentiteter blevet implementeret. Denne mulighed er tilgængelig i BuildingDwellingV4 ved at benytte <Entity>DeleteHistoric metoden for det enkelte niveau. Der henvises til brugervejledningen for BuildingDwellingV4 for en nærmere beskrivelse af metoden. Ændringen behøver ikke at blive håndteret. Man skal bare være opmærksom på, at muligheden ikke er til rådighed i version 3. Snitfladebeskrivelse Side 5 af 10
4. Ændrede felter i BuildingDwellingV4 I BuildingDwelling4 er kodelister til 4 felter blevet ændret (se afsnit 4.1 til 4.4), og et felt har ændret navn i metadata-filen (se afsnit 4.5). 4.1. Ændret kodeliste til feltet Boligtype for enhed Feltet Boligtype (DwellingTypeCode), som findes i strukturen BuildingUnitInformation på enhed, har ændret kodeliste fra version 3 til version 4. Kode E manglede fejlagtigt i det benyttede skema. Kodeliste i BuildingDwellingV3: 1 - Egentlig beboelseslejlighed (boligenhed med eget køkken). 2 - Blandet erhverv og bolig med eget køkken. 3 - Enkeltværelse (boligenhed med fast kogeinstallation, fælles køkken eller intet køkken). 4 - Fællesbolig eller fælleshusholdning. 5 - Sommer-/fritidsbolig. Kodeliste i BuildingDwellingV4: 1 - Egentlig beboelseslejlighed (boligenhed med eget køkken). 2 - Blandet erhverv og bolig med eget køkken. 3 - Enkeltværelse (boligenhed med fast kogeinstallation, fælles køkken eller intet køkken). 4 - Fællesbolig eller fælleshusholdning. 5 - Sommer-/fritidsbolig. E - Andet (bl.a. institutioner og erhverv). Da betydningen af koderne ikke har ændret sig, returneres feltet gennem BuildingDwellingV3 snitfladen. Feltet er et beregnet felt og kan ikke indberettes, hverken igenem BuildingDwellingV3 eller BuildingDwellingV4. Dette betyder i detaljer: Get metoderne og søgemetoderne leverer kun de gamle koder. Hvis en enhed har kode E, returneres feltet ikke, men der returneres null i stedet for. I en oprettelses- eller opdateringssituation bliver feltet ignoreret. 4.2. Ændret kodeliste til feltet Offentlig støtte for enhed Feltet Offentlig støtte (PublicSubsidyCode), som findes i strukturen BuildingUnitInformation på enhed, har ændret kodeliste fra version 3 til version 4. Kode 0 manglede fejlagtigt i det benyttede skema. Kodeliste i BuildingDwellingV3: 10 - Almen familiebolig 15 - Støttet privat udlejningsbolig 20 - Støttet privat andelsbolig: 25 - Almen ungdomsbolig 30 - Støttet privat ungdomsbolig 40 - Almen ældrebolig 42 - Almen plejebolig 80 Serviceareal Snitfladebeskrivelse Side 6 af 10
Kodeliste i BuildingDwellingV4: 0 Ingen offentlig støtte 10 - Almen familiebolig 15 - Støttet privat udlejningsbolig 20 - Støttet privat andelsbolig: 25 - Almen ungdomsbolig 30 - Støttet privat ungdomsbolig 40 - Almen ældrebolig 42 - Almen plejebolig 80 Serviceareal Da betydningen af koderne ikke har ændret sig, returneres feltet gennem BuildingDwellingV3 snitfladen og feltet kan indberettes så længe man ikke prøver at overskrive en eksisterende kode 0. Dette betyder i detaljer: Get metoderne og søgemetoderne leverer kun de gamle koder. Hvis en enhed har kode 0, returneres feltet ikke, men der returneres null i stedet for. Hvis man opretter eller opdaterer en enhed og sender BuildingUnitInformation strukturen med hvor indholdet for feltet PublicSubsidy- Code 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 4 af snitfladen. Hvis man gennemtvinger oprettelsen/opdateringen, bliver feltet oprettet/opdateret med den angivne værdi hhv. nullstillet dog med undtagelse af en situation: Når man ikke angiver feltet (nullstiller feltet) og den eksisterende værdi er kode 0, vil feltet ikke blive nullstillet. Hvis man opretter eller opdaterer en enhed og ikke sender BuildingUnitInformation strukturen med, betyder det, at man ikke ønsker at ajourføre alle felter i strukturen. I givet fald gives der heller ikke nogen advarsel. 4.3. Ændret kodeliste til feltet Tagdækningsmateriale og Supplerende tagdækningsmateriale for bygning Felterne Tagdækningsmateriale (RoofingMaterialCode) og Supplerende Tagdækningsmateriale (RoofingSupplementaryMaterialCode), som findes i strukturen BuildingMaterial på bygning, har ændret kodeliste fra version 3 til version 4. Der er kommet en ny kode, som er 20. Kodeliste i BuildingDwellingV3: 1 - Built-up 2 - Tagpap (med taghældning) 3 - Fibercement, herunder asbest (bølge- eller skifereternit) 4 - Cementsten Snitfladebeskrivelse Side 7 af 10
5 - Tegl 6 - Metalplader (bølgeblik, aluminium, o.lign.) 7 - Stråtag 10 - Fibercement (asbestfri) 11 - PVC 12 - Glas 80 - Ingen Kodeliste i BuildingDwellingV4: 1 - Built-up 2 - Tagpap (med taghældning) 3 - Fibercement, herunder asbest (bølge- eller skifereternit) 4 - Cementsten 5 - Tegl 6 - Metalplader (bølgeblik, aluminium, o.lign.) 7 - Stråtag 10 - Fibercement (asbestfri) 11 - PVC 12 Glas 20 Grønne tage 80 Ingen Da betydningen af koderne ikke har ændret sig, returneres feltet gennem BuildingDwellingV3 snitfladen og feltet kan indberettes så længe man ikke prøver at overskrive en eksisterende kode 20. Dette betyder i detaljer: Get metoderne og søgemetoderne leverer kun de gamle koder. Hvis en bygning har kode 20, returneres feltet ikke, men der returneres null i stedet for. Hvis man opretter eller opdaterer en bygning og sender Building- Material strukturen med hvor indholdet for feltet RoofingMaterial- Code eller RoofingSupplementaryMaterialCode 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 4 af snitfladen. Hvis man gennemtvinger oprettelsen/opdateringen, bliver feltet oprettet/opdateret med den angivne værdi hhv. nullstillet dog med undtagelse af en situation: Når man ikke angiver feltet (nullstiller feltet) og den eksisterende værdi er kode 20, vil feltet ikke blive nullstillet. Hvis man opretter eller opdaterer en bygning og ikke sender BuildingMaterial strukturen med, betyder det, at man ikke ønsker at ajourføre alle felter i strukturen. I givet fald gives der heller ikke nogen advarsel. Snitfladebeskrivelse Side 8 af 10
4.4. Ændret kodeliste til felt Byggeskadeforsikringsselskab for bygning Feltet Byggeskadeforsikringsselskab (BuildingDamageInsuranceCompanyCode), som findes i strukturen BuildingInsurance på bygning har ændret kodeliste fra version 3 til version 4. Der er blevt tilføjet koderne 10, 11, 12 og 13. Kodeliste i BuildingDwellingV3: 00 - Ingen byggeskadeforsikring 01 - Tryg 02 - Topdanmark 04 - Codan 05 - If forsikring 06 - Alm. Brand 07 - Danske Forsikring 08 - AmTrust International Underwrites Limited 09 Midtjysk Forsikring Kodeliste i BuildingDwellingV4: 00 - Ingen byggeskadeforsikring 01 - Tryg 02 - Topdanmark 04 - Codan 05 - If forsikring 06 - Alm. Brand 07 - Danske Forsikring 08 - AmTrust International Underwrites Limited 09 Midtjysk Forsikring 10 Købstædernes Forsikring 11 ALKA 12 Frida Forsikring Agentur 13 - NemForsikring Da betydningen af koderne ikke har ændret sig, returneres feltet gennem BuildingDwellingV2 snitfladen og feltet kan indberettes så længe man ikke prøver at overskrive en eksisterende kode 10, 11, 12 eller 13. Dette betyder i detaljer: Get metoderne og søgemetoderne leverer kun de gamle koder. Hvis en bygning har kode 10, 11, 12 eller 13, 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 4 af snitfladen. Hvis man gennemtvinger op- Snitfladebeskrivelse Side 9 af 10
rettelsen/opdateringen, bliver feltet oprettet/opdateret med den angivne værdi hhv. nullstillet dog med undtagelse af en situation: Når man ikke angiver feltet (nullstiller feltet) og den eksisterende værdi er kode 10, 11, 12 eller 13, vil feltet ikke blive nullstillet. 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. 4.5. Ændret navn til feltet Dato for pålæg fra Stormrådet for bygning Feltet Dato for pålæg fra Stormrådet i strukturen BuildingInsurance ændrer navn til Dato for skade hos Stormrådet. Det engelske navn for xsd skemaet StormCouncilInstructionDate bibeholdes dog, og der er kun ændringer til metadata-filen til feltet. Ændringen har således ikke nogen direkte betydning i forhold til brug af OIO snitfladen. Snitfladebeskrivelse Side 10 af 10