Instructie aanleveren (CPT)

Gegevens voor de BRO kunt u als brondocument aanleveren via het Bronhouderportaal. U moet de gegevens dan aanbieden als ‘BRO-verzoek’. In onderstaande instructie beschrijven we hoe u zo’n BRO-verzoek maakt voor geotechnisch sondeeronderzoek (CPT) en/of hoe u uw software kunt aanpassen.

Wat is een BRO-verzoek?

Een 'BRO-verzoek' bestaat uit het brondocument met een 'request'. Het brondocument is het document met de authentieke gegevens die geregistreerd worden in de landelijke voorziening BRO. Voor elk registratieobject staat in de bijbehorende catalogus waar die Schematische afbeelding van wat een BRO-verzoek isgegevens aan moeten voldoen. Vervolgens is het BRO-verzoek het bestand in IMBRO/XML-formaat dat het BRO-brondocument bevat en als verzoek wordt aangeboden in het Bronhouderportaal . Dit is ook wel de 'request'.

Stapsgewijs een BRO-verzoek maken

Bekijk allereerst het voorbeeldverzoek (zip, 22 bytes). Dit voorbeeld geeft een beeld van wat gemaakt moet worden voor geotechnisch sondeeronderzoek.

Om uw software aan te passen om het juiste BRO-verzoek te laten genereren, zijn technische XML schema definities (XSD’s) beschikbaar. Vanuit dat schema zijn er de overige benodigde XML schema definities. U vindt daar generieke BRO schema’s (brocommon) en specifieke sondering (CPT) schema’s (o.a. cptcommon).

Het is ook mogelijk om dit te bereiken op basis van de beschikbare WSDL of de praktische tooling die beschikbaar is gesteld via GitHub (zie onderaan deze pagina).

NB Op verzoek is een voorbeeldclient (Java) via de Servicedesk beschikbaar.

De inhoud: het brondocument

Onderzoeksgegevens moeten omgezet worden naar een brondocument dat voldoet aan de kwaliteitseisen van de BRO. Mogelijk moeten de onderzoeksgegevens nog aangevuld worden met (meta)gegevens om tot het vereiste kwaliteitsniveau te komen. Om dit te bereiken kunt u gebruikmaken van de praktische tooling die beschikbaar is gesteld via GitHub (zie onderaan deze pagina) of onderstaande documentatie. Weliswaar hoeft u vanwege het Bronhouderportaal geen koppelvlak met SOAP te realiseren, de koppelvlakbeschrijving van de landelijke voorziening BRO bevat alle attributen uit de catalogus in IMBRO/XML-formaat om u op weg te helpen. Ook staat in de bijlage van de koppelvlakbeschrijving een praktische codelijst.

  1. Catalogus Geotechnische sondeeronderzoek (informatiemodel) (pdf, 1.7 MB)
  2. Koppelvlakbeschrijving CPT inname (pdf, 1.9 MB)

Gebruik om er vervolgens een BRO-verzoek van te maken:

Innamehandboek Geotechnisch sondeeronderzoek (pdf, 1.2 MB)

Het resultaat is een BRO-verzoek (inclusief brondocument) dat aangeboden kan worden aan het Bronhouderportaal. NB De organisatie die de gegevens uiteindelijk wil aanleveren bij de BRO moet zich eerst aanmelden en heeft eHerkenning 2+ nodig. Wilt u weten of het XML-formaat werkt? Met de validatieservice kunt u uw BRO-verzoek testen.

Geautomatiseerd gegevens aanleveren

Het is ook mogelijk om de gegevens als 'BRO-verzoek' geautomatiseerd aan te leveren via het Bronhouderportaal. Volg daarvoor de instructie in de online API documentatie van het Bronhouderportaal.

Extra tooling via GitHub

Op GitHub kunt u gebruikmaken van de volgende mogelijkheden specifiek gericht op geotechnisch sondeeronderzoek:

  • Spreadsheet met de GEF-mapping om u op weg te helpen met het maken van een BRO-brondocument. U kunt met de spreadsheet een GEF-bestand mappen op IMBRO en IMBRO/A.
  • Handreiking voor het omzetten van GEF-CPT report naar IMBRO-XML.
  • Open source code om eventueel zelf een GEF-converter te maken. Deze code ondersteunt de BRO XSD schema’s.

NB: Fugro en Wiertsema hebben met deze open source code in opdracht van Geonovum een GEF-converter ontwikkeld. De GEF-converter is gratis beschikbaar voor iedereen die deze wil gebruiken. Neem contact op met de Servicedesk als u belangstelling heeft voor de GEF-converter van Fugro en Wiertsema.

Correctieverzoek

Is er sprake van een foute levering en zijn uw gegevens geregistreerd in de landelijke voorziening BRO? Met een correctieverzoek is het mogelijk om de gegevens aan te passen. Volg daarvoor dezelfde stappen als voor het aanleveren van gegevens. Ook in dit geval moet er een BRO-verzoek gemaakt worden. Omdat het nu gaat om een correctieverzoek, is de ‘request’ correctie. In het innamehandboek staat welke gegevens opgenomen moeten worden in het correctieverzoek. In de koppelvlakbeschrijving staan verdere XML-aanwijzingen. Lever vervolgens het correctieverzoek aan via het Bronhouderportaal.