BRO Productomgeving

GMN Berichtencatalogus innamewebservice


Inleiding

Dit document beschrijft hoe een bronhouder en/of dataleverancier de gegevens over een grondwatermonitoringnet (GMN) kan opnemen in een verzoek voor de Basisregistratie Ondergrond (BRO).

Het document veronderstelt dat de lezer bekend is met de GMN gegevenscatalogus en het Bronhouderportaal. Nadere informatie is te vinden op www.basisregistratieondergrond.nl.

Het document veronderstelt dat de lezer beschikt over de kennis en vaardigheid om een XML-bestand te lezen en te schrijven.

De focus van het document ligt op het beschrijven van de structuur van de mogelijke berichten aan de hand van enkele voorbeelden. Andere zaken zoals definitie, kardinaliteit, domein en bedrijfsregels met betrekking tot de gegevensinhoud van de berichten staan in de gegevenscatalogus. Vervolgstappen, zoals het valideren (testen), aanbieden en verwerken van een BRO-verzoek, staan beschreven in het Bronhouderportaal (zie www.basisregistratieondergrond.nl).

De correctieverzoeken (replaceRequest, insertRequest, moveRequest en deleteRequest) zijn alleen beschikbaar voor het brondocument GMN_StartRegistration; voor de andere brondocumenten zijn de correctieverzoeken op dit moment buiten scope.

Leeswijzer

Dit document behandelt de volgende onderwerpen:

  • Een aantal voorbeeldberichten met toelichtingen.

  • Overzicht van enumeraties (niet-beheerde waardenlijsten) met hun toegestane waarden.

  • Overzicht van codelijsten (beheerde waardenlijsten) met verwijzingen (URL's) naar de websites met toegestane waarden.

  • Een vertaaltabel, aan de hand waarvan, gegeven de Engelstalige naam van een entiteit of een attribuut, de Nederlandse naam in de gegevenscatalogus kan worden opgezocht.

  • Een beschrijving van GMN als een object met levensloop, gebeurtenissen, formele geschiedenis, materiële geschiedenis en aanvullende regels in relatie tot de GMN gegevenscatalogus.

  • Overzicht van BRO-verzoeken.

  • Overzicht van GMN-brondocumenten.

  • Een aantal voorbeeld scenario's, waarin met behulp van een verschillende reeksen van opeenvolgende BRO-verzoeken de tijdlijnen van diverse gegevens worden opgebouwd.

Contactinformatie

Algemene informatie, documentatie en voorbeeld XML-berichten kunt u vinden op www.basisregistratieondergrond.nl.

Heeft u een vraag over de BRO? Wij staan voor u klaar om u te helpen.

Voor vragen, suggesties of opmerkingen kunt contact opnemen met de BRO Servicedesk via een mail naar support@broservicedesk.nl .

Als u toegang heeft tot de BRO Selfservicedesk (alleen via desktop of laptop), kunt u daar inloggen en uw vraag stellen voor een extra snelle afhandeling.

Of bel ons op telefoonnummer 088 - 8664 999. Wij zijn op werkdagen van 8.00 tot 17.00 uur bereikbaar.

Versiehistorie

Versie

Datum

Omschrijving

0.1

12-02-2019

Increment 1: Algemene gegevens en eerste opzet buisverwijzing.

0.2

26-08-2019

Increment 2: Alleen algemene gegevens, geen buisverwijzing.

0.3

28-02-2020

Increment 3: Gebaseerd op versie 0.99 van de gegevenscatalogus; correctieverzoeken in hoofdstuk 2 en 4 nog buiten scope.

1.0

06-03-2020

Increment 3: Definitieve eerste versie gebaseerd op versie 0.99 van de gegevenscatalogus.

1.1

18-12-2020

Feature team correcties: maximaal 1 meetpunt in de brondocumenten GMN_MeasuringPoint, GMN_MeasuringPointEndDate en GMN_TubeReference.

1.1.1

23-12-2020

Verwijzing naar (test-)voorbeeldberichten op BRO productomgeving

1.1.2

22-02-2021

ReplaceRequest en MoveRequest geactiveerd voor GMN_StartRegistration.

1.1.3

22-02-2021

Pagina redactioneel grondig gehherstructureerd.

1.1.4

24-03-2021

Omschrijving bij Partialdate uitgebreid.

1.1.5

25-03-2021

TIP "Start met 1 meetpunt als de datum niet volledig bekend is" toegevoegd bij brondocument GMN_StartRegistration.

1.1.6

26-03-2021

subpagina GMN BCI BRO-verzoeken: verwijzing naar pagina met generieke beschrijving van de codelijst CorrectionReason.

1.1.7

29-03-2021

Verwijzing naar pagina met generieke beschrijving van het gebruik van een codelijst.