Schema s en services versie 2.0

Transcriptie

1 0.1 Koppelvlak LVBAG Bevragen Schema s en services versie 2.0 Webservices en berichten: v op basis van IMBAG 1.0 Datum 1 oktober 2015 Document versie 1.0 ConceptICT Services Keten RZDirectie IT

2 Versiehistorie Versie datum omschrijving Initiële versie Interne review verwerkt Kleine aanpassingen en 1.0 vaststelling. Versie / 19

3 Inhoudsopgave 1 Inleiding Gebruik Beta services Leeswijzer Referentie documentatie Aansluiten op BAG bevragen als klant, met PKI of username/wachtwoord Actueel ondersteunde koppelvlakken Schema: Informatie Model BAG UML IMBAG (versie ) UML IMBAG-typen (versie ) GML en geometrie Verkorte naam openbare ruimte (NEN5825:2002 nl, aanvullend op BAG) Uitgangsschema s voor de producten en gegevensvarianten Bevragen op datum, voor gegevensvariant Actueel en Peildatum (APD) UML Bevragen in een tijdvak, voor gegevenvariant Levenscyclus (LVC) UML Objecten zonder geometrie Vraag- en antwoordberichten Algemene schema s Bevragen op actueel of peildatum Bevragen van relaties Bevragen levenscyclus Webservices voor de dienst Bevragingen Bevragen op actueel of peildatum Bevragen relaties Bevragen levenscyclus Bijlage I: feedback Versie / 19

4 1 Inleiding Dit document beschrijft kort het koppelvlak van de dienst Bevragen van de Landelijke Voorziening BAG, specificatie release v welke in Productie is gegaan in de release van medio Deze release wordt beheerd door het Kadaster. Voor meer informatie kunt u terecht bij Koppelvlak Het begrip koppelvlak is een breed begrip. Dit document gaat in op berichtuitwisseling via WS-I Basic Profile 1.2 compliant webservices tussen de Landelijke Voorziening BAG en de Afnemers van dienst BAG-Bevragen. 1.1 Gebruik Het koppelvlak voor de dienst Bevragingen speelt ondere andere in op de volgende behoeftes. Actuele gegevens Via de dienst zijn BAG-gegevens op te vragen zoals deze op het moment van bevragen geldig zijn. Het zoeken naar BAG objecten en de gegevens hiervan via een eigen user interface of applicatie Elke applicatie met userinterfaces kan gebruik maken van de webservices van de dienst BAG Bevragen om gegevens op een scherm te tonen. Het is bijvoorbeeld mogelijk via een adres een BAG object te vinden en daarmee de gegevens zoals de identificatie, adres of geometrie. Deze gegevens zijn daarna te gebruiken voor verificatie of invoer in een proces. In het bijzonder ondersteunt dit proces het opslaan van de identificatie van een Object als alternatief voor het opslaan van het adres. Geautomatiseerd ophalen van gegevens op basis van de identificatie van een object en een datum De datum zal vaak de actuele datum zijn maar dit kan ook een peildatum zijn. Het resultaat is direct en geautomatiseerd te gebruiken in een eigen systeem, zonder tussenkomst van een gebruiker. Ook is het mogelijk om meerdere id s tegelijk op te vragen voor een overzicht op scherm in een eigen applicatie. De dienst BAG Bevragen biedt hiervoor synchrone webservices. Het is mogelijk om meerdere identificaties tegelijk op te geven om zo bijvoorbeeld bij het opbouwen van een overzicht op een scherm maar één bevragingen te doen met daarin meerdere BAG object identificaties. Het is niet de bedoeling om deze synchrone services te gebruiken voor een batchproces met een groot volume, hiervoor is de dienst BAG-Extract bedoeld. 1.2 Beta services De services in dit koppelvlak worden niet direct voor een aantal jaar bevroren. Er wordt eerst een bepaalde periode bekeken of de services nog verbeterd kunnen worden. Denk hierbij aan fouten of bugs, maar ook aan extra gegevens of aan betere datastructuren. We ontvangen hiervoor graag feedback van gebruikers! Hiervoor is een bijlage opgenomen. Een gevolg hiervan is wel dat de services nog aan veranderingen onderhevig zijn. Anders gezegd, als u op deze services aansluit kan het zijn dat u uw software nog aan moet passen aan de uiteindelijke versie. We zullen hier tijdig over communiceren, maar denk hierbij in termen van één of twee maanden. 1.3 Leeswijzer De Landelijke Voorziening BAG ontsluit via de genoemde berichten en services de BAG-gegevens, zoals beschreven in de Grondslagen, de PDC en het informatiemodel BAG (IMBAG) in de UML modelleringstechniek. Versie / 19

5 De services en berichten van het koppelvlak bevatten telkens deelverzamelingen van deze gegevens. De UML schema s waarop deze zijn gebaseerd worden eerst beschreven, te weten in H2 en H3. De XSD schema s staan beschreven in H4 en de webservice wsdl s en bijbehorende endpoints URI s staan in H5. De webservices (WSDL) en de links (URL) waarop deze zijn gepubliceerd zijn beschreven in H5. De schemadefinities zijn beschikbaar op o.v.v. bag-verstrekkingen. 1.4 Referentie documentatie Te vinden op: [Informatieproducten] informatieproducten BAG Verstrekkingen versie 2.6.x (medio 2015) [Foutmeldingen] BAG foutmeldingen BAG Bevragen (pdf) BAG PKI overheid certificaten (pdf) Overige gerelateerde BAG Verstrekkingen producten- en dienstencatalogus (pdf) documenten BAG Diensten Niveau Overeenkomst (pdf) 1.5 Aansluiten op BAG bevragen als klant, met PKI of username/wachtwoord BAG Bevragen is een dienst van de Landelijke Voorziening BAG. Technisch bestaat deze uit webservices (SOAP) waarbij authenticatie vereist is. De authenticatie vindt plaats via PKI en/of username/wachtwoord. Voor informatie over het product en de dienst wordt verwezen naar de referenties zoals hierboven genoemd en naar algemene documentatie. Zie: Aanmelden als klant Als u nog geen klant bent van het kadaster, of wel een klant bent maar nog zonder gebruik te maken van de dienst BAG Bevragen, dan kunt u hiervoor het volgende aanmeldformulier gebruiken: Aansluiten via PKI Dit is beschreven op: Alle uri s voor deze webservices beginnen met: De services in dit koppelvlak gaan ervan uit dat uw certificaat het OIN nummer van uw organisatie bevat Aansluiten via username en wachtwoord / basic authentication Hls u al klant bent, heeft u een Mijn Kadaster account met een login voor een gebruiker gekregen. De username en wachtwoord van deze gebruiker zijn te gebruiken voor de webservices van bag-bevragen. Het is ook mogelijk om specifiek voor bag-bevragen een nieuwe user aan te maken en die te gebruiken. Ga zorgvuldig met deze gegevens om binnen uw eigen organisatie. Alle url s voor deze webservices beginnen met: bag-bevragen/ Testen vanuit een testomgeving Het is toegestaan om de services van de LVBAG te benaderen vanuit een testomgeving. Dit is uitsluitend mogelijk op basis van username/wachtwoord. Versie / 19

6 Het is niet mogelijk om te testen vanuit een testomgeving met een PKI test certificaat, omdat de services van de productie omgeving van de LVBAG geen test certificaten accepteren. U kunt voor het testen de services op basis van username/wachtwoord gebruiken/overwegen. Zie ook de volgende paragraaf PKI gebruiken in productie conform Digikoppeling, maar testen via username/wachtwoord Wanneer uw organisatie kiest voor username/wachtwoord in productie, dan is deze paragraaf niet voor uw organisatie van toepassing. Als uw organisatie wil voldoen aan de Digikoppeling en dus PKI gebruikt, met daarin een OIN, dan is het meestal niet voldoende om in een testomgeving te testen met username/wachtwoord. Testprocessen vereisten immers meestal dat een acceptatie testomgeving zoveel mogelijk dezelfde technische implementatie wordt gebruikt als in productie. Een aanpak kan zijn om de test in twee aparte stappen onder te verdelen. De eerste is een functionele test, uitgevoerd met username/wachtwoord, met als doel om de software functioneel te testen met de volledige dataset uit de LVBAG. Als dat succesvol is kan de technische implementatie aangepast worden, zodat er een integratie test met de LVBAG gedaan kan worden, uitgevoerd met PKI. Deze laatste technische implementatie wordt vervolgens naar productie gebracht. 1.6 Actueel ondersteunde koppelvlakken Alleen versie b wordt beschreven in dit koppelvlak document: Releasedatum Services Wsdl versies Uitfaseerdatum Bijzonderheden Medio 2015 Alle services uit H b Nog niet bepaald PKI en Basic Authentication De b staat voor beta De dienst bag-bevragen kent verder nog twee koppelvlakken die ten tijde van het uitbrengen van dit koppelvlak in productie staan. Deze versies staan er (alleen) voor het overzicht in: Releasedatum Services Wsdl versies Uitfaseerdatum Bijzonderheden 01/12/2009 Alle services uit H Medio 2016 Alleen PKI 01/05/2014 Alle services uit H Nog niet bepaald Ook Basic Authentication met username/ww Verschillen tussen versie v en v De services in dit koppelvlak bevatten een aantal verbeteringen ten opzichte van het vorige koppelvlak. Dit zijn: o Kleine verbeteringen in IMBAG o Het voorkomen van (te) grote berichten, als gevolg van het niet ontdubbelen van gegevens o Het registratietijdstip waarop een gegeven beschikbaar is gekomen voor afnemers van de LV o Er kan gekozen worden om de woonplaatsgeometrie weg te laten uit het antwoordbericht o IMBAG bevat geen enumerations meer in de XSD, om te voorkomen dat een XSD wijziging nodig is als er een waarde bijkomt. Het type Waardelijst wordt gebruikt. De waardes zijn hetzelfde gebleven. o Functionele fouten in reponse i.p.v. apart foutbericht (en technische fouten als SOAP fault) o URI van de service Versie / 19

7 2 Schema: Informatie Model BAG De gegevens van de BAG zijn beschreven in de documenten Grondslagen Adressen en Grondslagen Gebouwen. Vervolgens zijn deze gegevens in samenhang gemodelleerd in de vorm van een UML class diagram: het Informatie Model BAG (IMBAG) wordt beheerd door het Kadaster. Het model vormt de basis voor het ontwerp van alle gegevens gerelateerde zaken, zoals database, producten, diensten en XML berichten. 2.1 UML IMBAG (versie ) XSD schema: IMBAG_AdressenGebouwen_v1_0_0.xsd Versie / 19

8 2.2 UML IMBAG-typen (versie ) Er wordt een aantal bijzondere typen gebruikt: XSD schema: IMBAG_Typen_v1_0_0.xsd De meeste hierboven genoemde types worden op diverse plekken hergebruikt en zijn daarom als apart type opgenomen. o o o o Het type Indicatie is altijd J(a) of N(ee). Een objectnummering is altijd 16 lang, mét voorloopnullen. Het is een string die alleen uit getallen bestaat. Alle objecten behalve Woonplaats gebruiken het type Objectnummering. Woonplaats gebruikt Woonplaatscodering, deze is altijd 4 lang, mét voorloopnullen. Tijdvakgeldigheid wordt op diverse plekken hergebruikt. Het gaat hier in principe om datums. Het type lijkt echter op een datum-tijd, maar moet geïnterpreteerd worden als een datum. Het tijd-deel van de datum is om meerdere voorkomens op één dag uniek van elkaar te kunnen onderscheiden. Dit moet geïnterpreteerd worden als een volgnummer binnen de dag. De hoogste c.q. laatste is degene die telt bij een bevraging op deze dag (actueel of peildatum). Een attribuut kan van twee verschillende typen zijn. Dus het ene type, of een ander type. Dit is gemodelleerd als union. Dit komt alleen voor bij geometrie. Dit komt bijvoorbeeld voor bij een Verblijfsobject geometrie. Dit is ofwel een Point, ofwel een Surface. Daarnaast hebben een aantal attributen een restriction zoals een maximale lengte, of een pattern zoals een postcode moet bestaan uit getal, getal, getal, getal, letter, letter. Deze zijn in de XSD schema s zelf opgenomen. Versie / 19

9 2.3 GML en geometrie De BAG kent geometrie. Geometrie attributen zijn gemodelleerd in GML IMBAG maakt gebruik van de GML definities zoals uitgegeven door OGC. BAG heeft de GML types die nodig zijn voor BAG één op één overgenomen naar een subset schema: /gml/ bag-gml.xsd (met exact dezelfde namespaces en element namen). De GML types die gebruikt worden zijn GM_Point, GM_Surface en GM_Multisurface. Als een attribuut meerdere GM types kan bevatten, dan is er een union class gemaakt. Documentatie van GML elemement staat op: en schemas.opengis.net. targetnamespace = " Prefix xmlns:gml = " De BAG gebruikt de volgende GML types uit GML o GM_Point: PointPropertyType, met daarbinnen gml:pos o GM_Surface: SurfacePropertyType, met daarbinnen gml:polygon, gml:linearring, gml:poslist. De BAG kent gml:exterior ring en gml:interior ring. o GM_MultiSurface: MultiSurfacePropertyType, met daarbinnen gml:multiploygon en zoals Surface. pos: de geometrie bevat altijd één of meer puntcoördinaten, welke staan voor een positie in een Coördinate Reference System (CRS). Bij 2D zijm dit 2 punten (x,y) en bij 3D zijn dit er 3 (x,y,z). Een setje van 2 of 3 punten en coördinaten bij elkaar worden in GML posities genoemd. GML bestaat een positie uit 2 of 3 getallen en elk getal is een double. In GML mapped dit als volgt: gml:pos heeft type gml:directpositiontype, gml:poslist heeft type gml:directpositionlisttype. De DirectPosition(List)Type heeft type gml:doublelist, dit is een List van één of meer double s. srsdimension en count zijn altijd gevuld en de urn is altijd: urn:ogc:def:crs:epsg:: Verkorte naam openbare ruimte (NEN5825:2002 nl, aanvullend op BAG) In de BAG wordt het object Openbare ruimte geleverd, welke als authentiek gegeven het attribuut naam openbare ruimte bevat. Indien dit BAG-attribuut een lengte heeft van meer dan 24 dan wordt er in de BAG producten een aanvullend gegeven meegeleverd welke is ingekort 2 op basis van de NEN5825:2002 NL standaard tot een lengte van 24 of minder. Het aanvullende gegeven wordt geleverd via het attribuut verkorte naam openbare ruimte en dit is géén authentiek gegeven van de BAG. Er vind geen beheer plaats op dit aanvullende gegeven en wijzigingen hierin resulteren niet in extra voorkomens in de levenscyclus van een object. Het attribuut wordt geleverd als attribuut van de entiteit Openbare ruimte, maar om duidelijk herkenbaar te maken dat het géén BAG attribuut betreft is er gekozen om aan het attribuut in een apart (niet-bag) schema onder te brengen. IMBAG_NEN5825_v1_0_0.xsd XML prefix en namespace: nen5825: 1 GML is een product van OGC en is de standaard voor GEO-metrie met XML. 2 Deze inkorting wordt uitgevoerd op basis van een zo juist mogelijke interpretatie van de NEN5825:2002 norm. Versie / 19

10 3 Uitgangsschema s voor de producten en gegevensvarianten Alle informatieproducten van de BAG, zoals deze worden geleverd aan Afnemers, zijn gebaseerd op het IMBAG. Dit betekent dat alle relaties en attributen en types, indien gebruikt in een informatieproduct, dit model volgen. Voor de betekenis en definitie van de gegevens zelf wordt verwezen naar de Grondslagen BAG. 3.1 Bevragen op datum, voor gegevensvariant Actueel en Peildatum (APD) UML Het schema IMBAG_AdressenGebouwenAPD_v1_0_0.xsd wordt gebruikt om een voorkomen te leveren Het APD schema komt grotendeels overeen met het basisschema van IMBAG zoals beschreven in 2.1, te weten voor zowel naamgeving, attributen en relaties. De via relaties aan elkaar gerelateerde gegevens van objecten worden grotendeels geleverd in de geneste structuur van IMBAG 3, zie ook H4. Maar wanneer bijvoorbeeld een openbare ruimte bij meerdere nummeraanduidingen dezelfde is, dan zou deze meerdere malen identiek voorkomen in het product, als de geneste structuur van IMBAG gevolgd wordt. Er is gekozen om dan de openbare ruimte maar één keer op te nemen in het product. Er is gekozen om in de geneste structuur van IMBAG de relatie door te knippen. In plaats van dat de gegevens van het gerelateerde object genest zijn opgenomen, staat er alleen de identificatie. De verdere gegevens van het gerelateerde object staan ook in het product opgenomen. Via de overeenkomende identificatie zijn de gegevens weer bij elkaar te vinden (of is het mogelijk om, indien gewenst, om de relatie weer te herstellen). XSD Schema: IMBAG_AdressenGebouwenAPD_v1_0_0.xsd 3 Meest gebruikte structuur en geoptimaliseerd om eenvoudig bruikbaar te zijn voor gegevens op een momentopname Versie / 19

11 3.2 Bevragen in een tijdvak, voor gegevenvariant Levenscyclus (LVC) UML Dit schema kent een uitgebreidere structuur om een levenscyclus van een Object te leveren. Een levenscyclus van een object bestaat uit meerdere voorkomens van dit object door de tijd heen. Hierin kan bijvoorbeeld een Openbare Ruimte (Object met Voorkomens) door de tijd heen bijvoorbeeld gekoppeld zijn aan twee Woonplaatsen (Objecten met elk meerdere Voorkomens). Het schema voor Tijdvak c.q. Levenscyclus komt sterk overeen met het basisschema van IMBAG zoals beschreven in 2.1 voor zowel naamgeving en attributen, maar niet voor relaties. De producten bestaan veelal uit voorkomens van het gevraagde Objectype. Voor relaties, te weten de gerelateerde Objecten en Voorkomens, is echter alleen het attribuut identificatie opgenomen (van het type Objectnummer of Woonplaatscode), analoog aan de doorgeknipte relatie zoals beschreven in de vorige paragraaf. De structuur is dus niet genest 4. Voor de relaties naar Woonplaats en Openbare ruimte is dit hetzelfde als bij het APD schema, maar dan ook doorgetrokken naar de relaties naar Nummeraanduiding en de relatie naar Pand. XSD Schema: IMBAG_AdressenGebouwenLVC_v1_0_0.xsd 4 Deze structuur is analoog aan de structuur van de dienst BAG-Extract. Dit maakt het mogelijk dat er maar 2 structuren zijn binnen de BAG diensten. Versie / 19

12 3.3 Objecten zonder geometrie Het is mogelijk om bij de vraag aan te geven dat er geen geometrie gewenst is in het antwoord. Dit geldt momenteel alleen voor de woonplaats, waarvan de geometrie kan worden weggelaten. De woonplaats wordt dan als volgt geleverd: IMBAG_AdressenGebouwenNoGeo_v1_0_0.xsd Indien u alleen producten met erin alleen de BAG objecten Woonplaats, Openbare ruimte en Nummeraanduiding wilt ontvangen, en geen woonplaats geometrie wilt ontvangen, dan hoeft u in principe geen gebruik te maken van het GML schema. In principe kunt u dan, indien dat prettiger is voor software ontwikkeling, het GML schema, en alle GML types, verwijderen uit het IMBAG APD of IMBAG LVC schema. Versie / 19

13 4 Vraag- en antwoordberichten 4.1 Algemene schema s Deze worden gebruikt in alle services. In het Procesverwerking schema is aangeven of er een passend antwoord bij een vraag gevonden kon worden. Als er iets niet goed is gegaan dan wordt er een functionele fout gegeven, zie [foutmeldingen]. Een procesverwerkingscode betekent: 0 = mislukt, er is een functionele fout (error) 1 = gelukt 2 = gedeeltelijk gelukt. Dit wordt gezien als een goed situatie, er wordt geen functionele fout gegeven zoals bij 0. Dit komt alleen voor wanneer een aantal in de vraag opgegeven identificaties zijn gevonden inde LVBAG, en een aantal niet. Er wordt dan wel een antwoord gegeven, met daarin de gegevens van de gevonden objecten. identificaties die niet gevonden zijn worden gemeld, in het veld melding. Bij een technische fout wordt altijd een SOAP-fault gegeven. De services maken ook gebruik van XSD validatie. Dit resulteert in een SOAP-fault. Hierin is te zien waardoor de validatie fout is ontstaan. De productcode kan optioneel opgegeven worden. Dit kan handig zijn indien u zeker wilt zijn dat u het goede informatieproduct uit [informatieproducten] bevraagd. Er volgt een foutmelding indien de opgegeven productcode niet overeenkomt met de selectie ingang die gebruikt is in een service. Versie / 19

14 4.2 Bevragen op actueel of peildatum Service naam: BagvsObjectBevragenApd Root schema: BagvsObjectBevragenApd_Messages_2_0_0.xsd Gebruikt IMBAG schema: IMBAG_AdressenGebouwenAPD_v1_0_0.xsd De producten bevatten de gegevens conform [informatieproducten] op een momentopname. Het request bevat alle mogelijk selectie ingangen om de producten op te kunnen vragen. Per product is aangegeven wat de mogelijke selectie ingangen zijn. Dit kan zijn: een bag object identificatie, meerdere bag object identificaties, of een selectie ingang met adresgegevens. Optioneel kan een peildatum opgegeven worden. Bij geen opgave wordt dit vandaag. Optioneel kan aangegeven worden of de geometrie van woonplaats weggelaten moet worden. De response bevat: het opgevraagde product, of producten in het geval van meerdere identificaties, conform [informatieproducten]. Het response diagram laat het product zien waarin een adresseerbaar object (ADO) centraal staat. Er zijn een aantal andere producten voor APD, deze zijn niet getoond in onderstaand diagram. Versie / 19

15 4.3 Bevragen van relaties Service: BagvsObjectBevragenApdRelaties.xsd Rootschema: BagvsObjectBevragenApdRelaties_Messages_2_0_0.xsd Gebruikt IMBAG schema: IMBAG_AdressenGebouwenAPD_v1_0_0.xsd De producten bevatten de gegevens conform [informatieproducten] op een momentopname. Het request bevat de selectie ingangen om via relaties de gerelateerde objecten op te vragen. Zo is ook op te vragen wat de openbare ruimtes in een woonplaats zijn en wat de nummeraanduidingen in een openbare ruimte zijn. Per relatie is de selectie ingang altijd alleen de bag identificatie van het object die de relatie in IMBAG bevat. Optioneel kan een peildatum opgegeven worden. Bij geen opgave wordt dit vandaag. Optioneel kan aangegeven worden of de geometrie van woonplaats weggelaten moet worden. De response bevat de gerelateerde objecten. Dit kunnen er (soms) 0 zijn, want er zijn openbare ruimtes zonder nummeraanduidingen. Versie / 19

16 4.4 Bevragen levenscyclus Service: BagvsObjectBevragenLvc.xsd Rootschema: BagvsObjectBevragenLvc_Messages_2_0_0.xsd Gebruikt IMBAG schema: IMBAG_AdressenGebouwenLVC_v1_0_0.xsd De response bevat het gevraagde bag object, met alle gerelateerde objecten elk in een eigen lijst. Versie / 19

17 5 Webservices voor de dienst Bevragingen Dit hoofdstuk geeft een overzicht van de (web)services van BAG voor de dienst Bevragingen. Elke webservice kent operaties (elementaire services) waarin via een request (vraag, met bijbehorende vraagbericht) een response (antwoord, met bijbehorend antwoordbericht) verkregen kan worden. Alle berichten bevatten een unieke namespace en een elementname om zo de gebruikte vraag- en antwoordberichten eenduidig vast te kunnen stellen. 5.1 Bevragen op actueel of peildatum Webservice: BagvsObjectBevragenApd Versie: Operaties: Vraag- en antwoordbericht ObjectBevragenApd BagvsObjectBevragenApd_Messages_2_0_0.xsd URI PKI 5 : URI BA 6 : WSDL: PKI_BagvsObjectBevragenApd_v2_0_0_b.wsdl of BA_BagvsObjectBevragenApd_v2_0_0_b.wsdl Bevragen relaties Webservice: BagvsObjectBevragenApdRelaties Versie: Operaties: Vraag- en antwoordbericht ObjectBevragenApdRelaties BagvsObjectBevragenApdRelaties_Messages_2_0_0.xsd URI PKI 7 : URI BA 8 : WSDL: PKI_BagvsObjectBevragenApd_v2_0_0_b.wsdl of BA_BagvsObjectBevragenApd_v2_0_0_b.wsdl Bevragen levenscyclus Webservice: BagvsObjectBevragenLvc Versie: Operaties: Vraag- en antwoordbericht ObjectBevragenLvc BagvsObjectBevragenLvc_Messages_2_0_0.xsd URI PKI 9 : URI BA 10 : WSDL: PKI_BagvsObjectBevragenLvc_v2_0_0_b.wsdl of BA_BagvsObjectBevragenLvc_v2_0_0_b.wsdl 5 Public Key Infrastructure 6 Basic authentication op basis van username en wachtwoord 7 Public Key Infrastructure 8 Basic authentication op basis van username en wachtwoord 9 Public Key Infrastructure 10 Basic authentication op basis van username en wachtwoord Versie / 19

18 Bijlage I: feedback Bij de totstandkoming van de services en schema s zijn onderstaande keuzes gemaakt. Er zijn diverse andere opties en keuzes te maken. Het is echter ongewenst om alle opties, in elke combinatie, te implementeren. Dat is onoverzichtelijk en duur. Via feedback zijn we op zoek naar wat gewenst is, om een balans te vinden die de (meeste) behoeftes afdekt. De schema s van het koppelvlak zijn momenteel gebaseerd op: Standaard conform de BAG grondslagen catalogus o De zeven objecttypen, met in principe alle attributen van een object. o Geen platgeslagen adres in plaats hiervan, of zonder extra veld adres voor extra gemak. o Navigatierichting voor XML hiërarchisch, conform de grondslagen catalogus attributen, waarin een gerelateerd (target) object is opgenomen als attribuut van een (source) object. o Geen extra navigatie van pand naar verblijfsobject, omdat dit niet conform de standaard navigatierichting is. Er wordt daarom een choice geleverd met een pand, óf een aantal verblijfsobjecten die zelf een relatie hebben naar het pand. Het pand kan daarom, te weten wanneer er meerdere VBO s in hetzelfde pand liggen, dubbel voorkomen in de XML. o Niet gedaan: alle attributen naar keuze wel of niet opnemen in het antwoord. Dit kan door middel van de XML nillable constructie, of met XML templating. Dit is een generieke manier om aan verschillende behoeftes te voldoen, maar beide XML technologiën maken de XML complexer. o Er worden geen inactieve voorkomens geleverd. Mogelijk wordt het in de toekomst mogelijk om optioneel ook de inactieve voorkomens te ontvangen bij bevragen op levenscyclus. GML o GML en (nog) niet GML o Alle objecten in principe met geometrie conform de grondslagen catalogus. o De geometrie is optioneel weg te laten voor (alleen) de woonplaats, omdat deze nogal groot is. Omdat de woonplaatsen in het antwoordbericht worden ontdubbeld valt het overigens mee met de grootte van antwoordberichten met meerdere verwijzingen naar dezelfde woonplaats o Verder alle objecttypes met geometrie, niet optioneel weg te laten per objecttype en niet optioneel voor alle objecttypes. Schema voor peildatum (APD) en schema voor levenscyclus (LVC) o De meeste afnemers gebruiken het APD schema. Dit schema levert de gegevens zoals deze op een bepaald moment in de tijd zijn, meestal de actuele situatie. De structuur voor levenscyclus is complexer. We leveren daarom niet één schema (het meest complexe schema), maar twee schema s. o Het APD schema bevat de meeste objecten in een geneste structuur, behalve voor openbare ruimte en woonplaats, zodat deze ontdubbeld kunnen worden. Bij meerdere resultaten moeten deze weer bij elkaar gezocht worden. Alternatieven zijn: o Gegevens wel dubbel op te nemen, in de standaard geneste structuur. Dan hoeven gegevens ook niet bij elkaar gezocht te worden. o Altijd het levenscyclus schema gebruiken. o Wel de standaard geneste structuur, maar zonder gegevens dubbel op te nemen. Dit kan door gebruik maken van de xlink technologie, waarin intern in de XML een id wordt gegeven aan een element, en als deze dubbel voorkomt, om dan te verwijzen met deze id. Dit is complexer. Versie / 19

19 Uitwisselingsformaat: XML o Er is gekozen voor XML omdat dit de meest ondersteunde standaard is voor gegevensuitwisseling. o Het is echter ook mogelijk om de gegevens (ook) te leveren in bijvoorbeeld GML of in JSON of in linked open data, of om bepaalde aanvullende standaarden toe te passen. Reactie formulier Naam: Organisatie: Afnemer van BAG Bevragen? Ja / Nee (klantnummer, indien bekend: ) Onderwerp Zo houden Liever (ook) zo Gegevensdefinitie Conform BAG catalogus Geen inactieven Bv. ook optioneel wel inactieven Navigatierichting GML Altijd geometrie Gegevenstructuur Apart voor LVC en APD Ontdubbeling via ont koppeling Bv. liever xlink Uitwisselingsformaat XML Versie / 19