OIOXML Vejledning til OIOXML snitflade for Bygninger og boliger BuildingDwelling.wsdl Tillæg til BuildingDwellingV5 + V6/ Ændringer i BuildingDwellingV7 En vejledning rettet mod 3. part.
Indholdsfortegnelse 1. Introduktion... 3 2. Ændrede felter i BuildingDwellingV7... 4 2.1. Ændret kodeliste til felt Påbud om forbedret rensning for bygning og grund... 4 3. Nye felter i BuildingDwellingV7... 5 3.1. 2 nye felter vedr. flexboliger for enhed... 5 Snitfladebeskrivelse Side 2 af 6
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 20.06.2011 i forbindelse med at Nyt release 1.3 er blevet sat i drift. BuildingDwellingV2 er blevet udfaset den 09.02.2012 i forbindelse med at Nyt release 1.4 er blevet sat i drift. BuildingDwellingV3 udfases den 09.04.2013 i forbindelse med at Nyt release 1.5 sættes i drift. BuildingDwellingV4 udfases den 2.7.2014 i forbindelse med at Nyt release 1.5.3 sættes i drift. BuildingDwellingV5 har været i drift siden 9. 4. 2013, og denne version fortsætter med at eksistere. BuildingDwellingV6 har været i drift siden 2. 7. 2014, og denne version fortsætter med at eksistere. BuildingDwellingV7 er pr. 5.10.2015 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å http://demo.bbrkommune.dk/services/. Brugere af version 5 og version 6 af snitfladen kan fortsætte med at benytte version 5 hhv. 6, dog skal brugerne være opmærksomme på de i denne vejledning beskrevne uhensigtsmæssigheder, som er forbundet med dette. Brugere af version 7 af snitfladen kan benytte denne vejledning for at få et hurtigt overblik over ændringer i version 7 i forhold til version 5 og 6. Snitfladebeskrivelse Side 3 af 6
I produktionsmiljø findes snitfladernes endpoint her: https://bbr-kommune.dk/services/servicegateway/buildingdwellingservicev5.svc https://bbr-kommune.dk/services/servicegateway/buildingdwellingservicev6.svc https://bbr-kommune.dk/services/servicegateway/buildingdwellingservicev7.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/ 2. Ændrede felter i BuildingDwellingV7 2.1. Ændret kodeliste til felt Påbud om forbedret rensning for bygning og grund Feltet Påbud om forbedret rensning (WastewaterImprovementInjunctionCode), som findes i strukturen WaterDrainage på bygning og grund har ændret kodeliste. Der er blevt tilføjet koderne 6 og 7. Kodeliste i BuildingDwellingV5 hhv. BuildingDwellingV6: 0 Ikke oplyst 1 - Rensning ok. Intet påbud 2 - Rensning skal forbedres til SOP 3 - Rensning skal forbedres til SO 4 - Rensning skal forbedres til OP 5 - Rensning skal forbedres til O Kodeliste i BuildingDwellingV7: 0 Ikke oplyst 1 - Rensning ok. Intet påbud 2 - Rensning skal forbedres til SOP 3 - Rensning skal forbedres til SO 4 - Rensning skal forbedres til OP 5 - Rensning skal forbedres til O 6 Skal tilsluttes spildevandsforsyningsselskab 7 Skal tilsluttes separatkloakering Håndtering af ændringen i BuildingDwellingV5 og BuildingDwelling6: Feltet returneres gennem BuildingDwellingV5 og V6 snitfladen og feltet kan indberettes så længe man ikke prøver at overskrive en eksisterende kode 6 eller 7. Dette betyder i detaljer: Get metoderne og søgemetoderne leverer kun de gamle koder. Hvis en bygning hhv. grund har kode 6 eller 7, returneres feltet ikke, men der returneres null i stedet for. Hvis man opretter eller opdaterer en bygning hhv. grund og sender Water- Drainage strukturen med hvor indholdet for feltet WastewaterImprovementInjunctionCode er forskelligt fra det eksisterende feltindhold, gives der en en sandsynlighedsbesked (ResponseReasonIdentifier=5000). Det Snitfladebeskrivelse Side 4 af 6
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 7 af snitfladen. Hvis man gennemtvinger oprettelsen/opdateringen, bliver feltet oprettet/opdateret med den angivne værdi hhv. nullstillet dog med undtagelse af 1 situation: Når man ikke angiver feltet (nullstiller feltet) og den eksisterende værdi er kode 6 eller 7, vil feltet ikke blive nullstillet. Hvis man opretter eller opdaterer en bygning hhv. grund og ikke sender WaterDrainage strukturen med, betyder det, at man ikke ønsker at ajourføre alle felter i strukturen. I givet fald gives der heller ikke nogen advarsel. 3. Nye felter i BuildingDwellingV7 3.1. 2 nye felter vedr. flexboliger for enhed Der er blevet tilføjet 2 nye felter til enheder i strukturen BuildingUnitInformation på enhed niveau. Nye felter i BuildingUnitInformation Feltnavn i OIOXML navn Kommentar Flexbolig Tilladelsesart FlexDwellingPermissionCode Koder: 1 - Upersonlig tilladelse uden tidsbegrænsning 2 - Personlig tilladelse uden tidsbegrænsning 3 - Upersonlig tilladelse med tidsbegrænsning 4 - Personlig tilladel med tidsbegrænsning Feltet er obligatorisk at udfylde ved udstedelse af flexboligtilladelser. Det angives, hvorvidt tilladelsen er personlig eller tidsbegrænset. Husk at udfylde datofeltet ved tidsbegrænsede tilladelser. Er der tale om en personlig tilladelse kan navnet på den person, som tilladelsen er udstedt til evt. noteres i en notatlinje. Flexbolig Ophørsdato FlexDwellingExpirationDate Datoen skal ligge mellem år 2000 og 2200. Dato for ophør af tidsbegrænset flexboligtilladelse. Skal altid udfyldes ifm. Udstedelse af tidsbegrænsede tilladelser. Snitfladebeskrivelse Side 5 af 6
Håndtering af ændringen i BuildingDwellingV5 og BuildingDwelling6: Ændringen behøves ikke at blive håndteret. Man skal bare være opmærksom på, at felterne ikke leveres som en del af BuildingUnitInformation strukturen i version 5 og 6. Snitfladebeskrivelse Side 6 af 6