Basisregistratie ondergrond (BRO) Innamehandboek

Basisregistratie ondergrond (BRO) Innamehandboek Geotechnisch sondeeronderzoek

Datum Status

4 november 2014 Draft

BRO-Innamehandboek Geotechnisch sondeeronderzoek versie 0.5

Colofon Bestuurskern Dir. Ruimtelijke Ontwikkeling Plesmanweg 1-6 Den Haag Contactpersoon

D.W. van Barneveld Senior Beleidsmedewerker T 070-4561630 M +31(0)6-25094586 [email protected]

Versie

0.5

Auteur

TNO Geologische Dienst Nederland


Inhoudsopgave 1

Inleiding ............................................. 6 1.1

Doel en doelgroep innamehandboek.................. 6

1.2

Samenhang met andere documentatie .............. 6

1.3

Leeswijzer ......................................................... 8

1.4

Versiehistorie .................................................... 8

1.5

Contactinformatie .............................................. 8

2 Inname van geotechnisch sondeeronderzoek .................................... 9 2.1

Gegevens aanbieden ......................................... 9

2.2

Innameloket of -webservice .............................. 9

2.3

Het begrip transactie ....................................... 10

2.4

Innametransacties .......................................... 10

2.5 Kwaliteitsregime waaraan registratieobject voldoet ....................................................................... 11

3

Aanbieden via de webservice ........... 13 3.1

Voordat de transactie begint ........................... 13

3.2 kort

De verwerking van een registratieverzoek in het 14

3.3 De verwerking van een registratieverzoek in meer detail ..................... Fout! Bladwijzer niet gedefinieerd. 3.3.1 Doen van een registratieverzoek ................ 15 3.3.2 Uitvoeren toegangscontrole .. Fout! Bladwijzer niet gedefinieerd. 3.3.3 Uitvoeren gegevenscontrole . Fout! Bladwijzer niet gedefinieerd. 3.3.4 Vastleggen gegevens ..... Fout! Bladwijzer niet gedefinieerd. 3.4 kort

De verwerking van een correctieverzoek in het 19

3.5 De verwerking van een correctieverzoek in meer detail 20 3.5.1 Doen van een correctieverzoek ................... 20 3.5.2 Uitvoeren toegangscontrole .. Fout! Bladwijzer niet gedefinieerd. 3.5.3 Uitvoeren gegevenscontrole . Fout! Bladwijzer niet gedefinieerd.

Pagina 4 van 36


3.5.4 Beoordelen gegevens ..... Fout! Bladwijzer niet gedefinieerd. 3.5.5 Vastleggen gegevens ..... Fout! Bladwijzer niet gedefinieerd.

4 Specificatie van de transactiegegevens bij inname van geotechnisch sondeeronderzoek .................................. 27 4.1 Specificatie van de domeinen ...... Fout! Bladwijzer niet gedefinieerd.

5

Aanbieden via het loket .................... 36

Pagina 5 van 36


1

Inleiding

1.1

Doel en doelgroep innamehandboek In de basisregistratie ondergrond (BRO) wordt een aantal typen gegevens geregistreerd, de registratieobjecten. Een van de registratieobjecten is geotechnisch sondeeronderzoek. Het innamehandboek richt zich op de partijen die geotechnisch sondeeronderzoek aan de registerbeheerder van de BRO aanleveren en beschrijft hoe het proces van gegevensinname globaal verloopt. Het doel is de leveranciers van gegevens, de dataleveranciers, in algemeen begrijpelijke bewoordingen inzicht te geven in de stappen die in dit proces worden doorlopen, in de begrippenwereld die wordt gehanteerd, in de vormen van controle en in de berichten die tussen de leverancier, en de registerbeheerder worden uitgewisseld.

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. Tevens zijn hierin een beschrijving van de kardinaliteit (het aantal keer dat de entiteit of het attribuut voorkomt), regels voor het gebruik en de waardes die toegestaan zijn voor de attributen te vinden. Tot slot wordt de samenhang tussen de entiteiten beschreven. De catalogus beschrijft dus de inhoud van de BRO en vormt de basis voor de andere beschrijvende 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 inname of uitgifte. Om te

Pagina 6 van 36


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 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. Voor geotechnisch sondeeronderzoek is er nog een bijzonder document, de handreiking voor conversie. In die handreiking wordt inzichtelijk gemaakt hoe de informatie uit het GEF-CPT formaat naar IMBRO-XML moet worden omgezet. Het GEF formaat is de thans in het werkveld gebruikte standaard voor uitwisseling, en IMBRO-XML is het formaat dat de BRO vraagt.

Deze documenten hangen samen zoals hieronder afgebeeld.

Dataleveranciers

Handreiking conversie

Gegevensdefinitie registratieobject

GEF-CPT Report naar IMBRO-XML

Catalogus voor BRO Geotechnisch Sondeeronderzoek

Beschrijving transacties

Beschrijving technische realisatie

Data-afnemers

Innamehandboek voor BRO Geotechnisch Sondeeronderzoek

Koppelvlakbeschrijving CPT Innameservice

Uitgiftehandboek voor BRO Geotechnisch Sondeeronderzoek

Koppelvlakbeschrijving CPT Uitgifteservice

Figuur 1: Samenhang tussen documentatie

Pagina 7 van 36


1.3

Leeswijzer Hoofdstuk 1 geeft het doel en de doelgroep, de samenhang met andere documenten en de versiehistorie van dit innamehandboek. Hoofdstuk 2 geeft een inleiding op de inname van geotechnisch sondeeronderzoek. Hierbij wordt ingegaan op de keuzen die een dataleverancier moet maken als hij gegevens wil gaan aanbieden. Hoofdstuk 3 legt uit hoe het aanbieden van gegevens via de webservice verloopt. Het vertelt ook welke gegevens een dataleverancier moet meesturen met zijn verzoek en welke gegevens hij terug kan verwachten als antwoord. Hoofdstuk 4 geeft een specificatie van de gegevens die nodig zijn om de inname goed te laten verlopen. Hoofdstuk 5 ten slotte vertelt hoe de inname via het loket verloopt. Dit hoofdstuk is in deze versie nog niet ingevuld.

1.4

Versie Versie 0.1 Versie 0.5

1.5

Versiehistorie

Datum September 2012 Oktober 2014

Omschrijving verandering Eerste opzet ….[LO1]

Contactinformatie Voor vragen, suggesties of opmerkingen kunt u via [email protected] contact opnemen met de servicedesk van de Basisregistratie ondergrond (BRO).

Pagina 8 van 36


2

Inname van geotechnisch sondeeronderzoek

2.1

Gegevens aanbieden Niet iedere organisatie mag gegevens aan de BRO aanbieden. Een organisatie moet zich eerst als dataleverancier bij de BRO hebben laten registreren. De registratie is gekoppeld aan een bepaald type registratieobject. Om geotechnisch sondeeronderzoek aan te mogen bieden moet een organisatie zich dus als dataleverancier van geotechnisch sondeeronderzoek bij de BRO hebben laten registreren. Wanneer het om een bronhouder gaat die zelf gegevens wil aanbieden, dan is er sprake van een bilaterale overeenkomst en kan de bronhouder zich direct als dataleverancier bij de BRO laten registreren. Wanneer het niet om een bronhouder gaat maar om een intermediaire partij die namens een bronhouder gegevens wil aanleveren, dan is de bronhouder als derde partij nodig. Als een organisatie zich laat registreren, dan moet die ook aangeven van welke functionaliteit zij gebruik wilt maken, en dat wil zeggen aangeven op welke manier zij de gegevens wilt aanbieden.

2.2

Innameloket of -webservice Geotechnisch sondeeronderzoek kan op twee verschillende manier aan de BRO worden aangeboden, via het innameloket of via de innamewebservice. Wanneer de dataleverancier gebruik maakt van de webservice dan heeft hij een eigen applicatie nodig om de gegevens aan te bieden. Hij laat zijn systeem dan direct gegevens overdragen aan het systeem van de registerbeheerder van de BRO, het BRO-systeem. Via het loket verloopt de overdracht in twee stappen. De dataleverancier biedt eerst de gegevens aan het loket aan en maakt daarbij op het loket bepaalde keuzen. Vervolgens biedt het loket de gegevens ter registratie aan (andere componenten van) het BRO-systeem aan. Inname via het loket vraagt meer menselijke handelingen, maar biedt wel meer keuzevrijheid dan inname via de webservice.

Pagina 9 van 36


2.3

Het begrip transactie Voor de dataleverancier is het een groot verschil of hij gegevens aanbiedt via de innamewebservice of via het innameloket. Maar de overeenkomsten zijn eigenlijk belangrijker omdat het doel altijd hetzelfde is. Via beide wegen biedt de dataleverancier immers gegevens aan met het doel de gegevens op te laten nemen in de basisregistratie. Het komt er altijd op neer dat de dataleverancier een verzoek doet tot overdracht van gegevens en dat de registerbeheerder dat verzoek beoordeelt om, als alles goed is, de gegevens in het systeem op te nemen. Gaat er iets onverhoopt fout, dan wijst de beheerder het verzoek af. Een dataleverancier kan een heleboel geotechnische sondeeronderzoeken tegelijk willen aanbieden, maar de BRO handelt alle verzoeken per object af, en dat wil zeggen één geotechnisch sondeeronderzoek tegelijk. Dus wanneer een dataleverancier tien sondeeronderzoeken tegelijk wil aanbieden, handelt de BRO dat als tien innameverzoeken af. Het proces dat met het indienen van zo’n enkelvoudig verzoek gestart wordt heet een transactie. Als er gegevens worden aangeboden spreken we van een innametransactie. Een innametransactie heeft dus betrekking op één geotechnisch sondeeronderzoek. De gegevens van dat ene geotechnisch sondeeronderzoek vormen een geheel en dat heet in de taal van de BRO een brondocument. Een brondocument bevat alle gegevens die de dataleverancier moet en mag aanbieden. Wat dat is staat in de catalogus. Om de transactie, de overdracht van een brondocument van de dataleverancier aan de registerbeheerder van de BRO, ordentelijk te laten verlopen zijn een paar aanvullende gegevens nodig. Die worden de transactiegegevens genoemd. De transactiegegevens zijn de gegevens die nodig zijn in de communicatie tussen de twee partijen en beschrijven het verzoek van de leverancier en het antwoord van de registerbeheerder.

2.4

Innametransacties Een innametransactie begint er altijd mee dat een dataleverancier een brondocument aanbiedt aan de registerbeheerder. Maar er bestaan wel verschillende typen transacties. Het hangt er namelijk van af wat de dataleverancier precies beoogt. De eerste en belangrijkste vraag is of een leverancier gegevens aan de BRO wil overdragen van een object dat nog niet in de

Pagina 10 van 36


BRO geregistreerd is, of dat hij fouten wil verbeteren in de gegevens die al in de BRO aanwezig zijn. Deze vraagt geldt voor alle typen registratieobjecten. Voor geotechnisch sondeeronderzoek is dit de enige vraag. Voor bepaalde andere objecten is een tweede vraag van belang. Dat is de vraag of de dataleverancier nieuwe gegevens wil toevoegen aan een registratieobject dat al in de BRO aanwezig is. Er zijn in het totaal vier typen innametransacties, 1. Registreren De transactie die tot doel heeft gegevens aan de BRO over te dragen van een object, dat nog niet in de BRO geregistreerd is. 2. Aanvullen De transactie die tot doel heeft nieuwe gegevens over te dragen om die toe te voegen aan een object dat al in de BRO geregistreerd is. 3. Beëindigen registratie De transactie die tot doel heeft een eind te maken aan het toevoegen van gegevens en het aanvullen te beëindigen. 4. Corrigeren De transactie die tot doel heeft onjuiste gegevens van een een object dat al in de BRO geregistreerd is te wijzigen. Registreren en corrigeren zijn zoals gezegd de enige transacties die voor geotechnisch sondeeronderzoek mogelijk zijn. De mogelijkheid gegevens toe te voegen bestaat niet. Het sondeeronderzoek moet altijd als één geheel aan de BRO aangeboden, dus met de eventueel uitgevoerde dissipatietesten. Dat geldt bij registreren en bij corrigeren. Men zou zich kunnen afvragen of er ook een transactie is die tot doel heeft alle gegevens van een registratieobject te verwijderen. Het antwoord daarop is dat dit niet via een webservice kan. De registerbeheerder beslist of de gegevens van een registratieobject verwijderd kunnen worden en daar gaat altijd een onderzoek aan vooraf. Bovendien zullen nooit alle gegevens uit de registratie verwijderd worden. Overigens is de procedure die de registerbeheerder daarbij moet volgen op dit moment nog niet uitgewerkt. 2.5

Kwaliteitsregime waaraan registratieobject voldoet

Pagina 11 van 36


De Basisregistratie ondergrond stelt stringente eisen aan de gegevens van registratieobjecten. Er zijn echter veel gegevens die zijn verzameld vóór de datum waarop de wet-BRO in werking is getreden en die veelal niet aan deze stringente eisen voldoen. Omdat die gegevens wel waardevol zijn, heeft de wetgever besloten dat de basisregistratie ook die gegevens moet bevatten. Zodoende kent de BRO twee kwaliteitsregimes voor registratieobjecten: 1.het eerste is het kwaliteitsregime waarbij een registratieobject aan de meest stringente eisen voldoet: IMBRO; 2.het tweede is het kwaliteitsregime waarbij een registratieobject (daterend van vóór de inwerkingtreding van de wet) aan minder stringente eisen voldoet: IMBRO/A. De objecten die zich naar de stringente regels voegen, zijn te herleiden tot een brondocument dat in IMBRO is aangeleverd, en de tweede vorm tot een brondocument dat in IMBRO/A is aangeleverd. Om aansluiting op de BRO te vergemakkelijken is een periode van transitie voorzien. In de periode van transitie is de aanlevering van brondocumenten in IMBRO en IMBRO/A toegestaan zonder dat er eisen worden gesteld ten aanzien van de datum waarop de gegevens zijn geproduceerd. De periode van transitie is nog niet bepaald en zal per registratieobject kunnen verschillen omdat niet alle objecten op hetzelfde moment onder de wet gaan vallen. In principe geldt dat de transitie begint voordat de wet voor het registratieobject van kracht wordt en tot na die datum duurt. Na afloop van de transitieperiode gelden aanvullende regels; het criterium is daarbij of de gegevens dateren van vóór of na de 1 datum van het einde van de transitieperiode .

1

De precieze regels moeten nog worden uitgewerkt.

Pagina 12 van 36


3

Aanbieden via de webservice

3.1

Voordat de transactie begint Bij inname via de webservice biedt het systeem van de dataleverancier één brondocument tegelijk aan het systeem van de BRO aan. Om een brondocument aan te kunnen bieden moet het systeem van de dataleverancier een aantal dingen weten. Om te beginnen moet het weten welke BRO-webservice moet worden aangeroepen. Het gaat daarbij om het adres waar de innameservice op het internet te vinden is. In het geval van geotechnisch sondeeronderzoek is het adres: https://www.broservices.nl/wus/iscpt-v0.9. Het laatste stukje in het adres (-v0.9) geeft het versienummer van de innameservice aan. Het versienummer verandert met het in gebruik nemen van een nieuwe versie2. Vervolgens moet het systeem weten of de dataleverancier een object wil registreren of dat hij gegevens wil corrigeren. Die keuze moet de dataleverancier aan zijn eigen systeem kenbaar maken, dan weet het systeem welke functie van de service het moet gebruiken. Als derde moet duidelijk zijn onder welk kwaliteitsregime het brondocument valt, IMBRO of IMBRO/A. Om de overdracht van het brondocument goed te laten verlopen is nog wat aanvullende informatie nodig. In het geval van registreren is het voldoende dat de dataleverancier een eigen kenmerk voor de transactie meegeeft, het transactie-ID van de leverancier. In het geval van corrigeren is er meer nodig dan het transactieID van de leverancier. De dataleverancier moet namelijk ook aangeven wat de reden is voor de correctie. Dat laatste is nodig om medewerkers van de basisregistratie ondergrond is staat te stellen te beoordelen of het proces van overdracht onder de juiste condities verloopt. Dat betekent bijvoorbeeld dat de databeheerder moet kunnen zien of de dataleverancier niet keer op keer hetzelfde verbetert. De gegevens die via de innamewebservice aan de BRO worden overgedragen staan in het IMBRO-XML formaat. Het IMBRO-XML formaat is de gegevensdefinitie van de BRO omgezet naar de technische taal die voor de uitwisseling van gegevens met het systeem van de BRO gebruikt wordt. De technische uitwerking

2

De versie die in de ketentest voor inname wordt gebruikt is nog niet de definitieve versie.

Pagina 13 van 36


van dit formaat wordt toegelicht in de betreffende koppelvlakbeschrijvingen.

3.2

De verwerking van een registratieverzoek De verwerking van een registratieverzoek verloopt geheel automatisch, en volgens een vaste opeenvolging van stappen. Dit is waar het in het kort op neerkomt: 1. De dataleverancier stuurt vanuit zijn systeem een registratieverzoek met daarin een registratiebrondocument. 2. Het systeem van de BRO voert een toegangscontrole uit. O Wanneer de toegang wordt geweigerd, ontvangt (het systeem van) de dataleverancier daarvan bericht. 3. Wanneer de dataleverancier toegang tot het systeem heeft gekregen, wordt het registratieverzoek door het systeem van de BRO in ontvangst genomen en begint de controle van het verzoek. Dat betekent vooral dat er gecontroleerd wordt of het registratiebrondocument aan de eisen van de gegevensdefinitie voldoet. O Wanneer de controle fouten oplevert, wordt het verzoek afgewezen en ontvangt (het systeem van) de dataleverancier daarvan bericht. 4. Wanneer de controle geen fouten heeft opgeleverd, wordt het registratieverzoek door het systeem van de BRO geaccepteerd. De aangeboden gegevens worden met de gegevens die de BRO zelf genereert vastgelegd. Het BRO-systeem stuurt de dataleverancier als antwoordbericht dat het registratieverzoek is uitgevoerd. Het registratiebrondocument is dan opgenomen in het register brondocumenten ondergrond en de gegevens zijn eruit gehaald en in de registratie ondergrond vastgelegd. De gegevens zijn dan beschikbaar voor alle data-afnemers. Het verzoek van de data-leverancier en het antwoord die de registerbeheerder daarop geeft worden berichten genoemd. Bij ieder van de vier stappen hoort een bericht, en dat wordt in het onderstaande plaatje uitgebeeld.

Pagina 14 van 36


Dataleverancier

Basisregistratie Ondergrond (BRO)

Stap 1: Doen van een registratieverzoek

Registratieverzoek

Toegang geweigerd

Stap 2: Uitvoeren toegangscontrole

Registratieverzoek afgewezen

Stap 3: Uitvoeren gegevenscontrole

Registratieverzoek uitgevoerd

Stap 4: Vastleggen gegevens

Systeem van de dataleverancier

Systeem van de BRO

Figuur 2: Verwerking van een registratieverzoek

3.3

De berichten die bij registratie worden uitgewisseld 3.3.1 Het registratieverzoek De dataleverancier stuurt vanuit zijn systeem een registratieverzoek. Het belangrijkste onderdeel van het bericht is het registratiebrondocument. Om communicatie over het verzoek mogelijk te maken, moet de data-leverancier het verzoek een eigen kenmerk meegeven en dat wordt het extern transactie-ID genoemd. Andere belangrijke transactiegegevens, bijvoorbeeld dat het om een registratieverzoek gaat voor geotechnisch sondeeronderzoek en de aanduiding van het kwaliteitsregime waaronder het brondocument valt, zitten al in de functie besloten die door de data-leverancier in de webservice wordt aangesproken. Stap 1: Doen van een registratieverzoek

Registratieverzoek extern transactie-id Registratiebrondocument

Het registratiebrondocument bevat alle gegevens die in de catalogus voor geotechnisch sondeeronderzoek zijn gespecificeerd, met uitzondering van:

Pagina 15 van 36


het attribuut ‘bro-id’ het attribuut ‘registratietijdstip’ het attribuut ‘registratiestatus’ het attribuut ‘in onderzoek’ het attribuut ‘tijdstip laatste transactie’ de entiteit ‘gestandaardiseerde positie’ Die gegevens worden namelijk door de BRO gegenereerd. 3.3.2 Toegang geweigerd Het systeem van de BRO voert bij ieder innameverzoek twee controles uit: • Het systeem controleert of de dataleverancier bij de BRO geregistreerd is als dataleverancier van geotechnisch sondeeronderzoek, en • het systeem controleert of de dataleverancier al het recht heeft gekregen voor het gebruik van de innamewebservice voor geotechnisch sondeeronderzoek. Als bij het uitvoeren van de toegangscontrole blijkt dat de toegang moet worden geweigerd, ontvangt (het systeem van) de dataleverancier hiervan bericht. In het bericht van weigering staat alleen dat de dataleverancier geen rechten heeft. Stap 2: Uitvoeren toegangscontrole

Toegang geweigerd “U beschikt niet over de juiste rechten“

3.3.3 Registratieverzoek afgewezen Voor alle innameverzoeken geldt dat de aangeboden gegevens door het BRO-systeem gecontroleerd worden. Dat betekent dat het registratieverzoek op de volgende aspecten wordt beoordeeld:  zijn de verplichte gegevens aanwezig?  zijn de gegevens van het voorgeschreven type (numeriek, alfanumeriek, enz.) en hebben ze de juiste lengte?  hebben de gegevens een toegestane waarde?  voldoen de gegevens aan de (aanvullende) regels die in de catalogus of in dit innamehandboek (zie hoofdstuk 4) zijn vastgelegd? Als de BRO bij de controle van het registratieverzoek tegen fouten aanloopt, ontvangt (het systeem van) de dataleverancier bericht van afwijzing.

Pagina 16 van 36




Verwijzing naar het registratieverzoek Gegevens van ontvangst Gegevens van afwijzing

Het bericht van afwijzing bestaat uit verschillende onderdelen. Het belangrijkste wordt gevormd door de gegevens van afwijzing. Daarin wordt vooral informatie gegeven over de in het verzoek geconstateerde fouten. Dit stuk informatie wordt het foutenblok genoemd. In het foutenblok wordt opgenomen: op welk regelnummer van het brondocument de fout is geconstateerd bij welk attribuut de fout is geconstateerd wat de fout is. Het bericht van afwijzing bevat verder een verwijzing naar het registratieverzoek, en de gegevens die de BRO bij de ontvangst van het verzoek heeft gegenereerd. Het complete bericht van afwijzing van een registratieverzoek ziet er als volgt uit:


Verwijzing naar het registratieverzoek

Gegevens van ontvangst

Gegevens van afwijzing

extern transactie-id dataleverancier type transactie component kwaliteitsregime tijdstip van ontvangst bro transactie-id tijdstip van afwijzing door het systeem bronhouder object-id bronhouder foutenblok

3.3.4 Registratieverzoek uitgevoerd Wanneer alles goed is gegaan en de gegevens in de BRO zijn vastgelegd, ontvangt (het systeem van) de dataleverancier het bericht dat het registratieverzoek is uitgevoerd.

Pagina 17 van 36



Registratieverzoek uitgevoerd Verwijzing naar het registratieverzoek Gegevens van ontvangst Gegevens van acceptatie Gegevens van verwerking

Het bericht van verwerking bestaat ook weer uit verschillende onderdelen. Het belangrijkste wordt gevormd door de gegevens van verwerking. Daarin staat wanneer het object is geregistreerd en wat de BRO-ID is, de identificatie van het object in de BRO dat voortaan in het formele berichtenverkeer moet worden gebruikt. Het bericht van verwerking bevat, net als het bericht van afwijzing, een verwijzing naar het registratieverzoek, en de gegevens die de BRO bij de ontvangst van het verzoek heeft gegenereerd. Ten slotte worden ook de gegevens over de acceptatie van het verzoek in het bericht opgenomen. Het complete bericht van verwerking van een registratieverzoek ziet er als volgt uit:

Registratieverzoek uitgevoerd

Verwijzing naar het registratieverzoek


Gegevens van acceptatie

Gegevens van verwerking

extern transactie-id dataleverancier type transactie component kwaliteitsregime tijdstip van ontvangst bro transactie-id tijdstip van acceptatie door het systeem bronhouder object-id bronhouder tijdstip van registratie bro-id

Pagina 18 van 36


3.4

De verwerking van een correctieverzoek De verwerking van een correctieverzoek verloopt iets anders dan dat van een registratieverzoek. De eerste stappen in de verwerking zijn nog hetzelfde, maar nadat het BRO-systeem heeft gecontroleerd of alles goed is, neemt de databeheerder de controle over. Dit is waar het in het kort op neerkomt: 1. De dataleverancier stuurt vanuit zijn systeem een correctieverzoek met daarin een correctiebrondocument. In het verzoek geeft hij aan waarom hij het verzoek indient. 2. Het systeem van de BRO voert een toegangscontrole uit. o Wanneer de toegang wordt geweigerd, ontvangt (het systeem van) de dataleverancier daarvan bericht. 3. Wanneer de dataleverancier toegang tot het systeem heeft gekregen, wordt het correctieverzoek door het systeem van de BRO in ontvangst genomen en begint de controle van het verzoek. Dat betekent vooral dat er gecontroleerd wordt of het correctiebrondocument aan de eisen van de gegevensdefinitie voldoet. o Wanneer de controle fouten oplevert, wordt het verzoek afgewezen en ontvangt (het systeem van) de dataleverancier daarvan bericht. o Wanneer de controle geen fouten oplevert, ontvangt (het systeem van) de dataleverancier bericht van acceptatie 4. Vervolgens neemt de databeheerder de verwerking over en beoordeelt de reden van het correctieverzoek o Indien zijn beoordeling aangeeft dat er iets fout gaat, ontvangt de dataleverancier een e-mail waarin de databeheerder toelicht waarom hij het verzoek heeft moeten afwijzen. 5. Wanneer de databeheerder geen problemen ziet, wordt het verzoek doorgeleid naar het systeem van de BRO. De aangeboden gegevens worden met de gegevens die de BRO zelf genereert vastgelegd. Het BRO-systeem stuurt de dataleverancier per e-mail bericht dat het correctieverzoek is uitgevoerd. Het correctiebrondocument is dan opgenomen in het register brondocumenten ondergrond en de correcte gegevens zijn eruit gehaald en in de registratie ondergrond vastgelegd. De gegevens zijn dan beschikbaar voor alle data-afnemers.

Pagina 19 van 36


Basisregistratie Ondergrond (BRO)

Dataleverancier

Stap 1: Doen van een correctieverzoek

Correctieverzoek

Toegang geweigerd

Stap 2: Uitvoeren toegangscontrole

Correcieverzoek afgewezen


Correctieverzoek geaccepteerd

Systeem van de dataleverancier

Stap 4: Beoordelen gegevens

Correctieverzoek alsnog afgewezen Mail

Correctieverzoek uitgevoerd


Mail

Systeem van de BRO

Figuur 3: Verwerking van een correctieverzoek

3.5

De berichten die bij correctie worden uitgewisseld 3.5.1 Het correctieverzoek De dataleverancier stuurt vanuit zijn systeem een correctieverzoek. Het belangrijkste onderdeel van het bericht is het correctiebrondocument. Om communicatie over het verzoek mogelijk te maken, moet de data-leverancier het verzoek een eigen kenmerk meegeven en dat wordt het extern transactie-ID genoemd. Verder moet hij de reden voor de correctie aangeven. Hij heeft daarbij een keuze uit drie mogelijkheden: o Correctie van het kwaliteitsregime. Dit is een ingrijpende correctie omdat een verandering van het kwaliteitsregime altijd betekent dat in andere gegevens die eerder door de dataleverancier zijn aangeleverd ook een of meer verbeteringen moeten worden doorgevoerd. o Correctie van de zgn. “administratieve” gegevens. Dit betekent dat het kwaliteitsregime correct is maar dat ten minste een van de hieronder opgesomde zgn. “administratieve”gegevens gecorrigeerd moet worden:  rapportagedatum  bronhouder  kader aanlevering  kader inwinning  object-id bronhouder  uitvoerder (van geotechnisch sondeeronderzoek)

Pagina 20 van 36

Databeheerder


 

o

uitvoerder van horizontale plaatsbepaling uitvoerder van verticale plaatsbepaling

De andere gegevens die eerder door de dataleverancier zijn aangeleverd worden de “onderzoeksgegevens” genoemd. Met deze correctie mogen ook fouten in de onderzoeksgegevens verbeterd worden. Correctie van de zgn. “onderzoeksgegevens”. Dit betekent dat het kwaliteitsregime en de administratieve gegevens correct zijn, maar er een verbetering in de onderzoeksgegevens moet worden doorgevoerd.

Andere belangrijke transactiegegevens, bijvoorbeeld dat het om een correctieverzoek gaat voor geotechnisch sondeeronderzoek en de aanduiding van het kwaliteitsregime waaronder het brondocument valt, zitten al in de functie besloten die door de data-leverancier in de webservice wordt aangesproken.

Stap 1: Doen van een correctieverzoek

Correctieverzoek extern transactie-id reden correctie Correctiebrondocument

Het correctiebrondocument bevat alle gegevens die in de catalogus voor geotechnisch sondeeronderzoek zijn gespecificeerd, met uitzondering van: o het attribuut ‘registratietijdstip’ o het attribuut ‘registratiestatus’ o het attribuut ‘in onderzoek’ o het attribuut ‘tijdstip laatste transactie’ o de entiteit ‘gestandaardiseerde positie’ Die gegevens zijn namelijk door de BRO gegenereerd. 3.5.2 Toegang geweigerd Het systeem van de BRO voert bij ieder innameverzoek twee controles uit: • Het systeem controleert of de dataleverancier bij de BRO geregistreerd is als dataleverancier van geotechnisch sondeeronderzoek, en • het systeem controleert of de dataleverancier al het recht heeft gekregen voor het gebruik van de innamewebservice voor geotechnisch sondeeronderzoek.

Pagina 21 van 36


Als bij het uitvoeren van de toegangscontrole blijkt dat de toegang moet worden geweigerd, ontvangt (het systeem van) de dataleverancier hiervan bericht. In het bericht van weigering staat alleen dat de dataleverancier geen rechten heeft. Stap 2: Uitvoeren toegangscontrole

Toegang geweigerd “U beschikt niet over de juiste rechten“

3.5.3 Correctieverzoek afgewezen Voor alle innameverzoeken geldt dat de aangeboden gegevens door het BRO-systeem gecontroleerd worden. Dat betekent dat het correctieverzoek op de volgende aspecten wordt beoordeeld:  zijn de verplichte gegevens aanwezig?  zijn de gegevens van het voorgeschreven type (numeriek, alfanumeriek, enz.) en hebben ze de juiste lengte?  hebben de gegevens een toegestane waarde?  voldoen de gegevens aan de (aanvullende) regels die in de catalogus of in dit innamehandboek (zie hoofdstuk 4) zijn vastgelegd?

Bij een correctieverzoek voor geotechnisch sondeeronderzoek gelden de volgende aanvullende controles: - controle of het BRO-ID, de identificatie van het geotechnisch sondeeronderzoek, in de BRO bekend is - controle of de dataleverancier dezelfde is als de dataleverancier die bij het BRO-ID dat in de registratie is vastgelegd - controle of als het kwaliteitsregime moet veranderen als de reden voor correctie de waarde ‘correctie van kwaliteitsregime’ is meegegeven. - controle of bij een correctie binnen hetzelfde kwaliteitsregime als reden voor correctie een andere waarde dan ‘correctie van kwaliteitsregime’ is meegegeven. Als de BRO bij de controle van het correctieverzoek tegen fouten aanloopt, ontvangt (het systeem van) de dataleverancier bericht van afwijzing.

Pagina 22 van 36



Correctieverzoek afgewezen Verwijzing naar het correctieverzoek Gegevens van ontvangst Gegevens van afwijzing

Het bericht van afwijzing bestaat uit verschillende onderdelen. Het belangrijkste wordt gevormd door de gegevens van afwijzing. Daarin wordt vooral informatie gegeven over de in het verzoek geconstateerde fouten. Dit stuk informatie wordt het foutenblok genoemd. In het foutenblok wordt opgenomen: op welk regelnummer van het brondocument de fout is geconstateerd bij welk attribuut de fout is geconstateerd wat de fout is. Het bericht van afwijzing bevat verder een verwijzing naar het correctieverzoek, en de gegevens die de BRO bij de ontvangst van het verzoek heeft gegenereerd. Het complete bericht van afwijzing van een correctieverzoek ziet er als volgt uit:

Correctieverzoek afgewezen

Verwijzing naar het correctieverzoek


Gegevens van afwijzing

extern transactie-id reden correctie dataleverancier type transactie component kwaliteitsregime tijdstip van ontvangst bro transactie-id tijdstip van afwijzing door het systeem bronhouder bro-id foutenblok

Pagina 23 van 36


3.5.4 Correctieverzoek geaccepteerd Wanneer de controle door het systeem van de BRO geen fouten oplevert, ontvangt (het systeem van) de dataleverancier een bericht van acceptatie. Stap 3: Uitvoeren gegevenscontrole

Correctieverzoek geaccepteerd Verwijzing naar het correctieverzoek Gegevens van ontvangst Gegevens van acceptatie

Het bericht van acceptatie bestaat ook weer uit verschillende onderdelen. Naast de gegevens over de acceptatie zelf, zijn dat de gegevens over de ontvangst, en uiteraard de verwijzing naar het correctieverzoek. Het complete bericht van acceptatie van een correctieverzoek ziet er als volgt uit:

Correctieverzoek geaccepteerd




extern transactie-id reden correctie dataleverancier type transactie component kwaliteitsregime tijdstip van ontvangst bro transactie-id tijdstip van acceptatie door het systeem bronhouder bro-id

3.5.5 Correctieverzoek alsnog afgewezen Nadat de dataleverancier bericht van acceptatie heeft gekregen, neemt de databeheerder de controle over. Hij kijkt vooral of hij, gezien de aard van de correctie, reden ziet in te grijpen door de verwerking stop te zetten. In dat geval zal hij een e-mail sturen naar de dataleverancier om hem uit te leggen waarom hij het correctieverzoek heeft moeten afwijzen.

Pagina 24 van 36


Stap 4: Beoordelen gegevens

Correctieverzoek alsnog afgewezen Mail

Verwijzing naar het correctieverzoek Gegevens van ontvangst Gegevens van acceptatie Gegevens van afwijzing

In het e-mail bericht geeft de databeheerder aan welke reden hij heeft om het correctieverzoek af te wijzen, de reden van afwijzing. De reden van afwijzing kent geen vaste structuur, zoals het foutenblok die bijvoorbeeld wel kent. Het staat de databeheerder vrij het tekstveld handmatig in te vullen. Naast de reden van afwijzing bevat het bericht een verwijzing naar het registratieverzoek en de gegevens die bij de ontvangst en de acceptatie door de BRO zijn gegenereerd. Het complete bericht waarin staat dat het correctieverzoek alsnog is afgewezen ziet er als volgt uit: Correctieverzoek alsnog afgewezen Mail


Gegevens van ontvangst Gegevens van acceptatie Gegevens van afwijzing

extern transactie-id reden correctie dataleverancier type transactie component kwaliteitsregime tijdstip van ontvangst bro transactie-id tijdstip van acceptatie door het systeem bronhouder bro-id tijdstip van afwijzing door databeheerder reden afwijzing

[Rv2]

3.5.6 Correctieverzoek uitgevoerd Wanneer alles goed is gegaan en de gegevens in de BRO zijn vastgelegd, ontvangt (het systeem van) de dataleverancier het bericht dat het correctieverzoek is uitgevoerd.

Pagina 25 van 36


Correctieverzoek uitgevoerd

Stap 5: Vastleggen gegevens Mail

Verwijzing naar het correctieverzoek Gegevens van ontvangst Gegevens van acceptatie Gegevens van verwerking

Het bericht van verwerking bestaat ook weer uit verschillende onderdelen: een verwijzing naar het registratieverzoek, de gegevens die bij de ontvangst en de acceptatie door de BRO zijn gegenereerd en de tijdstippen van acceptatie door de en het verwerking door het systeem. Het complete bericht van de verwerking van een correctieverzoek ziet er als volgt uit: Correctieverzoek uitgevoerd Mail




Gegevens van verwerking

extern transactie-id reden correctie dataleverancier type transactie component kwaliteitsregime tijdstip van ontvangst bro transactie-id tijdstip van acceptatie door het systeem bronhouder bro-id tijdstip van acceptatie door databeheerder tijdstip van correctie

Pagina 26 van 36


4

Specificatie van de transactiegegevens bij inname van geotechnisch sondeeronderzoek[Rv3]

4.1

Inleiding De gegevens die in de berichten worden gebruikt komen uit verschillende bronnen. De meeste gegevens worden door de BRO geproduceerd, enkele gegevens worden expliciet door de data-leverancier meegegeven, weer andere komen uit het brondocument en ten slotte zijn er ook gegevens die in de door de dataleverancier gebruikte logica verstopt zitten. Die laatste categorie verwijst naar de keuzen die de dataleverancier heeft gemaakt; de BRO leidt die gegevens af uit de gebruikte logica. De bron van een gegeven wordt steeds vermeld. Wanneer het brondocument de bron is, zou verwijzing naar de catalogus kunnen volstaan. Om een compleet overzicht te geven van de gegevens die worden uitgewisseld, wordt die gegevens ook hier gespecificeerd. De kardinaliteit van een gegeven, het kenmerk dat aangeeft of een gegeven al dan niet verplicht is, wordt niet opgenomen in de specificatie. Het hangt namelijk helemaal van het bericht af of het gegeven aanwezig moet zijn, en dat is in het voorgaande hoofdstuk al behandeld.

4.2

Attributen en entiteiten Naam attribuut

bro-id

Definitie

Unieke aanduiding van een registratieobject in de basisregistratie ondergrond.

Domein

ObjectIdentificatie

Regels

Het bro-id moet in het correctiebrondocument zijn opgenomen. Het mag niet voorkomen in het registratiebrondocument.

Toelichting

Het bro-id wordt bij succesvolle registratie van geotechnisch sondeeronderzoek door de BRO toegekend.

Naam attribuut

bronhouder

Definitie

Unieke identificatie van het bestuursorgaan dat bronhouder is van de gegevens.

Pagina 27 van 36


5

Domein

Bedrijf

Toelichting

De bronhouder komt uit het brondocument.

Naam attribuut

bro transactie-id

Definitie

Unieke identificatie die door de BRO wordt gebruikt voor het innameverzoek.

Domein

Tekst200

Toelichting

Het bro transactie-id wordt bij ontvangst van een innameverzoek door de BRO toegekend.

Naam attribuut

component

Definitie

Identificatie van de van de BRO-softwarecomponent die de dataleverancier heeft gebruikt om zijn innameverzoek aan te bieden

Domein

BenamingComponent

Toelichting

De naam van de component die gebruikt is wordt door de BRO afgeleid. Het gegeven ...

Naam attribuut

Dataleverancier

Definitie

De rechtsgeldige identificatie die de dataleverancier gebruikt om toegang te verkrijgen tot het systeem BRO De organisatie die gegevens aanlevert aan de BRO en daartoe gerechtigd is

Domein

Identificatie

Toelichting

De dataleverancier zit vervat in de informatie van de webservice.

Naam attribuut

Extern transactie-id

Definitie

Een eigen kenmerk dat de dataleverancier meegeeft om het innameverzoek te identificeren.

Domein

Tekst200

Naam entiteit

Foutenblok

Definitie

Gestructureerde informatie over de door het BRO-systeem

Pagina 28 van 36


in het bericht geconstateerde fouten. Domein

FoutenInformatie

Toelichting

Het foutenblok wordt bij afwijzing van een innameverzoek door de BRO gegenereerd.

Naam attribuut

Kwaliteitsregime

Definitie

De aanduiding dat de van de validatieregels die gebruikt moet worden onder welk regime het registratieobject valt volgens welk regime het innameverzoek wordt gedaanregistratieobject is aangeleverd

Domein

Kwaliteitsregime

Regels

Het kwaliteitsregime moet overeenkomen met de inhoud van het brondocument.

Toelichting

Het kwaliteitsregime zit vervat in de informatie van de webservice.

Naam attribuut

object-id bronhouder

Definitie

De identificatie die door de bronhouder wordt gebruikt om het object in zijn administratie te identificeren.

Domein

Tekst200

Toelichting

Het object-id bronhouder komt uit het brondocument Reden afwijzing

Naam attribuut Definitie

De reden die de databeheerder opgeeft bij het afwijzen van een correctieverzoek.

Domein

Tekst200

Naam attribuut

Reden correctie

Definitie

Een typering van de verbetering die een dataleverancier in de gegevens van een geregistreerd object wil doorvoeren.

Domein

CorrectieRedenen

Regels

De waarde ‘correctie

Pagina 29 van 36


kwaliteitsregime’ wordt gebruikt bij het corrigeren van kwaliteitsregime, eventueel in combinatie met correcties van administratieve gegevens en/of onderzoeksgegevens De waarde ‘correctie administratieve gegevens’ wordt gebruikt bij het corrigeren van administratieve gegevens, eventueel in combinatie met correcties van onderzoeksgegevens De waarde ‘correctie onderzoeksgegevens’ wordt gebruikt bij het corrigeren van onderzoeksgegevens Toelichting

De reden correctie wordt door de dataleverancier met een correctieverzoek meegegeven.

Naam attribuut

Tijdstip van afwijzing door databeheerder

Definitie

Datum en tijdstip waarop een verzoek door de databeheerder is afgewezen

Domein

DatumTijdMilliSeconde

Toelichting

Bij afwijzing van een innameverzoek door de databeheerder wordt het tijdstip door de BRO vastgelegd.

Naam attribuut

Tijdstip van afwijzing door het systeem

Definitie

Datum en tijdstip waarop een innameverzoek door het BROsysteem is afgewezen.

Domein


Toelichting

Bij afwijzing van een innameverzoek door het systeem, wordt het tijdstip door het BRO-systeem vastgelegd

Naam attribuut

Tijdstip van correctie

Definitie

Datum en tijdstip waarop een object in het innameverzoek in het BRO systeem gecorrigeerd is

Pagina 30 van 36


Domein


Toelichting

Het tijdstip van correctie wordt bij de correctie van geotechnisch sondeeronderzoek automatisch door de BRO toegekend (indien het verzoek niet is afgewezen door het BRO systeem)

Naam attribuut

Tijdstip van ontvangst

Definitie

Datum en tijdstip waarop een object in het innameverzoek door het BRO systeem is ontvangen

Domein


Toelichting

Het tijdstip van ontvangst wordt bij de registratie en correctie van geotechnisch sondeeronderzoek automatisch door de BRO toegekend.

Naam attribuut

Tijdstip van registratie

Definitie

Datum en tijdstip waarop een object in het innameverzoek in het BRO systeem geregistreerd is .

Domein


Toelichting

Het tijdstip van registratie wordt bij de registratie van geotechnisch sondeeronderzoek automatisch door de BRO toegeken (indien het verzoek niet is afgewezen door het BRO systeem).

Naam attribuut

Type transactie

Definitie

Typering van het doel van het innameverzoek Typering van het doel van de overdracht van gegevens

Domein

Registratie Transacties

Regels

Bij registratie van een object geldt de waarde ‘registratie’. Bij correctie van een object geldt de waarde ‘correctie’.[PB4]

Toelichting

Type transactie zit bevat in de

Pagina 31 van 36


informatie die de webservice bevat (nl. een operatie van de webservice)

4.3 Domeinen

Naam domein

Bedrijf

Definitie

KvK nummer, zoals geregistreerd in het Nederlands HandelsRegister (NHR)

Toelichting

Alle ondernemingen en organisaties, zoals bv’s, verenigingen, stichtingen, vof’s, eenmanszaken en maatschappen krijgen bij inschrijving bij de Kamer van Koophandel een KvK-nummer.

Waardeverzameling NNNN NNNN KvK nummer

Naam domein

BenamingComponent

Definitie [LO5] Toelichting

De benaming van de component is afhankelijk van de meest recente versie van de webservice

Waardeverzameling

ISCPT-V[X.X]

Naam domein

CorrectieRedenen[LO6]


De waarde [PB8]‘correctie kwaliteitsregime’ wordt gebruikt voor: o Wijziging van kwaliteitsregime o Eventuele wijzigingen van registratiegegevens o Eventuele wijzigingen van onderzoeksgegevens De waarde ‘correctie registratiegegevens uitgezonderd kwaliteitsregime’ wordt gebruikt

Pagina 32 van 36


voor: o Wijzigingen van registratiegegevens o Eventuele wijzigingen van onderzoeksgegevens De waarde ‘correctie onderzoeksgegevens’ wordt gebruikt voor: o Wijzigingen van onderzoeksgegevens Waardeverzameling

correctie kwaliteitsregime correctie registratiegegevensadministratieve gegevens [PB9]uitgezonderd kwaliteitsregime correctie onderzoeksgegevens

Naam domein

DatumTijdMilliseconde

Definitie

Datum en tijdstip volgens de Gregoriaanse kalender, tot op de milliseconde nauwkeurig.

Toelichting

Het domein DatumTijd definieert een volledige datum met tijdstip, bestaande uit een dag, een maand, een jaar, een uur, een minuut, een seconde. en de tijdzone. De uren van de dag worden gespecificeerd op basis van een 24 uur indeling van de dag. Waar gespecificeerd kunnen onderdelen van een seconde worden opgenomen in het domein.

Waardeverzameling JJJJ-MM- Jaar-maandDDTUU:MM:SS.SSS+U dagTuur:minuut:seconde.deelseconde+ U:MM tijdzone

Naam domein

FoutenInformatie


Het foutenblok bevat: - Regelnummer registratiebrondocument - Attribuut registratiebrondocument - Reden afwijzing In het geval van een correctie mogen alle waardes uit de

Pagina 33 van 36


waardeverzameling worden gebruikt. In het geval van registratie mag enkel de volgende waarde niet worden gebruikt: “ is niet aanwezig in de BRO”

Waardeverzameling

“ is een verplicht veld” “ heeft niet het juiste formaat” “ heeft niet een toegestane waarde” “ heeft een minimale waarde van <waarde>” “ heeft een maximale waarde van <waarde>” “ is niet aanwezig in de BRO”

Naam domein

Identificatie

Definitie

Unieke aanduiding van een instantie die gebruikt wordt om toegang te verkrijgen tot het systeem BRO.

Toelichting Waardeverzameling

Naam domein

00000003[KVKnummer][0000][LO11]

Kwaliteitsregime

Waardeverzameling IMBRO IMBRO IMBRO/A IMBRO/A

Naam domein

ObjectIdentificatie

Definitie

Unieke aanduiding van een object, opgebouwd uit een drieletterige code voor het type registratieobject en een voor dat type registratieobject uniek getal.

Regels

Het bro-id bestaat uit een

Pagina 34 van 36


drieletterige code, gevolgd door 12 cijfers. Dit geheel vormt een uniek ID binnen de BRO. Waardeverzameling CPTNNNNNNNNNNNN Code voor geotechnisch sondeeronderzoek (CPT = Cone Penetration Test), gevolgd door 12 cijfers.

Naam domein

TekstN

Definitie

Een reeks alfanumerieke waarden met lengte N.

Regels

Toegestaan zijn karakters volgens UNICODE/UTF-8 met een beperking tot de tekenset MES-1. In toevoeging daarop worden leestekens als spaties en nieuwe regels wel toegestaan.

Waardeverzameling N Aantal karakters

Naam domein

Transacties

Waardeverzameling

registratie correctie

Pagina 35 van 36


5

Aanbieden via het loket

Pagina 36 van 36

Basisregistratie ondergrond (BRO) Innamehandboek

Recommend Documents