Skip to main content
Skip table of contents

Uitgiftehandboek CPT


1. Inleiding

1.1. Doel en doelgroep uitgiftehandboek

In de basisregistratie ondergrond (BRO) wordt een aantal typen gegevens geregistreerd, de registratieobjecten. Een van de registratieobjecten is geotechnisch sondeeronderzoek.
Het uitgiftehandboek richt zich op de partijen die geotechnisch sondeeronderzoek van de BRO willen opvragen en beschrijft hoe het proces van gegevensuitgifte globaal verloopt.
Het doel is de afnemers van gegevens, de data-afnemers, 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 afnemer 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.

De catalogus beschrijft de gegevensinhoud van een registratieobject en vormt de basis voor de andere beschrijvende documenten. In de catalogus staan de definities van de gegevens en alle regels waaraan zij moeten voldoen.
Een handboek voor inname of uitgifte beschrijft het proces dat bij inname of uitgifte van gegevens wordt doorlopen (dit document).
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.
Deze documenten hangen samen zoals hieronder afgebeeld.


Figuur 1: Samenhang van de documentatie.

1.3. Leeswijzer

Hoofdstuk 1 geeft het doel en de doelgroep, de samenhang met andere documenten en de versiehistorie van dit uitgiftehandboek.
Hoofdstuk 2 geeft een inleiding op de uitgifte van gegevens uit de basisregistratie ondergrond.
Hoofdstuk 3 gaat in op de berichten die bij het gebruik van de webservice worden uitgewisseld. Het hoofdstuk vertelt welke gegevens een data-afnemer moet meesturen met zijn verzoek en welke gegevens hij terug kan verwachten als antwoord.
Hoofdstuk 4 geeft een specificatie van de berichten die worden uitgewisseld bij gebruik van de webservice inclusief de gegevens die de afnemer krijgt.

1.4. Versiehistorie

Versie

Datum

Omschrijving

1.0

28 juni 2017

Versie vastgesteld door het ministerie van Infrastructuur en Milieu.

1.1

december 2017

Aangepast op de BRO-keten (Project Start Architectuur versie 1.0)

1.1.1

januari 2019

Aangepast contactgegevens BRO servicedesk

1.5. Contactinformatie

Voor vragen, suggesties of opmerkingen over de inhoud van dit document kunt u contact opnemen met de BRO Servicedesk. Bel 088 – 8644 999 of mail naar support@broservicedesk.nl.

 Verder vindt u op basisregistratieondergrond.nl verdere technisch inhoudelijke instructie voor het aanleveren van gegevens aan de landelijke voorziening BRO.

2. Uitgifte van gegevens

2.1. Uitgiftewebservice

De gebruiker die via de webservice gegevens opvraagt krijgt de gegevens onmiddellijk geleverd. Maar om de webservice te kunnen gebruiken moet hij wel over software beschikken die de webservice kan aanroepen en moet hij zich als data-afnemer bij de BRO laten registreren. De eis die daarbij wordt gesteld is dat de organisatie waar hij werkt beschikt over een PKIoverheid services server certificaat. Dat certificaat is een soort digitaal paspoort, het legitimatiebewijs van het softwaresysteem van de gebruiker.
Opvragen van gegevens via de uitgiftewebservice is snel, betrouwbaar en elementair. Dat laatste betekent in de eerste plaats dat er voor ieder type registratieobject een aparte webservice is. Wil men gegevens van meer dan een type opvragen, dan moet men verschillende webservices gebruiken. Verder heeft de gebruiker beperkte keuzevrijheid. Hij kan of alle gegevens van een enkel registratieobject opvragen of een beperkte selectie van gegevens van een aantal registratieobjecten tegelijk. De reden daarachter is dat een webservice alleen in algemene gebruikerswensen voorziet. De eigen software van de data-afnemer moet zo zijn ingericht dat de webservice wordt aangeroepen op een manier die aansluit op de eigen bedrijfsprocessen.
Het proces van uitgifte is bij het gebruik van de webservice strikt geformaliseerd. De webservice verzorgt de communicatie tussen twee softwaresystemen en om te borgen dat de verwerking van een verzoek automatisch kan verlopen zijn er allerlei controles ingebouwd. Een ander aspect is dat men de gegevens altijd in het IMBRO-XML formaat krijgt.

2.1.1. Communicatie tussen twee systemen

De data-afnemer die voor het opvragen van gegevens van geotechnisch sondeeronderzoek gebruikmaakt van de uitgiftewebservice, gebruikt via zijn eigen systeem algemene BRO-software die via het internet voor iedereen te vinden is.
De webservice zorgt ervoor dat het systeem van de data-afnemer een verzoek tot verzending van geotechnisch sondeeronderzoek aan het BRO-systeem kan aanbieden, zorgt voor de verwerking van het verzoek en geeft het antwoord van de BRO terug aan het systeem van de data-afnemer (Figuur 2). Als alles goed is gegaan bevat het antwoord de opgevraagde gegevens.


Figuur 2: De webservice zorgt voor communicatie tussen twee systemen.

2.1.2. Opties bij opvragen via de webservice

De uitgiftewebservice voorziet in elementaire functionaliteit en die dekt twee gebruikscasussen. De eerste is het geval waarin een gebruiker aanvankelijk niet precies weet welke objecten hij wil hebben en daarom op zoek gaat naar de objecten die aan bepaalde kenmerken voldoen. De tweede casus is het geval waarin de gebruiker weet welke objecten aan zijn kenmerken voldoen en dan kan hij per object alle gegevens opvragen.
De twee opties zijn vertaald in twee verzoeken:

  1. Een verzoek tot verzending van de kengegevens van een aantal geotechnisch sondeeronderzoeken.

De data-afnemer geeft in zijn verzoek de verzameling kenmerken mee waaraan het geotechnisch sondeeronderzoek dat hij zoekt moet voldoen. In antwoord daarop krijgt hij van ieder van de objecten die aan de kenmerken voldoen de gegevens geleverd die het object karakteriseren, met ter identificatie het BRO-ID.

  1. Een verzoek tot verzending van de gegevens van een bepaald geotechnisch sondeeronderzoek.

De data-afnemer geeft in zijn verzoek het BRO-ID van het geotechnisch sondeeronderzoek dat hij wil hebben mee. In antwoord daarop krijgt hij alle gegevens van het object geleverd.
In de volgende paragrafen wordt de verwerking in meer detail beschreven.

2.1.3. Opvragen van kengegevens

Het opvragen van kengegevens verloopt volgens een vaste opeenvolging van stappen. Dit is waar het in het kort op neerkomt:

  1. De data-afnemer stuurt vanuit zijn systeem een verzoek tot verzending van kengegevens. Daarbij geeft hij de kenmerken mee van het geotechnisch sondeeronderzoek waarvan hij gegevens wil krijgen.

  2. Het systeem van de BRO voert een toegangscontrole uit.

  3. Wanneer toegang tot het systeem van de BRO is verkregen, begint de controle van het verzoek en wordt onder meer vastgesteld of het verzoek inhoudelijk aan de gestelde eisen voldoet.

    • Wanneer de inhoudelijke controle fouten oplevert, wordt het verzoek afgewezen en ontvangt het systeem van de data-afnemer een bericht van afwijzing.

  4. Wanneer de inhoudelijke controle geen fouten oplevert en er ook geen technische problemen zijn, verzamelt het systeem van de BRO de kengegevens van de geotechnisch sondeeronderzoeken die aan de meegegeven kenmerken voldoen.

    • Wanneer de verzameling gegevens te groot ( > 2.000) is, wijst het BRO-systeem het verzoek tot verzending alsnog af en ontvangt het systeem van de data-afnemer een bericht van afwijzing.

    • Wanneer de verzameling onder het gestelde maximum ligt stuurt het BRO-systeem de data-afnemer de opgevraagde gegevens in een bericht van verzending.

Het verzoek van de data-afnemer en het antwoord dat de BRO daarop normaliter geeft worden berichten genoemd. In het geval zich technische problemen voordoen, wordt het antwoord een melding genoemd.
De stappen en de bijbehorende berichten worden in het onderstaande plaatje uitgebeeld.


Figuur 3: Verwerking van een verzoek tot verzending van kengegevens.

2.1.4. Opvragen van gegevens

Het opvragen van de gegevens van een geotechnisch sondeeronderzoek verloopt iets anders dan het opvragen van kengegevens. Het verschil met het opvragen van kengegevens is dat er in de vierde stap geen controle op volume hoeft te worden uitgevoerd, aangezien er maar van één geotechnisch sondeeronderzoek gegevens worden opgevraagd.


Figuur 4: Verwerking van een verzoek tot verzending van een geotechnisch sondeeronderzoek.

De berichten die worden uitgewisseld zijn alleen qua inhoud anders dan berichten bij een verzoek tot verzending van kengegevens. Een bijzonderheid is dat bronhouders en data-leveranciers iets meer gegevens geleverd krijgen dan andere afnemers.

3. Opvragen via de webservice: de berichten

3.1. Opvragen van kengegevens

Het opvragen van de kengegevens van een aantal geotechnisch sondeeronderzoeken verloopt op basis van één of meer kenmerken.

3.1.1. Verzoek tot verzending


Het belangrijkste onderdeel van het verzoek tot verzending van kengegevens is de kenmerkenverzameling, dat is het geheel van kenmerken waaraan het geotechnisch sondeeronderzoek dat de afnemer wil krijgen moet voldoen. Door het meegeven van kenmerken kan de data-afnemer de zoekvraag preciseren naar plaats, tijd en aard van het onderzoek.
De kenmerken die de data-afnemer kan kiezen, worden in hoofdstuk 4 gespecificeerd. Het is een keuze uit de gegevens van die in de catalogus voor geotechnisch sondeeronderzoek zijn beschreven, met daarbij aangegeven hoe de waarde moet worden gespecificeerd.
De data-afnemer moet als kenmerk in ieder geval opgeven in welk gebied de locatie van het geotechnisch sondeeronderzoek moet liggen. Dat kenmerk kan hij combineren met een of meer andere kenmerken.
Naast deze kenmerken moet de data-afnemer een verzoekkenmerk meegeven. Dat gegeven kan worden gebruikt in de communicatie met de BRO Servicedesk, bijvoorbeeld als er iets mis is gegaan en de data-afnemer wil over het probleem contact zoeken met de BRO Servicedesk.

3.1.2. Bericht van afwijzing


In de verwerking van het verzoek zijn allerlei controles ingebouwd. Als er in technische zin iets mis gaat, krijgt de data-afnemer een melding. Een bericht van afwijzing krijgt hij als antwoord, wanneer bij de controles blijkt dat zich een probleem voordoet dat bij het invoeren van gegevens moet worden opgelost.
Het bericht van afwijzing bevat het tijdstip van afwijzing en het verzoekkenmerk van de data-afnemer, maar het belangrijkste onderdeel is de reden afwijzing. De reden waarom het verzoek is afgewezen hangt af van de aard van het probleem. Het probleem kan zijn dat er een fout zit in de gegevens die de data-afnemer heeft meegegeven, maar het kan ook zijn dat bij het verzamelen van gegevens blijkt dat het maximum aantal registratieobjecten wordt overschreden.

Figuur 5: Twee controles kunnen leiden tot een bericht van afwijzing.
Fouten in de gegevens die de data-afnemer heeft meegegeven worden in het bericht zo omschreven dat de afnemer direct kan zien waar de fout zit en wat de fout inhoudt.
Het bericht van afwijzing dat gestuurd wordt na de tweede controle heeft een eenvoudige boodschap. Het aantal objecten waarvan kengegevens worden geleverd is beperkt tot 2.000. De foutmelding geeft in dit geval alleen aan dat het maximum is overschreden.

3.1.3. Bericht van verzending


Het belangrijkste onderdeel van het bericht van verzending zijn de uitgiftedocumenten. Ieder uitgiftedocument bevat de kengegevens van een geotechnisch sondeeronderzoek dat de gewenste kenmerken heeft. Het bericht bevat verder het tijdstip van uitgifte, het verzoekkenmerk van de data-afnemer en de vermelding van het aantal uitgiftedocumenten. Er worden maximaal 2.000 uitgiftedocumenten verzonden.
De lijst met kengegevens die standaard worden uitgegeven wordt gespecificeerd in hoofdstuk 4.
Er is één uitzondering op de standaardlijst en dat is als een registratieobject door de registerbeheerder uit registratie is genomen. Dat geval doet zich bijvoorbeeld voor als een object ten onrechte is opgenomen in de registratie en de registerbeheerder, na onderzoek en overleg met de bronhouder, van die laatste het akkoord heeft gekregen het object uit registratie te nemen. In dat uitzonderlijke geval ontvangt de data-afnemer een bijzonder type uitgiftedocument dat enkel de volgende gegevens over het betreffende registratieobject bevat:

Entiteit

Attribuut

Geotechnisch sondeeronderzoek

BRO-ID

Registratiegeschiedenis

uit registratie genomen


tijdstip uit registratie genomen

Tot slot kan het voorkomen dat er geen enkel registratieobject bestaat dat aan de kenmerken voldoet die zijn meegegeven. Dan ontvangt de data-afnemer wel een bericht van verzending, maar worden er geen uitgiftedocumenten meegeleverd.

3.2. Opvragen van gegevens

Het opvragen van de gegevens van een geotechnisch sondeeronderzoek verloopt op basis van het BRO-ID.

3.2.1. Verzoek tot verzending


Het verzoek tot verzending van de gegevens van een geotechnisch sondeeronderzoek bestaat uit slechts twee gegevens. Het verzoekkenmerk en het BRO-ID van het geotechnisch sondeeronderzoek dat de data-afnemer wil krijgen.

3.2.2. Bericht van afwijzing


Een bericht van afwijzing wordt bij dit type verzoek alleen gestuurd als de BRO een fout in het verzoek zelf heeft geconstateerd, dus wanneer er bij het invoeren van het verzoekkenmerk of het BRO-ID iets mis is gegaan. De controle is eenvoudig: de twee gegevens moeten aan de specificaties (zie hoofdstuk 4) voldoen. Ook wanneer de data-afnemer per ongeluk een BRO-ID heeft opgegeven dat niet bestaat, stuurt de BRO een bericht van afwijzing als antwoord.

3.2.3. Bericht van verzending



Het bericht van verzending bevat maar een uitgiftedocument en dat bevat de gegevens van het opgevraagde geotechnisch sondeeronderzoek. Verder bevat het bericht de verwijzing naar het verzoek tot verzending en het tijdstip waarop de gegevens zijn verzonden.
Welke gegevens er precies in het uitgiftedocument zitten hangt ervan af of de data-afnemer ook de bronhouder of de data-leverancier van het betreffende geotechnisch sondeeronderzoek is. Die twee partijen krijgen alle gegevens van het registratieobject geleverd. Dat geldt zelfs in het uitzonderlijke geval dat het registratieobject door de registerbeheerder uit registratie is genomen.
De andere data-afnemers krijgen alle gegevens op vijf na. De vijf gegevens die ze niet geleverd krijgen zijn:

Entiteit

Attribuut

Geotechnisch sondeeronderzoek

object-ID bronhouder


dataleverancier


uitvoerder onderzoek

Aangeleverde locatie

uitvoerder locatiebepaling

Aangeleverde verticale positie

uitvoerder verticale positiebepaling

In het uitzonderlijke geval dat het registratieobject uit registratie is genomen, krijgen de andere data-afnemers, zijnde niet bronhouder of de data-leverancier, een ander type uitgiftedocument dat alleen de volgende gegevens bevat:

Entiteit

Attribuut

Geotechnisch sondeeronderzoek

BRO-ID

Registratiegeschiedenis

uit registratie genomen


tijdstip uit registratie genomen

3.3. Meldingen

Een melding is het antwoord dat de BRO stuurt wanneer er op technisch vlak iets mis is gegaan. Meldingen zijn in eerste instantie bedoeld voor programmeurs. Om die reden worden de meldingen uitgebreid behandeld in de koppelvlakbeschrijving; hier wordt alleen achtergrondinformatie gegeven.
De oorzaak van een technisch probleem kan variëren en er worden drie categorieën meldingen onderscheiden:

  • melding van een probleem bij de toegangscontrole,

  • melding van een probleem in de software van de data-afnemer,

  • melding van een systeemfout.


Toegangscontrole houdt in dat het systeem van de BRO controleert of de data-afnemer daadwerkelijk is wie hij beweert te zijn en of hij het recht heeft gebruik te maken van de uitgiftewebservice. Het optreden van een probleem bij de toegangscontrole is uitzonderlijk en het zal zich eigenlijk alleen voordoen wanneer een data-afnemer voor het eerst gebruik wil maken van de webservice.
Problemen in de software van de data-afnemer kunnen
vaker optreden, maar ook deze zullen zich in eerste instantie met name openbaren in de fase waarin de data-afnemer bezig is zijn software geschikt te maken voor aansluiting op de BRO.
Systeemfouten doen zich voor wanneer er problemen zijn met de software van de BRO of wanneer zich onvoorziene omstandigheden voordoen, bijvoorbeeld als de stroomtoevoer hapert.

4. Specificatie van de berichten bij gebruik van de webservice

4.1. Inleiding

In dit hoofdstuk worden de gegevens beschreven die bij uitgifte worden uitgewisseld tussen het systeem van de data-afnemer en het BRO-systeem. De systematiek van de beschrijving is dezelfde als in de catalogus.
De berichten worden beschreven op basis van een model dat de vorm heeft van een UML-diagram. Na de berichten worden de domeinen behandeld die specifiek zijn voor de berichten. Aan het eind van het hoofdstuk worden de UML-modellen van de verschillende typen uitgiftedocumenten gegeven.
Het handboek is een aanvulling op de catalogus en om die reden wordt een gegeven alleen gedefinieerd als het niet in de catalogus is opgenomen of wanneer er bijzondere regels gelden. Als alleen de kardinaliteit van een gegeven afwijkt van die in de catalogus, is dat geen reden geweest het hier op te nemen. Delen van de definitie van een gegeven die ongewijzigd zijn ten opzichte van de catalogus zijn grijs gemaakt. Nieuwe gegevens die voorkomen bij meerdere berichten worden eenmalig gedefinieerd. In lijn daarmee worden aan het eind van het hoofdstuk de domeinen behandeld die specifiek zijn voor de berichten.

4.2. Berichten

4.2.1. Verzoek tot verzending kengegevens


verzoekkenmerk

Naam attribuut

verzoekkenmerk

Definitie

Het kenmerk dat de gebruiker, in dit geval de data-afnemer, meegeeft om het verzoek te identificeren.

Kardinaliteit

1

Domein

Tekst

Maximale lengte

200



Kenmerkenverzameling


Naam entiteit

Kenmerkenverzameling

Definitie

Het geheel van kenmerken waaraan een geotechnisch sondeeronderzoek dat de gebruiker opvraagt moet voldoen.

Kardinaliteit

1

Toelichting

Bijna alle gegevens die als kenmerk gebruikt worden zijn gedefinieerd in de catalogus met als enige verschil dat de kardinaliteit 0..1 is omdat de gebruiker vrijheid van keuze heeft.

periode van registratie


Naam attribuut

periode van registratie

Definitie

Het datuminterval waarbinnen de registratiedatum van het geotechnisch sondeeronderzoek ligt

Kardinaliteit

0..1

Domein

Datuminterval

Waardebereik

1 januari 2017 tot datum van uitgifte



periode van correctie


Naam attribuut

periode van correctie

Definitie

Het datuminterval waarbinnen het laatste correctietijdstip van het geotechnisch sondeeronderzoek ligt.

Kardinaliteit

0..1

Domein

Datuminterval

Waardebereik

1 januari 2017 tot datum van uitgifte

periode van rapportage


Naam attribuut

periode van rapportage

Definitie

Het datuminterval waarbinnen de rapportagedatum van het onderzoek ligt.

Kardinaliteit

0..1

Domein

Datuminterval

Waardebereik

1 januari 1950 tot datum van uitgifte



diepteinterval


Naam attribuut

diepteinterval  

Definitie

Het bereik waarbinnen de diepte ligt waarop het sondeonderzoek is beëindigd.

Kardinaliteit

0..1

Domein

Getalswaardeinterval

  Maximale lengte

3

Eenheid

m (meter)

Waardebereik

0 tot 200



periode van veldwerk


Naam attribuut

periode van veldwerk  

Definitie

Het datuminterval waarbinnen de starttijd van de conuspenetratietest ligt.

Kardinaliteit

0..1

Domein

Datuminterval

Waardebereik

1 januari 1930 tot datum van uitgifte



Gebied  


Naam entiteit

Gebied  

Definitie

De geografische begrenzing waarbinnen de locatie van een geotechnisch sondeeronderzoek ligt.

Kardinaliteit

1

Regels

Een gebied bestaat uit een omsluitende rechthoek of een omsluitende cirkel.



omsluitende rechthoek  


Naam attribuut

omsluitende rechthoek  

Definitie

Een gebied dat omsloten wordt door een rechthoek.

Kardinaliteit

0..1

Domein

Rechthoek

Zuidwestelijk hoekpunt

Coördinatenpaar voor ETRS89 (φ,λ)

Noordoostelijk hoekpunt

Coördinatenpaar voor ETRS89 (φ,λ)



omsluitende cirkel  


Naam attribuut

omsluitende cirkel  

Definitie

Een gebied dat omsloten wordt door een cirkel.

Kardinaliteit

0..1

Domein

Cirkel

Middelpunt

Coördinatenpaar voor ETRS89 (φ,λ)

Straal

Rationaal getal


Maximale lengte: 2.3


Eenheid: km (kilometer)


Waardebereik: 0 tot 10

4.2.2. Verzoek tot verzending gegevens

4.2.3. Bericht van afwijzing

tijdstip van afwijzing


Naam attribuut

tijdstip van afwijzing

Definitie

De datum en het tijdstip waarop een verzoek door de BRO is afgewezen.

Kardinaliteit

1

Domein

DatumTijd



reden afwijzing


Naam attribuut

reden afwijzing

Definitie

De omschrijving van de reden waarom het verzoek door de BRO is afgewezen.

Kardinaliteit

1

Domein

RedenAfwijzing

Type

Codelijst



Foutenoverzicht


Naam entiteit

Foutenoverzicht

Definitie

De omschrijving van alle fout(en) die in de kenmerkenverzameling zijn gevonden.

Kardinaliteit

0..1

Regels

Het gegeven kan alleen voorkomen als de reden van afwijzing de waarde heeft er zijn 1 of meer fouten geconstateerd in de kenmerkenverzameling.

Toelichting

Het gegeven wordt door de BRO geproduceerd.



volgnummer


Naam attribuut

volgnummer

Definitie

Het volgnummer van een fout in de kenmerkenverzameling.

Kardinaliteit

1..99

Domein

Nummer

  Maximale lengte

2



kenmerkfout


Naam attribuut

kenmerkfout

Definitie

De omschrijving van een fout in de kenmerkenverzameling.

Kardinaliteit

1..99

Domein

Kenmerkfout

  Type

Codelijst

4.2.4. Bericht van verzending kengegevens


tijdstip van uitgifte


Naam attribuut

tijdstip van uitgifte  

Definitie

De datum en het tijdstip waarop het bericht door de BRO is verstuurd.

Kardinaliteit

1

Domein

DatumTijd



uitgiftedocumenttype


Naam attribuut

uitgiftedocumenttype

Definitie

De aanduiding van het type document dat de afnemer wordt toegezonden in antwoord op zijn verzoek.

Kardinaliteit

0..2

Domein

Uitgiftedocumenttype

Type

Codelijst



aantal documenten


Naam attribuut

aantal documenten  

Definitie

Het aantal uitgiftedocumenten dat in het bericht zit.

Kardinaliteit

1

Domein

Aantal

Maximale lengte

4

Waardebereik

0 tot 2.000





4.2.5. Bericht van verzending gegevens

uitgiftedocumenttype


Naam attribuut

uitgiftedocumenttype

Definitie

De aanduiding van het type document dat de afnemer wordt toegezonden in antwoord op zijn verzoek.

Kardinaliteit

1

Domein

Uitgiftedocumenttype

Type

Codelijst

4.3. Specifieke domeinen voor uitgifte

4.3.1. Rechthoek

Het domein van het type rechthoek wordt gebruikt voor een gebied op aarde dat als een rechthoek wordt voorgesteld. De rechthoek wordt gedefinieerd door twee punten die op het aardoppervlak liggen. Dat zijn in deze volgorde het punt dat de zuidwesthoek, resp. de noordoosthoek vertegenwoordigt. Ieder van de punten wordt uitgedrukt in het domein Coördinatenpaar (zie de catalogus) met als referentiestelsel ETRS89 (ongeprojecteerd).
Het coördinatenpaar voor ETRS89 (φ,λ) is als volgt gedefinieerd:
Getalswaarde 2.9
Eenheid ° (graden, decimaal) Bereik φ tussen 50.6 en 56
Bereik λ tussen 2.4 en 7.4

4.3.2. Cirkel

Het domein van het type cirkel wordt gebruikt voor een gebied op aarde dat als een cirkel wordt voorgesteld en wordt gedefinieerd door een middelpunt en een straal. Het middelpunt is een punt op het aardoppervlak en wordt uitgedrukt in het domein Coördinatenpaar (zie de catalogus) met als referentiestelsel ETRS89 (ongeprojecteerd).
De straal is de geodetische afstand van het middelpunt tot een punt op de cirkel en wordt uitgedrukt als een getalswaarde (zie de catalogus).

4.3.3. Getalswaardeinterval

Een domein van het type getalswaardeinterval omvat een bepaald deel van een bepaalde verzameling getallen. Binnen de BRO zijn drie verzamelingen getallen van belang de natuurlijke, de gehele, en de rationale getallen. Het getalswaardeinterval kent een onder- en een bovengrens en ook de beide grensgetallen maken deel uit van de verzameling.
Een domein van het type getalswaardeinterval wordt in de BRO gebruikt voor gegevens die gemeten, berekend of anderszins bepaald zijn. Bij de getalswaarde hoort daarom een eenheid. De BRO gebruikt voor de eenheden de codes uit het UCUM (Unified Code for Units of Measure)-systeem. In bijzondere gevallen is de eenheid dimensieloos.
Wanneer een attribuut een domein van het type getalswaardinterval heeft worden de minimale waarde voor de ondergrens (minimum) en de maximale waarde voor de bovengrens van het interval (maximum) opgegeven, wordt gespecificeerd of het gehele of rationale getallen betreft, en wordt de eenheid waarop de getalswaarden betrekking hebben opgegeven.

4.3.4. Datuminterval

Het datuminterval is een van de drie domeinen die voor gegevens die over een interval in de tijd, een periode, gaan. Het domein wordt gebruikt voor een periode die tot op de dag nauwkeurig begrensd is. Het domein datuminterval bestaat uit een begindatum en een einddatum, beide van het domeintype Datum (JJJJ-MM-DD, zie de catalogus).
De basisregistratie ondergrond hanteert de volgende praktische regels:

  • Het begin ligt voor het einde of valt daarmee samen.

  • Het waardebereik is inclusief en omvat de begin- en de einddatum

  • Een aanvullende regel is nodig om aan te geven wanneer een temporeel gegeven uit het domein OnvolledigeDatum in het interval ligt, en wanneer niet. Om die regel te formuleren wordt een OnvolledigeDatum beschouwd als een interval.

    • Een OnvolledigeDatum valt alleen binnen het bereik van een datuminterval wanneer het interval in zijn geheel binnen het datuminterval valt (of daarmee samenvalt).

    • Gegevens met de waarde onbekend worden niet uitgegeven o.b.v. een datuminterval.

4.3.5. Kenmerkfout

Een waarde in de lijst is een zin met een bepaalde opbouw en met zowel vaste als variabele bestanddelen. De variabele bestanddelen gegeven aan waar de fout in de kenmerkenverzameling zit en eventueel waarom het een fout is.
Een eerste variabel element is <gegeven>. Dat geeft aan welk gegeven onjuist is. Wanneer het gaat om een onjuiste waarde wordt met het gegeven ook de waarde van het gegeven opgenomen (<gegeven = waarde>).
Een tweede variabel element is <referentiegegeven> en dat wordt opgenomen wanneer er een tweede gegeven is dat bepaalt dat het <gegeven> fout is. Zo nodig wordt ook hier de waarde meegegeven -+(<referentiegegeven = waarde>).
Een derde variabel element is <referentiewaarde> en dat wordt opgenomen wanneer een waardebereik bepaalt dat het <gegeven> fout is.

GEGEVEN ONTBREEKT

<gegeven> ontbreekt: het moet aanwezig zijn als <referentiegegeven> ontbreekt.

GEGEVEN MAG NIET AANWEZIG ZIJN

<gegeven> mag niet aanwezig zijn: als <referentiegegeven> ontbreekt.

<gegeven> mag niet aanwezig zijn: als <referentiegegeven> aanwezig is.

WAARDE ONTBREEKT

<gegeven> waarde ontbreekt.

WAARDE HEEFT GEEN CORRECT FORMAAT

<gegeven = waarde> waarde heeft geen correct formaat: moet zijn <referentiewaarde>.

WAARDE IS NIET CORRECT

<gegeven = waarde> waarde is niet correct: komt niet voor in de codelijst.

<gegeven = waarde> waarde is niet correct: moet gelijk zijn aan <referentiewaarde>.

<gegeven = waarde> waarde is niet correct: zuidwesthoek ligt niet goed t.o.v. de noordoosthoek.

<gegeven = waarde> waarde is niet correct: mag niet kleiner zijn dan <referentiegegeven = waarde>.

<gegeven = waarde> waarde is niet correct: mag niet kleiner zijn dan <referentiewaarde>.

<gegeven = waarde> waarde is niet correct: mag niet groter zijn dan <referentiewaarde>.

<gegeven = waarde> waarde is niet correct: is niet toegestaan in combinatie met <referentiegegeven = waarde>.

<gegeven = waarde> waarde is niet correct: mag niet voor <referentiegegeven = waarde> liggen.

<gegeven = waarde> waarde is niet correct: mag niet voor <referentiewaarde> liggen.

<gegeven = waarde> waarde is niet correct: mag niet in de toekomst liggen.

4.3.6. RedenAfwijzing

Net als bij het domein Kenmerkfout is een waarde een zin met een bepaalde opbouw die vaste en variabele bestanddelen heeft.

<gegeven> waarde ontbreekt.

<gegeven = waarde> waarde heeft geen correct formaat: moet zijn <referentiewaarde>.

<gegeven = waarde> waarde heeft geen correct formaat: voldoet niet aan de MES 1 karakterset.

dit registratieobject bestaat niet.

er zijn 1 of meer fouten geconstateerd in de kenmerkenverzameling.

het aantal uitgiftedocumenten is groter dan 2.000. Pas de kenmerken van uw verzoek tot verzending kengegevens aan.

4.3.7. Uitgiftedocumenttype

Waarde

Omschrijving

BRO-DO

Het uitgiftedocument dat de gegevens van een object dat uit registratie is genomen bevat.

CPT-C

Het uitgiftedocument dat de kengegevens van een geotechnisch sondeeronderzoek dat niet uit registratie is genomen bevat.

CPT-O

Het uitgiftedocument dat de gegevens van een geotechnisch sondeeronderzoek dat niet uit registratie is genomen bevat die voor een standaard afnemer beschikbaar zijn.

CPT-O-DP

Het uitgiftedocument dat de gegevens van een geotechnisch sondeeronderzoek bevat die voor dataleverancier en bronhouder beschikbaar zijn.

4.4. Uitgiftedocumenten

4.4.1. CPT-C

4.4.2. CPT-O

4.4.3. CPT-O-DP

Het verschil met CPT-O is dat CPT-O-DP de volgende gegevens bevat:

Entiteit

Attribuut

Geotechnisch sondeeronderzoek

object-ID bronhouder


dataleverancier


uitvoerder onderzoek

Aangeleverde locatie

uitvoerder locatiebepaling

Aangeleverde verticale positie

uitvoerder verticale positiebepaling

4.4.4. BRO-DO


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.