Basisregistratie Ondergrond (BRO) Koppelvlakbeschrijving



Vergelijkbare documenten
Basisregistratie ondergrond (BRO) Uitgiftehandboek

Basisregistratie ondergrond (BRO) Innamehandboek

Basisregistratie ondergrond (BRO) Innamehandboek

Basisregistratie ondergrond (BRO) Uitgiftehandboek

Basisregistratie Ondergrond (BRO) Handleiding voor aansluiten op webservices. Datum 13 januari 2017 Status Versie 1.0

Basisregistratie Ondergrond (BRO) Een handreiking voor conversie

Basisregistratie Ondergrond (BRO) Catalogus

13: Inloop Pauze Afsluiting

Basisregistratie Ondergrond (BRO) Een handreiking voor conversie

Basisregistratie Ondergrond

Basisregistratie Ondergrond (BRO) Uitgiftehandboek

OVERZICHT ACTUELE DOCUMENTATIE EN COMPLIANCE

Handleiding voor aansluiten op Digilevering

Bijlage 1-Procedure voor de implementatie van het AGR-GPS systeem PROCEDURE VOOR DE IMPLEMENTATIE VAN HET AGR-GPS SYSTEEM

Basisregistratie Ondergrond (BRO) Handleiding voor innameloket Geotechnisch Sondeeronderzoek. Datum 4 juli 2017 Status Versie 1.0

Koppelvlakbeschrijving statusservice Bancaire Infrastructurele Voorzieningen. Het ophalen van statusinformatie bij de BIV

Ministerie van Economische Zaken, Landbouw en Innovatie. Geoboer. Interface Specificatie

Koppelvlakbeschrijving mededelingenservice Bancaire Infrastructurele Voorzieningen. Het ophalen van mededelingen bij de BIV

Schema s en services Koppelvlakversie 2.1

Standaard koppelvlak Digikoppeling adapter Servicebus. Datum: 18 augustus 2014 Versie: 0.3 Auteur: M. van den Broek

Beschrijving OpenTunnel koppelvlak met MijnOverheid BerichtenBox

Schema s en services versie 2.0

Aanvragen en gebruik Overheids IdentificatieNummer (OIN)

Basisregistratie Ondergrond (BRO) Testen verbinding webservices met SoapUI Booronderzoek. Datum 28 maart 2017 Status Versie 1.0

Bancaire Infrastructurele Voorziening Aanleverservice. Implementatie conform koppelvlak WUS 2.0 Bedrijven

Inzenden en ontvangen aangifte

Koppelvlakken en de verschillen BIV - DigiPoort

HDN DARTS WEB AUTHENTICATIE

0.1 Verdieping BAG Bevragen. versie 0.1. Datum. 1 juli Document versie. 0.1 ConceptICT Services Keten RZDirectie IT

0.1 LVBAG Bevragen Productbeschrijving. versie 1.0. Datum. 10 augustus Document versie. 1.0 ConceptICT Services Keten RZDirectie IT

1. Milieuklacht Handleiding opladen XML in mkros Werken met Refertes... 5

Uniforme Pensioen Aangifte (UPA)

XML Datafeeds. Volledig geautomatiseerd advertenties plaatsen V

Service API Specificatie. Key2Parkeren Koppelvlak Kentekenwijziging

Handleiding PDOK gebruik ten behoeve van Afnemers

Digikoppeling Glossary

Dit voorbeeldproject beschrijft het gebruik van web services (open standaarden) voor de ontsluiting van kernregistraties bij de gemeente Den Haag.

Functioneel ontwerp. Regisseur

Basisregistratie Ondergrond (BRO) Uitgiftehandboek

Technische documentatie Overdracht bedrijfsvoorraad B2B AFS 6.2

Impactanalyse Samenwerkende Catalogi 4.0. Wat zijn de wijzigingen met de komst van SC 4.0 ten opzichte van SC 2.1

Schema s en services. Webservices en berichten: v op basis van IMBAG mei ConceptICT Services Keten RZDirectie IT

Rijbewijsvalidatie SOAP service

Early Adopters Berichtenbox MijnOverheid Sessie Techniek

Basisregistratie Ondergrond (BRO) Catalogus

Juliana van Stolberglaan CA Den Haag Postbus AC Den Haag [Handleiding Generieke interface Energielabels.

2BA Deeplink Gebruiksbeschrijving

Gebruikers Handleiding Webservice Verzekering Afsluiten

Basisregistratie Ondergrond, BRO

1 XML/CSV documentatie

Handleiding voor implementatie WEBSERVICE GEOCODEREN

Digikoppeling Grote berichten

XML Datafeeds. Volledig geautomatiseerd advertenties plaatsen V

Gebruikershandleiding Digikoppeling Compliance Voorziening (Portaal)

Toepassingsprofiel Berichtenmodel Omgevingsdocumenten

Basisregistratie Ondergrond (BRO) Koppelvlakbeschrijving

Informatie Model Omgevingswet (IMOW) de keten van plan tot publicatie. Versie 0.98-beta

Aanlevering NHR datasets 2019 Pacemaker- en ICD registratie. Definitief / 30 november 2018 / versie

Technische afspraken Ketenregister

FOUTAFHANDELINGEN TIJDENS HET AANLEVEREN VAN BESTANDEN VOOR KNOOPPUNTDIENSTEN WMO EN JW

Praktijkrichtlijn IMBRO

Basisregistratie Ondergrond (BRO) Van Peilbuis Tot Portal (VPTP) Hans van der Meij. Geologische Dienst Nederland, TNO

SETU Wijzer. U wilt met de SETU-standaard werken, maar waar moet u beginnen?

Functionele en technische meldingen

Rapport. Versiebeheer. Aan te sluiten overheidspartij Kamer van Koophandel Nederland

Dat we scherpe en compacte schema s kunnen maken voor berichten in koppelvlakken, en die ook kunnen beheren. Dat we op een consistente manier

HTTP SMS API Technische Specificatie messagebird.com versie mei 2014

BRO Architectuur. Versienummer 0.8. Datum 27 februari 2013 Status Concept. Disclaimer

Best Practices WUS Digikoppeling 2.0

BIM-validatietool Toetst data bij aanlegprojecten

Security web services

Technische documentatie Tellerstand dienst (OKR) AFS 6.1

BRO GMW Ketentest vragen

Gebruikershandleiding Digikoppeling Serviceregister

DigiD SSL. Versie Datum 16 augustus 2010 Status Definitief

Uniforme Pensioen Aangifte (UPA)

BRP-BZM Use Case Realisations Guidelines

Aansluitdocument webservices. VSP-EDP Validatiemodule

Basisregistratie Ondergrond (BRO) Koppelvlakbeschrijving

Oplossing issue 120. Oplossing De Expertgroep Stelselstandaarden 1 adviseert 2 unaniem te besluiten:

Temperatuur logger synchronisatie

Nederlands WMS - SLD Profiel. Versie 1.0

Gebruikershandleiding

Basisregistratie Ondergrond

Handleiding Portaal. Digipoort. Versie Datum 25 januari 2012

BEFDSS. Het Belgische uitwisselingsformaat voor onderzoekgegevens afkomstig van visueel rioolonderzoek. 1/12/ / 6

Generieke interface energielabels

Concept Migratieplan OIN

Voorbeelden generieke inrichting Digikoppeling

Nederlands profiel op ISO Geographic information Web Feature Service

afkijken nadoen EGEMwijs Roadmap StUF SOA Op weg naar een service-georiënteerde architectuur

Ontwerp Versturen Patiëntgegevens

Technische Documentatie TaxatieVoertuig A2SP 2015

Inhoud. Revisiehistorie Inleiding... 4

Informatieobjecten zijn systematisch beschreven

Informatie Model Omgevingswet (IMOW) de keten van plan tot publicatie. Versie beta. gebaseerd op CIMOW beta

Voorwaarden Digilevering

Koppelvlakbeschrijving aanleverservice Bancaire Infrastructurele Voorzieningen. Het aanleveren van kredietrapportages bij de BIV

Forum Standaardisatie. Expertadvies: Opname MIME op lijst met gangbare standaarden. Datum 4 februari 2011

Transcriptie:

Basisregistratie Ondergrond (BRO) Koppelvlakbeschrijving GMW Innamewebservice Datum 19 augustus 2015 Status 0.6

Colofon Bestuurskern Dir. Ruimtelijke Ontwikkeling Plesmanweg 1-6 Den Haag Algemeen contact Programmabureau BRO Directoraat-Generaal Ruimte en Water bro@minienm.nl Versie 0.6 Auteur TNO Geologische Dienst Nederland Pagina 3 van 50

Inhoudsopgave 1 Inleiding... 6 1.1 Doel en doelgroep koppelvlakbeschrijving... 6 1.2 Samenhang met andere documentatie... 6 1.3 Leeswijzer... 7 1.4 Versiehistorie... 8 1.5 Contactinformatie... 8 2 Uitwisselen van gegevens via de webservice... 9 2.1 Het koppelvlak... 9 2.2 De realisatie van het koppelvlak... 10 2.3 Verwerking van een verzoek door de webservice 10 2.4 Gemaakte keuzes voor de webservices van de BRO 11 3 Inname van grondwatermonitoringputten via de webservice... 14 3.1 Opbouw van het koppelvlak van de BRO... 14 3.2 De WSDLs van de BRO... 14 3.3 De verwerking van een registratieverzoek... 16 3.4 De verwerking van een aanvullingsverzoek... 18 3.5 De verwerking van een beëindigingsverzoek... 18 3.6 Controles... 21 4 Specificatie berichten voor innametransacties grondwatermonitoringputten... 24 4.1 Inleiding... 24 4.2 De berichten die bij registratie worden uitgewisseld... 25 Pagina 4 van 50

4.3 De berichten die bij aanvulling worden uitgewisseld... 27 4.4 De berichten die bij beëindiging worden uitgewisseld... 28 5 Specificatie van de gegevens van grondwatermonitoringputten die kunnen worden aangeboden... 31 5.1 RegistrationObject GroundwaterMonitoringWell Error! Bookmark not defined. 5.2 Registratiedocument... 32 5.3 Aanvullingsdocument... 32 5.4 Beëindigingsdocument... 39 6 Uitwerking specifieke elementen... 40 Bijlages... 44 Bijlage A: Vertaalslag Engels Nederlands... 44 Bijlage B: Achtergrond bij de techniek rondom het koppelvlak... 47 Pagina 5 van 50

1 Inleiding 1.1 Doel en doelgroep koppelvlakbeschrijving Deze koppelvlakbeschrijving geeft een beschrijving van het technische koppelvlak voor het aanbieden van grondwatermonitoringputten aan de Basisregistratie ondergrond. Het document richt zich voornamelijk op de technisch specialisten die de aansluiting gaan realiseren tussen de systemen van dataleveranciers en het systeem van de BRO. Kennis van XML en webservices is benodigd om deze aansluiting daadwerkelijk te bouwen op basis van dit document. Het is echter zo geschreven dat overige belangstellenden met beperkte kennis op dit vlak de strekking van de aansluiting kunnen volgen. 1.2 Samenhang met andere documentatie Voor ieder registratieobject in de BRO worden de volgende beschrijvende documenten opgesteld: een catalogus, de handboeken voor inname en uitgifte; de koppelvlakbeschrijvingen voor inname en uitgifte. In de catalogus staan de definities van alle entiteiten en attributen van het registratieobject beschreven. Ook staan in de catalogus de kardinaliteit (het aantal keer dat de entiteit of het attribuut voorkomt), regels voor het gebruik en de toegestane waardes voor de attributen. Ook de samenhang tussen de entiteiten wordt beschreven. De catalogus beschrijft dus de inhoud van de BRO en vormt de basis voor de andere documenten. Een handboek voor inname of uitgifte beschrijft het proces dat bij inname of uitgifte van gegevens wordt doorlopen. Alle registratieobjecten kunnen aangeboden worden via webservices, bepaalde registratieobjecten kunnen ook aangeboden worden via het innameloket. Bij uitgifte is het anders en kan de afnemer voor alle objecten kiezen tussen webservices of DINOloket. In een handboek worden ook de gegevens gedefinieerd die betrekking hebben op het proces van innemen of uitgeven. Om te zien wat er aangeleverd moet worden of wat er uitgeleverd kan worden, heeft men de catalogus nodig. De koppelvlakbeschrijvingen zijn geschreven voor softwareontwikkelaars en zijn bedoeld voor de partijen die de Pagina 6 van 50

webservices gaan gebruiken. Op basis van de twee vorige typen documenten staat hierin beschreven hoe het registratieobject en de processen van inname of uitgifte worden vertaald naar het technische koppelvlak dat is gerealiseerd door middel van webservices. De koppelvlakbeschrijving gaat dus in op de technische kant van de overdracht van gegevens. Deze documenten hangen samen zoals hieronder afgebeeld. Figuur 1: Samenhang tussen documentatie 1.3 Leeswijzer Hoofdstuk 1 geeft het doel en de doelgroep, de samenhang met andere documenten en de versiehistorie van deze koppelvlakbeschrijving. Hoofdstuk 2 geeft een inleiding op de uitwisseling van gegevens via de webservices van de BRO. Dit hoofdstuk is bedoeld voor de lezer die een globaal idee wil krijgen van de technische werking van de BRO. Hoofdstuk 3 geeft de technische specificaties voor de inname van grondwatermonitoringputten. Dit hoofdstuk is bedoeld voor de lezer die de specifieke technische werking van de BRO voor inname van grondwatermonitoringputten wil begrijpen en de keuzes die daarbij zijn gemaakt. Dit hoofdstuk gaat echter nog niet in op alle details. Hoofdstuk 4 en hoofdstuk 5 geven de specificaties van respectievelijk het XML Schema voor de innametransacties voor grondwatermonitoringputten en het XML Schema voor grondwatermonitoringput. Deze hoofdstukken maken het samen Pagina 7 van 50

met de kennis uit hoofdstuk 3 mogelijk voor de lezer om aan te sluiten op de BRO en geeft daarvoor alle benodigde details. In hoofdstuk 6 staat een uitwerking van specifieke elementen uit de twee XML Schema s. 1.4 Versiehistorie Versie Datum Omschrijving 0.6 Augustus 2015 Versie ten behoeven van pilot GMW Fase 1 1.5 Contactinformatie Voor vragen, suggesties of opmerkingen kunt u via info@dinoloket.nl contact opnemen met de servicedesk van de Basisregistratie Ondergrond (BRO). Pagina 8 van 50

2 Uitwisselen van gegevens via de webservice 2.1 Het koppelvlak Dit hoofdstuk geeft een inleiding op berichtuitwisseling. De Basisregistratie Ondergrond voorziet in een koppelvlak waarmee dataleveranciers op een geautomatiseerde manier gegevens aan de BRO kunnen overdragen. Systemen van data-leveranciers sluiten via het koppelvlak aan op de systemen van de BRO. Figuur 2: Aansluiting op het BRO systeem via een koppelvlak Zoals hierboven al beschreven, kan via een koppelvlak overdracht van gegevens plaatsvinden. Deze overdracht van gegevens wordt een transactie genoemd. Wanneer het gaat om overdracht van gegevens door een dataleverancier aan de BRO wordt gesproken over een innametransactie, als het een overdracht van gegevens door de BRO aan data-afnemers betreft wordt dit een uitgiftetransactie genoemd. Figuur 3: Een transactie tussen data leverancier/afnemer en de BRO Pagina 9 van 50

2.2 De realisatie van het koppelvlak Het koppelvlak zoals hierboven beschreven kan op verschillende manieren worden gerealiseerd. De BRO kent voor het aanbieden van registratieobjecten twee manieren, namelijk via het loket of via de webservice. Dit document richt zich enkel op het in technische termen beschrijven van het koppelvlak dat is gerealiseerd door middel van webservices. De keuzes voor de inrichting van de BRO zijn gebaseerd op de NORA (Nederlandse Overheid Referentie Architectuur) en de Digikoppeling specificaties. Het koppelvlak is gerealiseerd met W3C webservices. Hiermee kan een extern systeem, een cliëntsysteem genoemd, via een request-response mechanisme communiceren met het systeem van de BRO. Deze communicatie vindt plaats over het internet. De belangrijkste concepten die een rol spelen bij de webservices van de BRO zijn WSDL en SOAP. Figuur 4: De positie van WSDL en SOAP bij een transactie 2.3 Verwerking van een verzoek door de webservice Als een dataleverancier of data-afnemer gegevens wil uitwisselen met de BRO moet hij hiervoor altijd zelf het initiatief nemen. Om een transactie te starten moet vanuit het systeem van de dataleverancier of data-afnemer ten eerste een verzoek (request genoemd) worden verstuurd aan de webservice van het BROsysteem. Dit verzoek bestaat uit een SOAP-bericht waarin is aangegeven welke transactie uitgevoerd moet worden. De invoergegevens die voor deze transactie moeten worden gebruikt worden ook gelijk meegegeven. Het systeem van de BRO reageert op dit verzoek door middel van een antwoord, (response genoemd). Aangezien het bij de BRO om synchrone webservice gaat, bevat de response direct het resultaat van de transactie, opnieuw in de vorm van een SOAP bericht. Pagina 10 van 50

Afhankelijk van de verwerking door de BRO verschilt de inhoud van deze response. Figuur 5: Request-response mechanisme 2.4 Gemaakte keuzes voor de webservices van de BRO 2.4.1 Communicatiestandaarden Voordat deze standaarden verder worden toegelicht, wordt hieronder het complete plaatje voor uitwisseling geschetst. De communicatie tussen het systeem van de dataleverancier en het systeem van de BRO verloopt namelijk over een aantal lagen. Voor elk van de lagen staat hieronder weergegeven welke standaarden gebruikt zijn. Dit geeft een beeld waar het hierboven beschreven mechanisme en bijbehorende standaarden op het niveau van de uitwisseling van berichten zich bevinden in het grotere geheel. Ook is de positie van de BRO weergegeven. In bijlage B staat meer achtergrondinformatie over de techniek rondom het koppelvlak. Digikoppeling } Inhoud Logistiek Semantiek Structuur Service beschrijving Berichtuitwisseling Transportprotocol XML Schema XML WSDL SOAP HTTP } BRO Transport Netwerk TCP/IP Pagina 11 van 50

Figuur 6: Raamwerk voor uitwisselbaarheid 2.4.1.1 SOAP Het Simple Object Access Protocol (SOAP) is een protocol voor het versturen van XML berichten. Het doel van SOAP is het uitwisselen van data over netwerken en daarom houdt het zich bezig met het inkapselen en coderen van XML data en het definiëren van regels voor het versturen en ontvangen van die data. Een SOAP bericht is niet bedoeld voor menselijke interpretatie, maar worden door het ontvangende systeem verwerkt. Het systeem van de BRO maakt gebruik van SOAP 1.1. 2.4.1.2 WSDL Bij elk koppelvlak dat is gerealiseerd door middel van een W3C webservice hoort een WSDL (Web Service Definition Language) document. Dit document, beschreven in XML, beschrijft in technische termen welke transacties er mogelijk zijn via de webservice. Onder andere staat gedefinieerd hoe men toegang kan krijgen tot de service en welke gegevens moeten worden ingevoerd en welke kunnen worden terugverwacht van het systeem. Het systeem van de BRO maakt gebruik van WSDL 1.0. 2.4.2 Synchrone webservices Er bestaan synchrone en asynchrone webservices. Bij een synchrone webservice wacht het systeem dat het verzoek heeft verstuurd tot er een antwoord ontvangen is. Wanneer een verzoek enige verwerkingstijd vergt bij het ontvangende systeem (in dit geval het systeem van de BRO), blijven de resources bij de aanvrager voor dit verzoek in gebruik en kan er dus maar een beperkt aantal transacties tegelijk worden verwerkt. Het gevolg kan zijn dat een gebruiker geen transacties kan starten en moet wachten tot er resources zijn vrijgekomen. De BRO volgt hierin de Best Effort variant van Digikoppeling. Deze variant schrijft voor dat de uitwisseling synchroon plaatsvindt, maar vereist geen faciliteiten voor betrouwbaarheid, zoals ontvangstbevestigingen en het elimineren van duplicaten. Pagina 12 van 50

Op dit moment is er binnen de BRO voor gekozen enkel synchrone webservices te implementeren. Waar niet direct een antwoord kan worden gegeven, wordt via de mail een reactie gestuurd. 2.4.3 Gebruikte standaarden en hun namespaces De XML Schema s van de BRO zijn gebaseerd op domeinmodellen voor de verschillende registratieobjecten. Deze domeinmodellen staan conceptueel en inhoudelijk volledig beschreven is in de catalogus van het registratieobject. Waar het domeinmodel onafhankelijk van implementatiekeuzes is beschreven, is bij de uitwerking naar het XML Schema juist wel rekening gehouden met nationale en internationale technische standaarden. XML Schema s van de BRO maken doorgaans dan ook gebruik van de volgende standaarden: NEN 3610:2010, Basismodel Geoinformatie OpenGIS Geography Markup Language (GML) Encoding Standard, OGC 07-036 De relatie tussen het domeinmodel en het XML Schema is zo veel mogelijk 1-op-1 gehouden. Door de toepassing van internationale standaarden wordt echter een aantal elementen, types en attributen in het XML Schema geïntroduceerd die niet zijn opgenomen in het domeinmodel. De consequenties die dit heeft staan expliciet benoemd bij de elementen die als gevolg van het toepassen van standaarden een andere invulling hebben dan verwacht. Daarnaast is het XML Schema conform de internationale standaarden uitgewerkt in het Engels, waar het domeinmodel in het Nederlands beschreven is. De toepassing van internationale standaarden betekent dat in de XSD wordt gerefereerd aan de XML Schema s, die bij die standaarden horen. In de WSDL en de SOAP berichten van de webservices van de BRO worden de volgende standaarden gebruikt met bijbehorende namespaces. In de laatste kolom staat een prefix voor elke namespace. Deze prefixen mogen echter zelf worden gekozen, dit is enkel het prefix dat in de voorbeelden wordt gebruikt. Pagina 13 van 50

3 Inname van grondwatermonitoringputten via de webservice 3.1 Opbouw van het koppelvlak van de BRO Voor elk registratieobject ontwikkelt de BRO voor zowel inname als uitgifte een WSDL. De invoer- en uitvoergegevens voor elke operation in de WSDL worden beschreven in een berichten -XSD. Deze berichten -XSD wordt geïmporteerd in de WSDL en maakt weer gebruik van een XSD die het registratieobject zelf beschrijft. Daarnaast gebruikt de berichten -XSD de gemeenschappelijke standaarden, welke in hoofdstuk 2.4.3 genoemd staan. De WSDL voor de inname van grondwatermonitoringputten is isgmw.wsdl. De bijbehorende berichten -XSD is isgwmmessages.xsd. De XSD die de grondwatermonitoringput zelf beschrijft is gmwcommon.xsd. In onderstaande figuur is de relatie tussen de WSDL en deze XML Schemas weergegeven. Figuur 7: De relatie tussen de WSDL's en XML Schema's De specifieke namespaces voor de genoemde XML Schema s voor grondwatermonitoringputten staan hieronder benoemd. Specificatie Namespace URI Prefix Gemeenschappelijke http://www.broservices.nl/xsd/ brocom BRO types brocommon/2.3 GroundwaterMonitoring http://www.broservices.nl/xsd/ gmwcommon Well gmwcommon/0.6 Innametransacties http://www.broservices.nl/xsd/isgmw/ isgmw GroundwaterMonitoring 0.6 Well Geography Markup http://www.opengis.net/gml/3.2 gml Pagina 14 van 50

Language 3.2 XML Schema instance http://www.w3.org/2001/ xsi XMLSchema-instance XML Linking Language http://www.w3.org/1999/xlink xlink 3.2 De WSDLs van de BRO De service met daarbij de port beschrijft hoe men toegang krijgt tot de service De service voor inname van grondwatermonitoringputten: - Service name: isgmw - Port name: isgmw_soap - SOAP address location: https://www.broservices.nl/wsdl/isgmw//isgmw/v<<x.y >> Een binding geeft details over het transport behorende bij een port, onder andere het communicatieprotocol en het formaat van de input en de output. De BRO geeft alleen binding voor SOAP 1.1, document-literal wrapped en als transport binding http. Voor elke operation is de style document en de input en output use literal. De binding voor inname van grondwatermonitoringputten: - Binding name: isgmw_soap - SOAP operation SOAP action: (lege string) Port type specificeert de interface en legt in operations de structuur van de input en output berichten vast. Elk van de transacties die in het innamehandboek gedefinieerd staat wordt gerealiseerd door één van deze operations. isgmw.wsdl kent de volgende operations in port type: - registergmw - additiongmwowner - additiongmwtubelength - additiongmwtubestatus - additiongmwmaintainanceresponsibleparty - additiongmwwellheadprotectiontubelength - additiongmwwellheadprotection - additiongwmrepairtube - additiongmwgroundlevel - additiongmwwellposition - additiongmwtubeposition - completeregistrationgmw Pagina 15 van 50

Messages beschrijven de berichten die per transactie worden uitgewisseld, uitgedrukt in parts (XML elementen). Er is steeds sprake van een request en een reponse. De naam van de bijbehorende operation is onderdeel van naam van het request en de response. De inhoud van de response is afhankelijk van de verwerking van het verzoek tot levering, zie verder paragraaf 3.3. isgmw.wsdl kent de volgende messages: - registergmwrequest - registergmwresponse - additiongmwownerrequest - additiongmwownerresponse - additiongmwtubelengthrequest - additiongmwtubelengthresponse - additiongmwtubestatusrequest - additiongmwtubestatusresponse - additiongmwmaintainanceresponsiblepartyrequest - additiongmwmaintainanceresponsiblepartyresponse - additiongmwwellheadprotectiontubelengthrequest - additiongmwwellheadprotectiontubelengthresponse - additiongmwwellheadprotectionrequest - additiongmwwellheadprotectionresponse - additiongwmrepairtuberequest - additiongwmrepairtuberesponse - additiongmwgroundlevelrequest - additiongmwgroundlevelresponse - additiongmwwellpositionrequest - additiongmwwellpositionresponse - additiongmwtubepositionrequest - additiongmwtubepositionresponse - completeregistrationgmwrequest - completeregistrationgmwresponse Een type bevat XML Schemas met daarbinnen XML types en elementen. Deze XML Schemas kunnen extern worden gedefinieerd en worden geïmporteerd. isgmw.wsdl kent het volgende type: - http://www.broservices.nl/xsd/imbroisgmw/1.1.0/isgmw-messages 3.3 De verwerking van een registratieverzoek Hieronder staat uitgewerkt hoe de webservice een registratieverzoek verwerkt. Elk van de genoemde messages in paragraaf 3.2 die van toepassing is op registratie is terug te vinden in onderstaande afbeelding. Pagina 16 van 50

Figuur 8: De verwerking van een registratieverzoek Pagina 17 van 50

3.4 De verwerking van een aanvullingsverzoek Een aanvullingsverzoek wordt door de webservice op gelijke manier verwerkt als een registratieverzoek. Elk van de genoemde messages in paragraaf 3.2 die van toepassing is op aanvulling is terug te vinden in onderstaande afbeelding. Figuur 9: De verwerking van een aanvullingsverzoek 3.5 De verwerking van een beëindigingsverzoek Een beëindigingsverzoek wordt door de webservice op gelijke manier verwerkt als een registratieverzoek. Elk van de genoemde messages in paragraaf 3.2 die van toepassing is op beëindiging is terug te vinden in onderstaande afbeelding. Pagina 18 van 50

Figuur 10: De verwerking van een beëindigingsverzoek Pagina 19 van 50

3.6 Controles 3.6.1 Toegangscontrole Voor de beveiliging van de transacties die plaatsvinden tussen een dataleverancier en de BRO worden PKIoverheid certificaten gebruikt. Zowel de dataleverancier als de BRO beschikt over een dergelijk certificaat. In het certificaat is een identificatie opgenomen die uniek is voor de houder van het certificaat. Omdat deze identificatie cruciaal is voor de beveiliging, wordt de identiteit van de aanvrager van een PKIoverheid certificaat streng gecontroleerd. Op het moment dat een systeem van een dataleverancier of - afnemer een transactie initieert, wisselen dit systeem en het BRO systeem eerst hun PKIoverheid certificaten uit. Aan de hand van de identificatie in de certificaten weten beide partijen met wie de transactie wordt opgezet (authenticatie). Als de authenticatie succesvol is verlopen dan worden beide certificaten vervolgens gebruikt om al het dataverkeer tussen de systemen te versleutelen (via TLS of SSL). Deze versleuteling maakt het voor derden onmogelijk om de data te lezen of te wijzigen. Elke transactie met de BRO mag alleen worden uitgevoerd door een systeem van een dataleverancier of data-afnemer dat daarvoor het recht heeft gekregen van de BRO. Aan de hand van de identificatie in het certificaat wordt door de BRO bepaald of dit systeem het recht heeft om de transactie uit te voeren (autorisatie). De rechten van de gebruiker worden beheerd door de BRO. Als de toegangscontrole tot een fout leidt, ontvangt de dataleverancier de melding met een HTTP statuscode. 3.6.2 Gegevenscontrole Het XML document dat in de body van het SOAP bericht wordt meegegeven wordt gecontroleerd op basis van het XML Schema waar het naar verwijst. Het XML Schema legt regels vast over de structuur van het XML document en gegevens zelf, dus de ingevulde waardes in het XML document, controleren. Het XML Schema legt namelijk vast: Welke gegevens verplicht zijn Welk type een ingevulde waarde moet hebben Een XML Schema kan echter geen regels vastleggen die gelden tussen verschillende gegevens. Het vastleggen en controleren van dit soort regels, business rules genoemd, gebeurt door Pagina 21 van 50

middel van de programmatuur aan de kant van de BRO. Voorbeelden van dit soort controles zijn: Welke lengte een ingevulde waarde moet hebben Wat de toegestane waardes zijn voor een gegeven Voor innametransacties geldt dat dit soort gegevenscontroles worden uitgevoerd op de transactiegegevens die zijn meegegeven en daarnaast wordt het brondocument dat wordt aangeboden ook op een dergelijke manier inhoudelijk gecontroleerd. Naast de inhoudelijke controle van de transactiegegevens vindt er ook een technische controle van het verzoek plaats. Dit betekent onder andere dat wordt nagegaan of het protocol dat gebruikt is in het verzoek juist is. Nadat de technische controle heeft plaatsgevonden wordt het verzoek in het systeem van de BRO getransformeerd van XML naar Java. 3.6.3 Controle op rechten Het systeem controleert of de dataleverancier die het innameverzoek doet bij de BRO geregistreerd is als bronhouder van grondwatermonitoringputten, of dat bij de BRO bekend is dat de dataleverancier grondwatermonitoringputten mag aanleveren voor deze bronhouder. Pas daarna wordt het brondocument inhoudelijk gecontroleerd. Als de inhoudelijke controle van het brondocument slaagt, bekijkt het systeem daarna de organisaties en hun rollen die genoemd worden in het brondocument. Hierbij wordt gecontroleerd of de genoemde bronhouder en uitvoerder reeds bekend zijn in de BRO. Tot slot wordt gecontroleerd of de inhoud van het brondocument overeenkomt met het kwaliteitsregime dat als transactiegegeven is meegegeven in het innameverzoek. 3.6.4 Aanvullende controles op aanvullings- en beëindigingsdocumenten Aanvullingsdocument: Naast de eerder beschreven controles kunnen aanvullende controles worden uitgevoerd op basis van validatieregels die gelden voor een specifiek aanvullingsbrondocument. Deze controles vallen uiteen in twee typen: Aanvullende controles op gegevens binnen het aanvullingsbrondocument Pagina 22 van 50

Aanvullende controles op een bepaald gegeven uit het aanvullingsbrondocument aan de hand van actuele waarde van dat gegeven in de registratie ondergrond. Pagina 23 van 50

4 Specificatie berichten voor innametransacties grondwatermonitoringputten 4.1 Inleiding Voor de inname van grondwatermonitoringputten is één XMLschema (XSD) gemaakt op basis van de specificaties uit het Innamehandboek voor BRO Grondwatermonitoringput. Hieronder staan alle berichten die worden uitgewisseld bij specifieke transacties. Ten eerste is voor elk bericht de specificatie uit het innamehandboek naast de structuur uit het XML bericht weergegeven. Daarna volgt voor elk bericht een voorbeeld. Zoals te zien is in de voorbeelden is in het XML Schema gebruik gemaakt van Engelse termen. De vertaalslag van de Engelse termen zoals gebruikt in het XML Schema naar de Nederlandse termen zoals gebruikt in het innamehandboek is in bijlage A te vinden. In de eerste kolom van dit voorbeeld staat voor een aantal elementen een referentie. Als er geen referentie in de eerste kolom staat, betekent het dat het element exact uitgewerkt is zoals in het innamehandboek gespecificeerd staat. Staat er wel een referentie? Een numerieke referentie verwijst dan naar een verdere uitwerking van het element in een hoofdstuk verderop. Een tekstuele referentie verwijst dan naar een verdere toelichting op het element, aangezien deze afwijkt of uitgebreider is dan gespecificeerd in het innamehandboek. Pagina 24 van 50

4.2 De berichten die bij registratie worden uitgewisseld 4.2.1 Het registratieverzoek 5.1 <isgmw:registergmwrequest> <isgmw:yourtransactionreference>levering1-20150728</ isgmw:yourtransactionreference> <isgmw:qualityregimecodespace="urn:bro:quali tyregime">imbro/a</isgmw:qualityregime> <isgmw:sourcedocument (GroundwaterMonitoringWell) </isgmw:sourcedocument> </isgmw:registergmwrequest> 4.2.2 Bericht van afwijzing TIME <isgmw:registergmwresponse> <brocom:yourtransactionreference>eigenaar1-20150729</brocom:yourtransactionreference> <brocom:brotransactionreference>a-gmw-20150729-0000-000003 </brocom:brotransactionreference> <brocom:rejectiontime>2015-07- 29T11:33:24+02:00</brocom:rejectionTime> <isgmw:objectidaccountableparty>30277172 </isgmw:objectidaccountableparty> <isgmw:deliveryaccountableparty>30277172 </isgmw:deliveryaccountableparty> <brocom:qualityregime codespace="urn:bro:qualityregime">imbro/a </brocom:qualityregime> Pagina 25 van 50

<isgmw:errormessage> (Foutmelding) </isgmw: errormessage > </isgmw:registergmwresponse> 4.2.3 Bericht van verwerking TIME TIME <isgmw:registergmwresponse> <brocom:yourtransactionreference>levering1-20150728</brocom:yourtransactionreference> <brocom:brotransactionreference> R-GMW-20150728-0000-000021 </brcom:brotransactionreference> < brocom:broid>gmw000000133602</brocom:broid> <brocom:acceptancetime>2015-07- 28T11:31:24+02:00</brocom:acceptanceTime> <brocom:objectregistrationtime>2005-07- 28T11:31:24+02:00 </brocom:objectregistrationtime> <isgmw:objectidaccountableparty>25h010001 </isgmw:objectidaccountableparty> <isgmw:deliveryaccountableparty>30277172 </isgmw:deliveryaccountableparty> <isg:qualityregime codespace= "urn:bro:kwaliteitsregime">imbro/a </isgmw:qualityregime> </isgmw:registergmwresponse> Pagina 26 van 50

4.3 De berichten die bij aanvulling worden uitgewisseld 4.3.1 Het aanvullingsverzoek 5.2 <isgmw:additiongmwownerrequest> <isgmw:yourtransactionreference>eigenaar1-20150729</isgmw:yourtransactionreference> <isgmw:qualityregimecodespace="urn:bro: QualityRegime">IMBRO/A</isgmw:qualityRegime> <isgmw:sourcedocument> (specifiek aanvuldocument) </isgmw:sourcedocument> </isgmw:additiongmwownerrequest> 4.3.2 Bericht van afwijzing TIME <isgmw:additiongmwownerresponse> <brocom:yourtransactionreference>eigenaar1-20150729</brocom:yourtransactionreference> <brocom:brotransactionreference>a-gmw-20150729-0000-000003 </brocom:brotransactionreference> <brocom:broid>gmw000000013561</brocom:broid> <brocom:rejectiontime>2015-07- 29T11:33:24+02:00</brocom:rejectionTime> <brocom:deliveryaccountableparty>30277172 </brocom:deliveryaccountableparty> <brocom:qualityregime codespace="urn:bro:qualityregime">imbro/a </brocom:qualityregime> <isgmw:errormessage> (Foutmelding) Pagina 27 van 50

</isgmw: errormessage > </isgmw:additiongmwownerresponse> 4.3.3 Bericht van verwerking Bericht van verwerking uw transactiekenmerk Verwijzing BRO transactiekenmerk naar het registratieverzoek kwaliteitsregime BRO-ID bronhouder tijdstip laatste aanvulling AdditionGMWResponse yourtransactionreference Verwijzing naar het brotransactionreference registratieverzoek broid latestadditiontime deliveryaccountableparty qualityregime TIME <isgmw:additiongmwownerresponse> <brocom:yourtransactionreference>eigenaar1-20150729</brocom:yourtransactionreference> <brocom:brotransactionreference>a-gmw-20150729-0000-000003 </brocom:brotransactionreference> <brocom:broid>gmw000000013561</brocom:broid> <brocom:objectregistrationtime>2005-07- 29T11:33:24+02:00 </brocom:objectregistrationtime> <brocom:deliveryaccountableparty>30277172 </brocom:deliveryaccountableparty> <brocom:qualityregime codespace="urn:bro:qualityregime">imbro/a </brocom:qualityregime> </isgmw:additiongmwownerresponse> 4.4 De berichten die bij beëindiging worden uitgewisseld 4.4.1 Het beëindigingsverzoek 5.3 <isgmw:completeregistrationwellrequest> <brocom:yourtransactionreference>opgeruimd juni 2015 p12</brocom:yourtransactionreference> <isgmw:sourcedocument> (beëindigingsdocument) </isgmw:sourcedocument> Pagina 28 van 50

</isgmw:completeregistrationwellrequest> 4.4.2 Bericht van afwijzing TIME <isgmw:completeregistrationgmwresponse> <brocom:yourtransactionreference>opgeruimd juni 2015 p12</brocom:yourtransactionreference> <brocom:brotransactionreference>a-gmw-20150729-0000-000003 </brocom:brotransactionreference> <brocom:broid>gmw000000013561</brocom:broid> <brocom:rejectiontime>2015-07- 29T11:33:24+02:00</brocom:rejectionTime> <brocom:deliveryaccountableparty>30277172 </brocom:deliveryaccountableparty> <brocom:qualityregime codespace="urn:bro:qualityregime">imbro/a </brocom:qualityregime> <isgmw:errormessage> (Foutmelding) </isgmw: errormessage > </isgmw:completeregistrationgmwownerresponse> 4.4.3 Bericht van verwerking Pagina 29 van 50

TIME <isgmw:completeregistrationgmwresponse> <brocom:yourtransactionreference>opgeruimd juni 2015 p12</brocom:yourtransactionreference> <brocom:brotransactionreference>a-gmw-20150729-0000-000003 </brocom:brotransactionreference> <brocom:broid>gmw000000013561</brocom:broid> <brocom:registrationcompletiontime>2015-07- 29T11:33:24+02:00</brocom:registrationCompletionTime> <brocom:deliveryaccountableparty>30277172 </brocom:deliveryaccountableparty> <brocom:qualityregime codespace="urn:bro:qualityregime">imbro/a </brocom:qualityregime> </isgmw:completeregistrationgmwownerresponse> Pagina 30 van 50

5 Specificatie van de gegevens van grondwatermonitoringputten die kunnen worden aangeboden De brondocumenten van grondwatermonitoringputten die kunnen worden aangeboden staan hieronder verder uitgewerkt aan de hand van voorbeelden. Er is een drietal varianten van brondocumenten die kunnen worden aangeboden te vinden: - Het registratiedocument - Het aanvullingsdocument - Het beëindigingsdocument Deze brondocumenten zijn gebaseerd op het registratieobject grondwatermonitoringput dat wordt vastgelegd in de Basisregistratie ondergrond. Het registratieobject staat daarom eerst uitgewerkt en daaronder volgen de brondocumenten die hiervan zijn afgeleid. In de eerste kolom van de voorbeelden staat voor een aantal elementen een referentie. Als er geen referentie in de eerste kolom staat, betekent het dat het element exact uitgewerkt is zoals in de catalogus gespecificeerd staat. Staat er wel een referentie? Een numerieke referentie verwijst dan naar een verdere uitwerking van het element in een paragraaf verderop. Een tekstuele referentie verwijst dan naar een verdere toelichting op het element, aangezien deze afwijkt of uitgebreider is dan gespecificeerd in de catalogus. In de XML Schema s en dus ook in de XML voorbeelden wordt gebruik gemaakt van Engelse termen. De vertaalslag van de Engelse termen zoals gebruikt in het XML Schema naar de Nederlandse termen zoals gebruikt in de catalogus is in Bijlage A. Pagina 31 van 50

5.1 Registratiedocument De dataleveranciers bieden bij een registratie in principe alle gegevens van het registratieobject grondwatermonitoringput aan, op de volgende gegevens na: Entiteit GroundwaterMonitoringWell (5.1) Zoutwachter MonitoringTube RegistrationHistory StandardizedLocation Attribuut broid qualityregime deliveryresponsibleparty inuse inuse Geheel Geheel 5.1.1 Brondocument registergmw ID - <isgmw:sourcedocument gml:id="gmwell-id-88a342d1-970a-45d3-8a89-c0846d50af13"> - <gmw:deliveryaccountableparty>30277172</gmw:deliveryaccountablepart y> - <gmw:deliverycontext codespace="urn:bro:deliverycontext">rechtsgrondwaterwet </gmw:deliverycontext> <gmw:historicalid>vdweeteringsput1</gmw:historicalid> - <gmw:constructionstandard codespace="urn:bro:gmw:constructionstandard"> STOWA Handboek</gmw:constructionStandard> - <gmw:owner>05069581</gmw:owner> <gmw:wellheadprotector codespace="urn:bro:gmw:wellheadprotector">beschermkokerstaal </gmw:wellheadprotector> <gmw:geoohmtester codespace="urn:bro:indicationyesnounknown">ja</gmw:geoohmtester> <gmw:initialfunction codespace="urn:bro:gmw:initialfunction"> monitoringgrondwaterstand</gmw:initialfunction> DATE <gmw:constructiondate>2014-11-04+01:00</gmw:constructiondate> DATE <gmw:abandonmentdate>2014-11-04+01:00</gmw:abandonmentdate> 5.1.2 <gmw:monitoringtube>...</gmw:monitoringtube> 5.1.5 <gmw:deliveredlocation>...</gmw:deliveredlocation> 5.1.6 <gmw:deliveredverticalposition>...</gmw:deliveredverticalposition> 5.1.7 <gmw:ohmtester>...</gmw:ohmtester> <isgmw:objectidaccountableparty>25h01000</isgmw:objectidaccountable Party> <isgmw:deliveryresponsibleparty>09122561</isgmw:deliveryresponsible Party> <isgmw:maintenanceresponsibleparty>09122561</isgmw:maintenancerespo nsibleparty> </isgmw:sourcedocument> Pagina 32 van 50

5.1.2 MonitoringTube ID - <gmw:monitoringtube gml:id="gmwell-id-b6c41d66-0be5-4736- 9f18-29e8ff2a784c"> - <gmw:tubenumber>1</gmw:tubenumber> - <gmw:type codespace="urn:bro:gmw:monitoringtubetype">buis</gmw:type> - <gmw:artesianwellcap codespace="urn:bro:indicationyesnounknown">ja </gmw:artesianwellcap> - <gmw:fullydescribed codespace="urn:bro:indicationyesno">ja</gmw:fullydescribed> <gmw:status codespace="urn:bro:gmw:tubestatus">klaarvoorgebruik</gmw:status> MEA <gmw:length uom="m">10</gmw:length> NIL MEA <gmw:topverticalposition uom="m">-0.98</gmw:topverticalposition> <gmw:verticalpositioningmethod codespace="urn:bro:gmw:verticalpositioningmethod"> DGPS01_025m</gmw:verticalPositioningMethod> <gmw:verticalpositioningoperator>09122561</gmw:verticalpositioningop erator> 5.1.3 <gmw:screen>...</<gmw:screen>> 5.1.4 <gmw:othertubepart>...</gmw:othertubepart> </gmw:monitoringtube> 5.1.3 Screen - <gmw:screen> - <gmw:material codespace="urn:bro:gmw:materialtype">pvc</gmw:material> MEA - <gmw:internaldiameter NIL uom="mm">36</gmw:internaldiameter> MEA - <gmw:topverticalposition uom="m">- 10.48</gmw:topVerticalPosition> MEA - <gmw:bottomverticalposition uom="m">- 10.98</gmw:bottomVerticalPosition> </gmw:screen> 5.1.4 OtherTubePart - <gmw:othertubepart> ÇWA - <gmw:material codespace="urn:bro:gmw:materialtype">pvc</gmw:material> MEA - <gmw:internaldiameter uom="mm">36</gmw:internaldiameter> NIL MEA - <gmw:topverticalposition uom="m">- 0.98</gmw:topVerticalPosition> MEA - <gmw:bottomverticalposition uom="m">- 9.48</gmw:bottomVerticalPosition> </gmw:othertubepart> 5.1.5 DeliveredLocation ID <gmw:deliveredlocation> <gmw:location gml:id="location5056b033-4774-420e-8c39- Pagina 33 van 50

PT DIS 5c6adb463adf"> <gml:pos srsname="urn:ogc:def:crs:epsg::28992">134750 477800</gml:pos> </gmw:location> <gmw:horizontalpositioningmethod codespace="urn:bro:gmw:horizontalpositioningmethod"> landmetinggr01m</gmw:horizontalpositioningmethod> <gmw:horizontalpositioningoperator>09122561 </gmw:horizontalpositioningoperator> </gmw:deliveredlocation> 5.1.6 DeliveredVerticalPosition MEA MEA NIL DIS <gmw:deliveredverticalposition> <gmw:localverticalreferencepoint codespace="urn:bro:gmw:localverticalreferencepoint"> maaiveld</gmw:localverticalreferencepoint> <gmw:offset uom="m">0.000</gmw:offset> <gmw:verticalpositiongroundlevel uom="m">- 1.2</gmw:verticalPositionGroundlevel> <gmw:verticalpositioningmethod codespace="urn:bro:gmw:verticalpositioningmethod"> DGPS01_025m</gmw:verticalPositioningMethod> <gmw:verticalpositioningoperator> 09122561</gmw:verticalPositioningOperator> <gmw:verticaldatum codespace="urn:bro:verticaldatum">nap</gmw:verticaldatum> </gmw:deliveredverticalposition> 5.1.7 OhmTester <gmw:ohmtester> <gmw:serialnumber>1</gmw:serialnumber> 5.1.8 <gmw:electrodepair>...</gmw:electrodepair> </gmw:ohmtester> 5.1.8 ElectrodePair MEA MEA <gmw:electrodepair> <gmw:serialnumber>1</gmw:serialnumber> <gmw:measurementverticalposition uom="m">- 9.15</gmw:measurementVerticalPosition> <gmw:electrodedistance>20</gmw:electrodedistance> <gmw:annularinfillmaterial codespace="urn:bro:gmw:annularinfillmaterial">zand </gmw:annularinfillmaterial> </gmw:electrodepair> 5.2 Aanvullingsdocument 5.2.1 Brondocument additiongmwowner <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> <isgmw:deliveryaccountableparty>30277172 </isgmw:deliveryaccountableparty> Pagina 34 van 50

DATE <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:owner>05069582</isgmw:owner> </isgmw:sourcedocument> 5.2.2 Brondocument additiongmwtubelength <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> DATE <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:tubenumber>1</isgmw:tubenumber> <isgmw:fullydescribed codespace="urn:bro:indicationyesno">ja</isgmw:fullydescribed> <isgmw:localverticalreferencepoint codespace="urn:bro:gmw:localverticalreferencepoint">nap </isgmw:localverticalreferencepoint> <isgmw:length uom="m">1</isgmw:length> <isgmw:topverticalpositiontube uom="m">1.000</isgmw:topverticalpositiontube> <isgmw:topverticalpositionriser uom="m">1.000</isgmw:topverticalpositionriser> <isgmw:verticalpositioningmethod codespace="urn:bro:gmw:verticalpositioningmethod"> DGPS01_025m </isgmw:verticalpositioningmethod> <isgmw:positioningresponsiblepartyverticalpositiontube>09122561 </isgmw:positioningresponsiblepartyverticalpositiontube> </isgmw:sourcedocument> 5.2.3 Brondocument additiongmwtubestatus <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> DATE <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:tubenumber>1</isgmw:tubenumber> <isgmw:status codespace="urn:bro:gmw:tubestatus">klaarvoorgebruik</isgmw:status> </isgmw:sourcedocument> 5.2.4 Brondocument additiongmwmaintainanceresponsibleparty <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> DATE <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:maintenanceresponsibleparty>30277173</isgmw:maintenancerespon sibleparty> </isgmw:sourcedocument> Pagina 35 van 50

5.2.5 Brondocument additiongmwwellheadprotectionandtubelength <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> DATE <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:tubenumber>1</isgmw:tubenumber> <isgmw:fullydescribed codespace="urn:bro:indicationyesno">ja</isgmw:fullydescribed> <isgmw:localverticalreferencepoint codespace="urn:bro:gmw:localverticalreferencepoint">nap </isgmw:localverticalreferencepoint> <isgmw:wellheadprotector codespace="urn:bro:gmw:wellheadprotector"> beschermkoker</isgmw:wellheadprotector> <isgmw:length uom="m">1.000</isgmw:length> <isgmw:topverticalpositiontube uom="m">1.000</isgmw:topverticalpositiontube> <isgmw:topverticalpositionriserpart1 uom="m">1.000 </isgmw:topverticalpositionriserpart1> <isgmw:verticalpositioningmethod codespace="urn:bro:gmw:verticalpositioningmethod"> DGPS01_025m</isgmw:verticalPositioningMethod> <isgmw:verticalpositioningoperator>30277172</isgmw:verticalpositioni ngoperator> </isgmw:sourcedocument> 5.2.6 Brondocument additiongmwwellheadprotection <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> DATE <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:wellheadprotector codespace="urn:bro:gmw:wellheadprotector">beschermkoker </isgmw:wellheadprotector> </isgmw:sourcedocument> 5.2.7 Brondocument additiongwmtuberepair <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> DATE <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:tubenumber>1</isgmw:tubenumber> <isgmw:fullydescribed codespace="urn:bro:indicationyesno">nee</isgmw:fullydescribed> <isgmw:topverticalpositiontube uom="m">1.000</isgmw:topverticalpositiontube> <isgmw:localverticalreferencepoint codespace="urn:bro:gmw:localverticalreferencepoint">nap </isgmw:localverticalreferencepoint> <isgmw:topverticalpositionappliedriser uom="m">1.000 </isgmw:topverticalpositionappliedriser> Pagina 36 van 50

<isgmw:bottomverticalpositionappliedriser uom="m">1.000 </isgmw:bottomverticalpositionappliedriser> <isgmw:material codespace="urn:bro:gmw:materialtype">teflon</isgmw:material> <isgmw:internaldiameterappliedriser uom="mm">13</isgmw:internaldiameterappliedriser> <isgmw:verticalpositioningmethod codespace="urn:bro:gmw:verticalpositioningmethod"> DGPS01_025m</isgmw:verticalPositioningMethod> <isgmw:verticalpositioningoperator>30277172</isgmw:verticalpositioni ngoperator> </isgmw:sourcedocument> 5.2.8 Brondocument additiongmwgroundlevel <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> DATE <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:verticaldatum codespace="urn:bro:verticaldatum">nap</isgmw:verticaldatum> <isgmw:verticalpositiongroundlevel uom="m">1.000</isgmw:verticalpositiongroundlevel> <isgmw:verticalpositioningmethod codespace="urn:bro:gmw:verticalpositioningmethod"> DGPS01_025m</isgmw:verticalPositioningMethod> <isgmw:verticalpositioningoperator>09122561</isgmw:verticalpositioni ngoperator> </isgmw:sourcedocument> 5.2.9 Brondocument additiongmwwellposition DATE <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:verticaldatum codespace="urn:bro:verticaldatum">nap</isgmw:verticaldatum> <isgmw:localverticalreferencepoint codespace="urn:bro:gmw:localverticalreferencepoint">nap </isgmw:localverticalreferencepoint> <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:verticalpositiongroundlevel uom="m">5.120</isgmw:verticalpositiongroundlevel> <isgmw:verticalpositioningmethod codespace="urn:bro:gmw:verticalpositioningmethod"> DGPS01_025m</isgmw:verticalPositioningMethod> <isgmw:verticalpositioningoperator>09122561</isgmw:verticalpositioni ngoperator> <isgmw:tubeposition> <isgmw:tubenumber>001</isgmw:tubenumber> <isgmw:fullydescribed codespace="urn:bro:indicationyesno">ja </isgmw:fullydescribed> <isgmw:topverticalpositiontube uom="m">5.670</isgmw:topverticalpositiontube> Pagina 37 van 50

<isgmw:topverticalpositionscreen uom="m">- 7.330</isgmw:topVerticalPositionScreen> <isgmw:bottomverticalpositionscreen uom="m">-8.330 </isgmw:bottomverticalpositionscreen> <isgmw:topverticalpositionriserpart1 uom="m">5.670 </isgmw:topverticalpositionriserpart1> <isgmw:bottomverticalpositionriserpart1 uom="m">3.670 </isgmw:bottomverticalpositionriserpart1> <isgmw:topverticalpositionriserpart2 uom="m">3.670 </isgmw:topverticalpositionriserpart2> <isgmw:bottomverticalpositionriserpart2 uom="m">-6.330 </isgmw:bottomverticalpositionriserpart2> <isgmw:topverticalpositionriserpart3 uom="m">-6.330 </isgmw:topverticalpositionriserpart3> <isgmw:bottomverticalpositionriserpart3 uom="m">-7.330 </isgmw:bottomverticalpositionriserpart3> <isgmw:topverticalpositionsedimentsump uom="m">-8.330 </isgmw:topverticalpositionsedimentsump> <isgmw:bottomverticalpositionsedimentsump uom="m">-9.830 </isgmw:bottomverticalpositionsedimentsump> </isgmw:tubeposition> </isgmw:sourcedocument> 5.2.10 Brondocument additiongmwtubeposition <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> DATE <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:startdate>2015-07-29</isgmw:startdate> <isgmw:tubeposition> <isgmw:tubenumber>1</isgmw:tubenumber> <isgmw:fullydescribed codespace="urn:bro:indicationyesno">ja </isgmw:fullydescribed> <isgmw:topverticalpositiontube uom="m">5.670</isgmw:topverticalpositiontube> <isgmw:topverticalpositionscreen uom="m">- 7.330</isgmw:topVerticalPositionScreen> <isgmw:bottomverticalpositionscreen uom="m">-8.330 </isgmw:bottomverticalpositionscreen> <isgmw:topverticalpositionriserpart1 uom="m">5.670 </isgmw:topverticalpositionriserpart1> <isgmw:bottomverticalpositionriserpart1 uom="m">3.670 </isgmw:bottomverticalpositionriserpart1> <isgmw:topverticalpositionriserpart2 uom="m">3.670 </isgmw:topverticalpositionriserpart2> <isgmw:bottomverticalpositionriserpart2 uom="m">-6.330 </isgmw:bottomverticalpositionriserpart2> <isgmw:topverticalpositionriserpart3 uom="m">-6.330 </isgmw:topverticalpositionriserpart3> <isgmw:bottomverticalpositionriserpart3 uom="m">-7.330 </isgmw:bottomverticalpositionriserpart3> <isgmw:topverticalpositionsedimentsump uom="m">-8.330 </isgmw:topverticalpositionsedimentsump> <isgmw:bottomverticalpositionsedimentsump uom="m">-9.830 </isgmw:bottomverticalpositionsedimentsump> </isgmw:tubeposition> <isgmw:verticalpositioningmethod codespace="urn:bro:gmw:verticalpositioningmethod"> DGPS01_025m</isgmw:verticalPositioningMethod> <isgmw:verticalpositioningoperator>09122561</isgmw:verticalpositioni Pagina 38 van 50

ngoperator> </isgmw:sourcedocument> 5.3 Beëindigingsdocument 5.3.1 CompleteRegistrationGMW <isgmw:sourcedocument> <isgmw:broid>gmw000000013561</isgmw:broid> DATE <isgmw:deliveryaccountableparty>30277172</isgmw:deliveryaccountablep arty> <isgmw:abandonmentdate>2015-07-29</isgmw:abandonmentdate> </isgmw:sourcedocument> Pagina 39 van 50

6 Uitwerking specifieke elementen 6.1 Element van het type gml:codewithauthority Dit element kan alleen een waarde bevatten uit in een codelijst. Het codespace attribuut geeft aan welke codelijst van toepassing is. In de XSD is dit uitgewerkt door middel van het toevoegen van een verplicht attribuut codespace. De waardes in codespace zijn overgenomen van de Engelse namen van de domeinen, die in de catalogus beschreven staan. Indien er een andere codespace naam wordt aangeleverd, is dit geen geldige XML. Voorbeeld: <qualityregime codespace="urn:bro:qualityregime">imbro </qualityregime> 6.2 DATE DATE Element van het type xml:date Deze zijn elementen met het domein Datum in de gegevensdefinitie en hebben als conventie een suffix Date. Zij maken gebruik van het standaard xml Date type. domein Datum : type xml:date datum volgens de Greogoriaanse kalender, bestaande uit jaar, maand en dag, inclusief de tijdzone, YYYY-MM- DD(zzzz). Tijdzone informatie is optioneel. Voorbeeld: <gmw:abandonmentdate>2015-04- 05+01:00</gmw:abandonmentDate> 6.3 DIS DIS Element uitsluitend voor leverancier en bronhouder Dit element wordt uitsluitend uitgegeven aan de leverancier of de bronhouder van het registratieobject. Voor andere data-afnemers wordt dit element niet uitgegeven. Voorbeeld: <gmw:verticalpositioningoperator>77778888</gmw:verticalpos itioningoperator> 6.4 ID ID Element met een verplicht attribuut gml:id Een aantal elementen afkomstig van de GML standaard hebben een verplicht attribuut gml:id. Deze identifier is Pagina 40 van 50

bedoeld voor gebruik in referenties binnen een XML document. Hij moet uniek zijn binnen de scope van het XML document. In de BRO wordt deze identificatie op geen andere manier gebruikt en wordt daarom ook niet opgeslagen. Bij uitgifte wordt de identificatie gegenereerd op het moment van uitgifte. Eenzelfde element zal op verschillende momenten een ander gml:id krijgen. Voorbeeld: <brocom:location gml:id="locationfb6c583c-2dcb-41a2-8c10- aaf3e331181b"> 6.5 MEA MEA Element van het type gml:measure Dit element heeft een verplicht attribuut uom om de eenheid aan te geven. Voor de symbolen die bij uom kunnen worden ingevuld volgt de BRO de UCUM standaard. In het UML model en de XSD zijn er subtypes voor een aantal relevante grootheden gedefinieerd, gebaseerd op gml:measure. Voor elk subtype is de uom gedefinieerd en kan geen andere waarde hebben. Indien er een andere uom wordt aangeleverd, is dit geen geldige XML. Voor numerieke waarden met een domein Rationaal getal met lengte x.x in de gegevensdefinitie gelden de volgende algemene regels m.b.t. het aantal decimalen en het aanvullen met nullen en afkappen van waarden. Indien een waarde 3.1 voor een attribuut met het het domein Rationaal getal 2.2 wordt aangeleverd, wordt dit getal bij uitlevering aangevuld tot 3.10. Tot de maximale precisie van het domein worden er nullen toegevoegd aan het getal. Bij uitgifte wordt dan de waarde 3.10 uitgeleverd. Indien er een waarde met grotere precisie wordt aangeleverd dan gespecificeerd, dan wordt dit getal afgekapt. Het getal 3.288 wordt afgekapt tot 3.28 voor het domein Rationaal getal 2.2. Bij uitgifte wordt dan de waarde 3.28 uitgeleverd. Voorbeeld: <gmw:offset uom="m">3.300</gmw:offset> 6.6 MEA NIL MEA NIL Element van het type gml:measure, maar mag leeggelaten worden Dit is een element van het type gml:measuretype (zie uitwerking MEA ). Bij aanlevering volgens IMBRO moet het element verplicht worden ingevuld. Bij aanlevering volgens Pagina 41 van 50

IMBRO/A mag het element leeggelaten worden. Het element is verplicht maar kan worden leeg gelaten met xsi:nil="true". Het attribuut uom is verplicht, ook al is de waarde niet aanwezig. Indien het element optioneel is, mag het geheel weggelaten worden, indien er in de werkelijkheid geen waarde aanwezig is (zowel bij IMBRO als IMBRO/A) Voorbeeld: <gmw:verticalpositiongroundlevel uom="m">- 1.2</gmw:verticalPositionGroundlevel> Voorbeeld: <gmw:verticalpositiongroundlevel xsi:nil="true" uom="m"> </gmw:verticalpositiongroundlevel> 6.7 PT PT Element van het type gml:pointtype Coordinaten worden conform NEN3610 specificaties in het element pos uitgewisseld. Het coordinates element wordt niet gebruikt en door de BRO genegeerd. Het element pos heeft een verplicht attribuut srsname waarmee het coordinaatsysteem wordt aangeven van de aangeleverde coordinaten. Geldige uri s zijn bv. : "urn:ogc:def:crs:epsg::28992" voor RD, "urn:ogc:def:crs:epsg::4326" voor WGS84. Het coordinaatsysteem bepaalt wat de coordinaten betekenen. Voor RD worden respectievelijk x en y uitgewisseld in meters, voor ETRS89 worden respectievelijk lat en long uitgewisseld in decimale graden. De volgende tabel geeft aan de mogelijke aanleveringen weer: Referentiestelsel urn type volgorde eenheid RD urn:ogc:def:crs cartesisch x,y m :EPSG::28992 WGS84 urn:ogc:def:crs :EPSG::4326 geografisch lat, long (φ,λ) decimale graden ETRS89 urn:ogc:def:crs :EPSG::4258 geografisch lat, long (φ,λ) decimale graden Voorbeeld: <gmw:location gml:id="location5056b033-4774-420e-8c39-5c6adb463adf"> <gml:pos srsname="urn:ogc:def:crs:epsg::28992">136777.000 455855.000</gml:pos> </gmw:location> 6.8 TIME TIME Element van het type xml:datetime Pagina 42 van 50