Skip to main content
Skip table of contents

GAR Berichtencatalogus innamewebservice




1. Inleiding

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

Het document veronderstelt dat de lezer bekend is met de GAR catalogus 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 catalogus. Vervolgstappen, zoals het valideren (testen), aanbieden en verwerken van een BRO-verzoek, staan beschreven in het Bronhouderportaal (zie www.basisregistratieondergrond.nl).

1.1. Leeswijzer

Hoofdstuk 2 beschrijft de algemene opbouw van een BRO-verzoek.

Hoofdstuk 3 bevat enkele voorbeeldberichten met regel voor regel een toelichting.

Hoofdstuk 4 bevat de toegestane waarden van de enumeraties (niet-beheerde lijsten met toegestane waarden).

Hoofdstuk 5 bevat verwijzingen (URN's en URL's) naar de codelijsten (beheerde lijsten met toegestane waarden).

Hoofdstuk 6 bevat een vertaaltabel, aan de hand waarvan, gegeven de Engelstalige naam van een entiteit of een attribuut, de Nederlandse naam in de catalogus kan worden opgezocht.

1.2. Versiehistorie

Versie

Datum

Omschrijving

1.0.0

18-12-2019

Eerste versie.

1.0.1

09-01-2020

GMW_MonitoringTube vervangen door GroundwaterMonitoringTube.

1.0.2

18-02-2020

Issue #160: Type van analysisMeasurementValue gewijzigd van gml:MeasureType in brocom:MeasureNillableType.

1.1.0

17-12-2020

Werkafspraak: koppeling met Grondwatermonitoringnet mag later ingevuld worden d.m.v. correctiebericht.

1.1.1

23-12-2020

Verwijzing naar (test-)voorbeeldberichten op BRO productomgeving

1.1.2

17-02-2021

Links in de tabel met codelijsten aangepast

1.1.3

11-03-2021

Beschrijving van aanleveren van het gegeven dataleverancier aangepast.

1.1.4

24-03-2021

Hoofdstuk 3 Voorbeeldberichten: herschreven.

1.1.5

26-03-2021

Verwijzing naar pagina met generieke beschrijving van de codelijst CorrectionReason.

1.1.6

29-03-2021

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

1.1.7

26-06-2023

Aanpassingen n.a.v. herziene voorbeeldberichten i.r.t. demo omgeving.
Spelfout 'attribut', beschrijving (analyse)parameter '6024', andere inhoud correctionRequest (andere bro-id's & kvks uitvoerders)

1.3. 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.

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

2. BRO-verzoek

Dit hoofdstuk beschrijft de algemene opbouw van een BRO-verzoek. Een BRO-verzoek bestaat uit een brondocument verpakt in een 'request'. Paragraaf 2.1 beschrijft de verschillende requests van de GAR innamewebservice. Paragraaf 2.2 beschrijft de verschillende brondocumenten die in een GAR requests opgenomen kunnen worden. 

2.1. Requests

Om gegevens te registreren in de Landelijke Voorziening BRO (LV BRO) moet u deze aanleveren bij het Bronhouderportaal in de vorm van een BRO-verzoek (zie basisregistratieondergrond.nl).

Vervolgens is het BRO-verzoek het bestand in IMBRO/XML-formaat dat het BRO-brondocument bevat en als verzoek wordt aangeboden in het Bronhouderportaal.


De GAR innamewebservice ondersteunt twee soorten requests.  Zie onderstaande tabel.

Naam in XML-bestand

Nederlandse naam

Omschrijving

registrationRequest

registratieverzoek

Met dit verzoek kan een bronhouder en/of dataleverancier nieuwe gegevens overdragen aan de BRO (registreren).

correctionRequest

correctieverzoek

Met dit verzoek kan een bronhouder en/of dataleverancier in de BRO opgenomen gegevens vervangen (corrigeren).


Paragraaf 2.1.1 beschrijft in detail de opbouw van een registrationRequest. Paragraaf 2.1.2 beschrijft op dezelfde manier een correctionRequest.

2.1.1. RegistrationRequest

Met een  registrationRequest (registratieverzoek) wordt een nieuw registratieobject toegevoegd aan de BRO. Het grondwatersamenstellingsonderzoek is een registratieobject zonder geschiedenis en het registreren is een eenmalige gebeurtenis.

Een registrationRequest (registratieverzoek) bestaat uit enkele transactiegegevens en een brondocument.  De definities van de transactiegegevens staan in onderstaande tabel:

Een registrationRequest (registratieverzoek) bestaat uit enkele transactiegegevens en een brondocument. De definities van de transactiegegevens staan in onderstaande tabel:

Naam in XML-bestand

Nederlandse naam

Type

Kardinaliteit

Definitie

requestReference 

verzoekkenmerk

CharacterString

1..1

Een voor de dataleverancier unieke aanduiding van het  innameverzoek.

deliveryAccountableParty 

bronhouder

ChamberOfCommerceNumber

0..1

Het KvK-nummer van de bronhouder.

Regels:
Dit element mag niet aanwezig zijn als de dataleverancier tevens bronhouder is.
Dit element moet aanwezig zijn als de dataleverancier niet de bronhouder is.

qualityRegime 

kwaliteitsregime

QualityRegime 

1..1

De aanduiding van het kwaliteitsregime waaraan de gegevens in het brondocument voldoen.

Regels:
Toegestane waarden zijn IMBRO en IMBRO/A.

Toelichting:
De catalogus geeft aan wat de gevolgen van een waarde voor het kwaliteitsregime zijn op de kardinaliteit, het domein en de bedrijfsregels van de gegevensinhoud van een brondocument.

sourceDocument

brondocument

GAR

1..1

Dit element bevat één van de gedefineerde brondocumenten.

Toelichting:
Het brondocument bevat de gegevens die in de BRO opgenomen moeten worden.
De gegevens in het brondocument zijn gespecificeerd in de catalogus.
Zie paragraaf 2.3 voor nadere informatie.


2.1.2. CorrectionRequest

Met een correctionRequest (correctieverzoek) kan de dataleverancier een registratieobject in één keer corrigeren. Het is niet mogelijk een deel van een GAR registratieobject te corrigeren.

Een correctionRequest (correctieverzoek) bestaat uit enkele transactiegegevens en vooral een brondocument. De definities van de transactiegegevens staan in onderstaande tabel :

Naam in XML-bestand

Nederlandse naam

Type

Kardinaliteit

Definitie

requestReference 

verzoekkenmerk

CharacterString

1..1

Een voor de dataleverancier unieke aanduiding van het  innameverzoek.

deliveryAccountableParty 

bronhouder

ChamberOfCommerceNumber

0..1

Het KvK-nummer van de bronhouder.

Regels:
Dit element mag niet aanwezig zijn als de dataleverancier tevens bronhouder is.
Dit element moet aanwezig zijn als de dataleverancier niet de bronhouder is.

broId 

BRO-ID

RegistrationObjectCode

1..1

De unieke aanduiding van een registratieobject, dat is opgenomen in de BRO, waarvan de gegevens vervangen/gecorrigeerd moet worden.

Regels:
Een registratieobject met de opgegeven  broId  (BRO-ID) moet aanwezig zijn in de BRO.

qualityRegime 

kwaliteitsregime

QualityRegime 

1..1

De aanduiding van het kwaliteitsregime waaraan de gegevens in het brondocument voldoen.

Regels:
Toegestane waarden zijn IMBRO en IMBRO/A.

Toelichting:
De catalogus geeft aan wat de gevolgen van een waarde voor het kwaliteitsregime zijn op de kardinaliteit, het domein en de bedrijfsregels van de gegevensinhoud van een brondocument.

correctionReason

correctiereden

CorrectionReason

1..1

Aanduiding voor de reden waarom het registratieobject wordt vervangen/gecorrigeerd.

Regels:
Zie CorrectionReason (Correctiereden) voor de lijst met toegestane waarden, hun betekenis en de aanvullende regels.

sourceDocument

brondocument

GAR

1..1

Dit element bevat één van de gedefineerde brondocumenten.

Toelichting:
Het brondocument bevat de gegevens die  de huidige gegevens in de BRO zullen vervanging.
De gegevens in het brondocument zijn gespecificeerd in de catalogus.
Zie paragraaf 2.3 voor nadere informatie.


2.2. Brondocumenten

Een brondocument bevat de gegevens die geregistreerd worden in de LV BRO. Voor elk registratieobject staat in de bijbehorende catalogus waar die gegevens aan moeten voldoen.

Een brondocument wordt verpakt in een 'request'.  Vervolgens wordt het geheel als een bestand in IMBRO/XML-formaat in de vorm van een BRO-verzoek aangeboden in het Bronhouderportaal.

De GAR innamewebservice kent één type brondocument; zie onderstaande tabel. Met dit brondocument wordt het GAR registratieobject in één keer in zijn geheel vastgelegd of gecorrigeerd. De gegevens in het brondocument zijn gedefinieerd in de catalogus. De catalogus definieert ook gegevens die door het BRO-systeem worden gegenereerd of afgeleid; deze gegevens hoeven niet worden opgenomen in een brondocument.

Naam

GAR

Doel

Het brondocument dat een grondwatersamenstellingsonderzoek in zijn volledigheid beschrijft.

Verwerking in registratie ondergrond

  • registrationRequest:

    • De innamewebservice kent een unieke waarde toe aan de broId  van de entiteit  RegistrationObject.

    • De innamewebservice maakt een entiteit RegistrationHistory  aan met een waarde voor de volgende attributen (de overige, optionele attributen hebben geen waarde):

      • objectRegistrationTime = momentane tijdstip.

      • registrationCompletionTime  = momentane tijdstip.

      • registrationStatus voltooid.

      • corrected = nee.

      • underReview = nee.

      • deregistered= nee.

      • reregistered  = nee.

  • correctionRequest :

    • Een RegistrationObject met de opgegeven broId moet aanwezig zijn in de registratie ondergrond.

    • De innamewebservice wijzigt de waarde van de volgende attributen in de entiteit  RegistrationHistory:

      • corrected = ja.

      • latestCorrectionTime = momentane tijdstip.


De gegevens in het GAR brondocument zijn volledig gedefinieerd in de gegevenscatalogus. Het GAR brondocument bevat alle gegevens uit de gegevenscatalogus met uitzondering van de volgende gegevens:

  • Attribuut  broId  (BRO-ID). Deze wordt niet opgenomen in het brondocument maar in het BRO-verzoek, behalve bij het registrationRequest  (registratieverzoek) want dan genereert de BRO een waarde voor dit gegeven.

  • Attribuut  deliveryAccountableParty  (bronhouder). Deze wordt niet opgenomen in het brondocument maar in het BRO-verzoek.

  • Attribuut deliveryResponsibleParty  (dataleverancier). Deze wordt niet opgenomen in het brondocument maar in de SOAP header van het bericht.

  • Attribuut  qualityRegime  (kwaliteitsregime). Deze wordt niet opgenomen in het brondocument maar in het BRO-verzoek.

  • Entiteit  RegistrationHistory  (Registratiegeschiedenis), wordt afgeleid door de BRO.

De structuur van een GAR brondocument wordt weergegeven in onderstaande figuur. Het begint met twee attributen objectIdAccountableParty (object-ID bronhouder) en qualityControlMethod (beoordelingsprocedure), een optionele lijst met relaties naar een GroundwaterMonitoringNet (Grondwatermonitoringnet) en één relatie naar een GroundwaterMonitoringTube (GMW-monitoringbuis; een buis in een GroundwaterMonitoringWell (GMW; grondwatermonitoringput)). Daarna volgen twee bomen met gegevens voor het  fieldResearch (veldonderzoek) en het  laboratoryAnalysis (laboratoriumonderzoek).


N.B. In de gegevenscatalogus is de relatie vanuit GAR naar GMN verplicht. In een werkafspraak is besloten dat in eerste instantie, tijdens het registreren van de gegevens over een grondwatersamenstellingsonderzoek met een registrationRequest (registratieverzoek), de koppeling met het GMN achterwege gelaten mag worden (de kardinaliteit is 0..*) en dat deze op een later moment door middel van een correctionRequest (correctieverzoek) alsnog gemaakt wordt.

N.B. De attributen  samplingoperator (uitvoerder veldonderzoek) en responsibleLaboratory (uitvoerder laboratoriumonderzoek) zijn verplicht in het GAR brondocument. Deze attributen hebben een kardinaliteit 0..1 omdat het FieldResearch (Veldonderzoek) en  LaboratoryAnalysis (Laboratoriumonderzoek) gemeenschappelijk gebruikt worden door de innamewebservice en de uitgiftewebservice. In de uitgiftewebservice worden deze attributen niet uitgeleverd als de aanvrager niet de bronhouder en/of dataleverancier is van het uitgegeven registratieobject.

3. Voorbeeldberichten

Dit hoofdstuk bevat enkele voorbeeldberichten en van diverse onderdelen van de berichten een uitgebreide toelichting.

3.1.1. Integrale voorbeeldberichten

De integrale voorbeeldberichten zijn te vinden op <<GMN voorbeeldberichten>>.  De onderstaande tabel bevat een opsomming van beschikbare voorbeeldberichten, hun intentie en een summiere beschrijving van de inhoud.

Naam

Doel en ihoud

registrationRegistration.xml

Gegevens over een nieuw registratieobject registreren in de BRO. 

Inhoud:

  • Transactiegegevens.

  • Brondocument.

    • Algemene gegevens, zonder relaties naar grondwatermeetnetten en één relatie naar een buis in een grondwatermonitoringput.

    • Veldonderzoek.

      • Lege waarde voor de samplingOperator (uitvoerder veldonderzoek)

      • Veldwaarnemingen: alleen de verplichte gegevens.

      • Veldmetingen: 3 metingen, van de parameter codes 1496 (stikstof totaal), 6024 (deuterium oxide (zwaar water)) en 3548 (geleidendheid)

    • 2 laboratoriumonderzoeken

      • Door een onbekend laboratorium (lege waarde voor responsibleLaboratory)

        • 2 toegepaste analyseprocessen:

          • AAS volgens CIW

            • parameter 1270 (nitraat)

            • parameter 441 (cadmium)

          • IR volgens AQUOKIT

            • parameter 1522 (temperatuur)

      • Door het laboratorium met KvK nummer 27376655

        • 1 toegepast analyseprocess:

          • AA volgens DESK

            • parameter 4445 (PFOS)

CorrectionRequest.xml

Correctie van een eerder aangeleverd brondocument.

Inhoud: het hierboven beschreven registrationRequest wordt gecorrigeerd op de volgende punten:

  • objectIdAccountableParty: was Pietje_20181023_QR2 wordt CheckThis.

  • Twee relaties naar grondwatermeetnetten worden toegevoegd.

  • het broId van de monitoringbuis: was GMW000000058869 wordt GMW000000058870.

  • de samplingOperator (uitvoerder veldonderzoek) wordt ingevuld.

  • het laboratorium van het eerste laboratoriumonderzoek wordt ingevuld.

  • de eenheid van de gemeten concentratie PFOS: was ug/ml wordt ug/l.

3.1.2. Code snippets.

Deze paragraaf bevat voor een aantal kleine, bijzondere stukken XML-code uit de voorbeeldberichten een gedetailleerde beschrijving.

3.1.2.1. De kop van een registrationRequest

De eerste regel van het voorbeeldbericht bevat de XML-proloog. Merk op dat de tekens volgens UTF-8 moeten worden gecodeerd. Dit is met name van belang voor speciale tekens, zoals à, á, ï.

Regel 2 t/m 8 bevatten de opening tag van het registrationRequest (registratieverzoek) als root XML-element en de namespaces van de gebruikte XML-schemadefinities (XSD's). De laatste twee XML-attributen (xmlns:xsi en xsi:schemaLocation) maken het mogelijk om het BRO-verzoek te valideren tegen de XSD-bestanden van de innamewebservice. Deze twee attributen mogen worden weggelaten. Regel 2 mag ook de opening tag van een<<correctionRequest (correctieverzoek)>>zijn.

Na de disclaimer volgen vier transactiegegevens: requestReference (verzoekkenmerk), deliveryAccountableParty (bronhouder),  broId  (BRO-ID) en qualityRegime (kwaliteitsregime). Zie hoofdstuk 2 voor nadere informatie. Het attribuut  broID  (BRO-ID) is bij een  registrationRequest  (registratieverzoek) van de GAR innamewebservice niet toegestaan . Bij   een correctionRequest (correctieverzoek) is dit attribuut verplicht.

Na de transactiegegevens volgt de opening tag van het sourceDocument (brondocument). Daarbinnen volgt het aan te bieden brondocument.

Het BRO-verzoek wordt afgesloten met de closing tags van het sourceDocument (brondocument) en het registrationRequest (registratieverzoek) c.q. het<<correctionRequest(correctieverzoek)>>.

CODE
<?xml version="1.0" encoding="UTF-8"?>
<registrationRequest 
        xmlns="http://www.broservices.nl/xsd/isgar/1.0" 
        xmlns:garcom="http://www.broservices.nl/xsd/garcommon/1.0" 
        xmlns:brocom="http://www.broservices.nl/xsd/brocommon/3.0" 
        xmlns:gml="http://www.opengis.net/gml/3.2" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.broservices.nl/xsd/isgar/1.0 https://schema.broservices.nl/xsd/isgar/1.0/isgar-messages.xsd">
	<brocom:requestReference>TestCase1</brocom:requestReference>
    <!--Optional:-->
    <brocom:deliveryAccountableParty>27376655</brocom:deliveryAccountableParty>
    <!--Optional:-->
    <brocom:broId>BHR000000342106</brocom:broId>
	<brocom:qualityRegime>IMBRO/A</brocom:qualityRegime>
	<sourceDocument>
        ...
	</sourceDocument>
</registrationRequest>


3.1.2.2. Brondocument

Een BRO-verzoek bevat een brondocument. Een brondocument is de eenheid van aanleveren. De<<GAR>>innamewebservice kent meerdere types brondocumenten. Alle brondocumenten hebben het stereotype FeatureType.

Conform de  GML XML encoding rules  wordt voor de brondocumenten het property type pattern toegepast. Zie ook de paragraaf Property type pattern.

Onderstaand stukje XML van een voorbeeldbericht laat zien hoe dat uitpakt. Na de opening tag sourceDocument van het brondocument volgt een regel als tag de naam van het type brondocument, bijvoorbeeld GAR. Deze regel geeft aan dat in dit bericht dat type brondocument is opgenomen. Het element GAR is als root element gedefinieerd in het XSD-bestand isgar-messages.xsd van de GAR innamewebservice. Na deze regel komt het eerste XML element van het brondocument.

    ...
     <sourceDocument>
         <GAR gml:id= "id_0001" >
             ...
         </GAR>
    </sourceDocument>
     ...


3.1.2.3. Codelijst

Zie  Codelist (Codelijst)  voor een algemene beschrijving van het gebruik van codelijsten in de BRO.

3.1.2.4. Datum en DatumTijd

De waarde van een XML-element met als type xs:Date  (Datum) wordt gecodeeerd volgens de ISO-8601 standaard: yyyy-mm-dd. Bijvoorbeeld:

<brocom:date> 2019 - 03 - 18 </brocom:date>


De waarde van een XML-element met als type xs:DateTime  (DatumTijd) wordt ook gecodeeerd volgens de ISO-8601 standaard: yyyy-mm-ddThh:mm:ss+hh:mm. Daarbij is de tijdzone (+hh:mm) verplicht. De uren en minuten na het plus teken is de tijdzone ten opzichte van UTC (aka GMT). In theorie kan dit ook een min teken zijn (tijdzones ten westen van Greenwich), maar voor Nederland is de tijdzone + 1 uur (wintertijd) of + 2 uur (zomertijd). In het voorbeeld is de lokale tijd 09:01:52, terwijl het 'in Londen' 08:01:52 is. Bijvoorbeeld:

<brocom:dispatchTime> 2019 - 04 -16T09: 01 : 52 + 01 : 00 </brocom:dispatchTime>


3.1.2.5. gml:id

Conform de  GML XML encoding rules krijgt ieder  ieder XML-element, waarvan het datatype een specialisatie is van gml:AbstractFeatureType, een XML-attribuut gml:id. Zie ook de paragraaf Property type pattern.

De waarde van deze gml:id moet uniek zijn binnen het BRO-verzoek. In de voorbeeldberichten is dit gedaan met een waarde die begint met 'id_', gevolgd door een volgnummer.

Het BRO-systeem negeert het XML-attribuut  gml:id  en slaat de waarde ervan niet op.

3.1.2.6. Meetwaarde

De gegevenscatalogus definieert een aantal gegevens als een meetwaarde. Deze bestaan uit een getalswaarde en een eenheid.

In de XSD-bestanden hebben de betreffende XML-element een type  gml:Measure. Conform de  GML XML encoding rules  wordt de eenheid opgeslagen in het XML-attribuut  uom  (unit of measure; eenheid). Als een gegeven van het type meetwaarde geen waarde heeft, dan wordt er een XML-attribuut  xsi:Nil="true" opgenomen en heeft het XML-element geen waarde. Ook het XML attribuut  uom  (eenheid) wordt dan niet opgenomen. Hierin verschilt GAR van andere registratieobjecten in de BRO. Zie onderstaande voorbeelden voor een meetwaarde met en zonder een waarde.

...
<garcom:fieldMeasurementValue uom="mg/l">5.123</garcom:fieldMeasurementValue >
...
<garcom:fieldMeasurementValue xsi:nil= "true" />
...


Merk op dat in de gegevenscatalogus (in de meeste gevallen) naast de afkorting ook tussen haakjes de voluitgeschreven naam van de eenheid is opgenomen, bijvoorbeeld: Eenheid: m (meter) . Alleen de afkorting volgens de UCUM lijst moet worden opgenomen in het BRO-verzoek.

3.1.2.7. Organisatie

De gegevenscatalogus definieert een aantal uitvoerders. Deze hebben een  Organization  (Organisatie) als gegevenstype.

Het gegevenstype  Organization  (Organisatie) biedt de keuze tussen een kamer van koophandel   nummer of een Europees handelsnummer als identificatie van een organisatie. Hieronder twee voorbeelden:

...
<garcom:samplingOperator>
     <brocom:chamberOfCommerceNumber>52754834 </brocom:chamberOfCommerceNumber>
</garcom:samplingOperator>
...
<garcom:samplingOperator>
     <brocom:europeanCompanyRegistrationNumber>DER2507_R2</brocom:europeanCompanyRegistrationNumber>
</garcom:samplingOperator>
...


3.1.2.8. PartialDate

In de gegevenscatalogus hebben diverse gegevens een Datum onder kwaliteitsregime IMBRO en een OnvolledigeDatum onder IMBRO/A. In de XSD-bestanden is de OnvolledigeDatum gerealiseerd door het complexType  PartialDateType. Deze ondersteunt 4 mogelijkheden met afnemende nauwkeurigheid:

  • date  (volledige datum)

  • yearMonth  (datum en jaartal)

  • year  (jaartal)

  • voidReason  (de vaste waarde 'onbekend').

Bijvoorbeeld:

<garcom:analysisDate>
     <!--You have a CHOICE of the next  4   items at  this   level
     <brocom:date> 2018 -1 0 - 25 </brocom:date>
     <brocom:yearMonth> 2018 -1 0 </brocom:yearMonth>
     <brocom:year> 2018 </brocom:year>
     <brocom:voidReason>onbekend</brocom:voidReason>
     -->
     <brocom:date> 2018 -1 0 - 25 </brocom:date>
</garcom:analysisDate>


Bij een  PartialDate  (OnvolledigeDatum) geldt dat binnen hetzelfde jaar (of jaar en maand) een minder volledige datum voorafgaat aan een meer volledige datum:

  • het jaartal 2015 gaat voor de datum en jaartal juli 2015

  • de datum en jaartal juli 2015  gaat voor de volledige datum 17 juli 2015.

In het algemeen kan een datum met de waarde 'onbekend' niet worden vergeleken met een andere datum. Daarom wordt bij het toepassen van een regel, waarin twee datums met elkaar worden vergeleken waarvan één (of beide) de waarde 'onbekend' heeft, de bedrijfsregel genegeerd.

Uitzondering is het sorteren van gebeurtenissen op een tijdlijn. Daarbij wordt op basis van de betekenis van de gebeurtenis een begin/inrichten/start gebeurtenis altijd vooraan in de lijst met gebeurtenissen geplaatst, ook als de datum van de gebeurtenis de waarde 'onbekend' heeft. En wordt een eind/opruimen/voltooien gebeurtenis altijd achteraan in de lijst met gebeurtenissen geplaatst, ook als de datum van de gebeurtenis de waarde 'onbekend' heeft. Opdat een lijst met gebeurtenissen eenduidig kan worden gesorteerd, mag bij andere gebeurtenissen de datum van de gebeurtenis niet de waarde 'onbekend' hebben. Dit wordt expliciet als aanvullende regel vermeld bij de betreffende brondocumenten.

3.1.2.9. Property type pattern

De GAR gegevenscatalogus maakt een onderscheid tussen objecttypes en gegevensgroeptypes. Bij de opstellen van de berichtdefinities worden deze stereotypes vertaald naar FeatureType en AttributeGroupType. Beide kunnen in software omgezet worden naar classes. Beide hebben attributen (attributes), gegevensgroepen (attributeGroups) of  associations  (relaties) naar andere  Featuretypes  als onderdelen. De verschillen zijn onder meer dat een Feature identificeerbaar is en dat een AttributeGroup alleen bestaat bij de gratie van het Feature waarvan het, direct of indirect, een onderdeel is.

Conform de  GML XML encoding rules  leidt ieder  FeatureType  in een XSD-bestand tot:

  • Een complex type, wat de inhoud van het FeatureType  definieert en direct of indirect een specialisatie is van gml:AbstractFeatureType.

  • Een  root element, zodat objecten van het  ComplexType  geïnstantieerd kunnen worden.

  • Een  property type ComplexType, wat in de XSD-bestanden gebruikt wordt als het type van een element dat fungeert als realisatie van de associatie relatie naar het  FeatureType.

Als gevolg van de eerste bullet krijgt in een XML-bericht ieder XML-element met zo'n  complex type  als datatype een XML-attribuut  gml:id

In een XML bericht heeft dit tot gevolg dat, bij bijvoorbeeld het XML-element monitoringPoint (meetpunt) na de opening tag een tweede tag volgt, in dit geval GroundwaterMonitoringTube (GMW-monitoringbuis) met de naam van het type van het (gerelateerde)  FeatureType  (Objecttype) en een XML-attribuut  gml:id . Daarna volgt de reeks van XML-elementen van het (gerelateerde)  FeatureType  (Objecttype), afgesloten met de closing tag van het (gerelateerde)  FeatureType  (Objecttype) en de closing tag van, in dit voorbeeld, het XML-element monitoringPoint (meetpunt). Daardoor is voor een ontvangend systeem eenduidige bekend is hoe de inhoud geparsed moet worden. Voorbeeld:

CODE
<monitoringPoint>
    <garcom:GroundwaterMonitoringTube gml:id="GMW123456789012_0003">
        ...
    </garcom:GroundwaterMonitoringTube>
</monitoringPoint>


4. Enumeraties

Dit hoofdstuk bevat de toegestane waarden van de enumeraties (niet-beheerde waardenlijsten).

In de BRO wordt een onderscheid gemaakt tussen beheerde waardenlijsten en niet-beheerde waardenlijsten. In de catalogus en de XSD-bestanden noemen we een niet-beheerde waardenlijst een enumeratie. Bij een enumeratie staat de lijst met toegestane waarden vast en kan de lijst met toegestane waarden niet veranderd worden zonder aanpassingen in de catalogus, de berichtdefinities (XSD-bestanden) en de software (voor het maken of verwerken van een bericht).

De onderstaande tabel geeft een overzicht van de enumeraties die van belang zijn bij het maken van een BRO-verzoek over een grondwatersamenstellingsonderzoek. De eerste kolom bevat de Engelstalige naam van de enumeratie, zoals deze voorkomt in de XSD-bestanden. De tweede kolom bevat de Nederlandstalige naam, zoals die voorkomt in de catalogus. De derde kolom bevat de toegestane waarden, die gebruikt mogen worden in een BRO-verzoek.

Type

Naam

Waarde

IndicationYesNo

IndicatieJaNee

ja



nee

IndicationYesNoUnknown

IndicatieJaNeeOnbekend

ja



nee



onbekend

QualityRegime

Kwaliteitsregime

IMBRO



IMBRO/A

5. Codelijsten

Dit hoofdstuk bevat verwijzingen (URN's en URL's) naar de codelijsten (beheerde waardenlijsten). Zie  Codelist (Codelijst)  voor een algemene beschrijving van het gebruik van codelijsten in de BRO.

De onderstaande tabel geeft een overzicht van de codelijsten die van belang zijn bij het maken van een BRO-verzoek over een grondwatersamenstellingsonderzoek. De eerste kolom bevat de Engelstalige naam van de codelijst, zoals deze voorkomt in de XSD-bestanden. De tweede kolom bevat de Nederlandstalige naam, zoals die voorkomt in de catalogus. De derde kolom bevat de URN, die gebruikt moet worden in een BRO-verzoek. De vierde kolom bevat een link naar de website waar de actuele lijst met toegestane waarden is te raadplegen.


Type

Naam

URN

Link

AnalyticalTechnique

Waardebepalingstechniek

urn:bro:gar:AnalyticalTechnique

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:AnalyticalTechnique

Colour

Kleur

urn:bro:gar:Colour

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:Colour

ColourStrength

Kleursterkte

urn:bro:gar:ColourStrength

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:ColourStrength

LimitSymbol

LimietSymbool

urn:bro:gar:LimitSymbol

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:LimitSymbol

ParameterList

Parameterlijst

urn:bro:gar:ParameterList

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:ParameterList

PumpType

Pomptype

urn:bro:gar:PumpType

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:PumpType

QualityControlMethod

Beoordelingsprocedure

urn:bro:gar:QualityControlMethod

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:QualityControlMethod

QualityControlStatus

StatusKwaliteitscontrole

urn:bro:gar:QualityControlStatus

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:QualityControlStatus

SamplingStandard

Bemonsteringsprocedure

urn:bro:gar:SamplingStandard

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:SamplingStandard

ValuationMethod

Waardebepalingsprocedure

urn:bro:gar:ValuationMethod

https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn:bro:gar:ValuationMethod

6. Vertaaltabel

Dit hoofdstuk bevat een vertaaltabel, aan de hand waarvan, gegeven de Engelstalige naam van een entiteit of een attribuut, de Nederlandse naam in de catalogus kan worden opgezocht.

De onderstaande tabel is gesorteerd op alfabetische volgorde van de Engelstalige naam van de entiteit. Tussen haakjes staat het type modelelement van de entiteit. Binnen een entiteit zijn de attributen gesorteerd op Engelstalige naam.

Entiteit (type)
attribuut

Naam
naam

AbstractRegistrationObject (FeatureType)

Abstract Registratieobject

broId

BRO-ID

Analysis (AttributeGroupType)

Analyse

analysisMeasurementValue

analysemeetwaarde

limitSymbol

limietsymbool

parameter

parameter

qualityControlStatus

status kwaliteitscontrole

reportingLimit

rapportagegrens

AnalysisProcess (AttributeGroupType)

Analyseproces

analysis

analyse

analysisDate

analysedatum

analyticalTechnique

bepalingstechniek

valuationMethod

bepalingsprocedure

BRO_DO (FeatureType)

Object uit registratie

deregistered

uit registratie genomen

deregistrationTime

tijdstip uit registratie genomen

ChamberOfCommerceNumber (PrimitiveDatatype)

KvK-nummer

CorrectionRequest (FeatureType)

Correctieverzoek

correctionReason

correctiereden

sourceDocument

brondocument

DispatchDataResponse (FeatureType)

Bericht van verzending gegevens

dispatchDocument

uitgiftedocument

FieldMeasurement (AttributeGroupType)

Veldmeting

fieldMeasurementValue

veldmeetwaarde

parameter

parameter

qualityControlStatus

status kwaliteitscontrole

FieldObservation (AttributeGroupType)

Veldwaarneming

abnormalFilter

inline filter afwijkend

abnormalityInCooling

afwijkend gekoeld

abnormalityInDevice

afwijking in meetapparatuur

colourStrength

kleursterkte

filterAerated

filter belucht

groundWaterLevelDroppedTooMuch

grondwaterstand teveel gedaald

hoseReused

slang hergebruikt

pollutedByEngine

contaminatie door verbrandingsmotor

primaryColour

hoofdkleur

sampleAerated

monster belucht

secondaryColour

bijkleur

temperatureDifficultToMeasure

temperatuur moeilijk te bepalen

FieldResearch (AttributeGroupType)

Veldonderzoek

fieldMeasurement

veldmeting

fieldObservation

veldwaarneming

samplingDateTime

tijdstip veldonderzoek

samplingDevice

bemonsteringsapparaat

samplingOperator

uitvoerder veldonderzoek

samplingStandard

bemonsteringsprocedure

GAR (FeatureType)

Grondwatersamenstellingsonderzoek

fieldResearch

veldonderzoek

laboratoryAnalysis

laboratoriumonderzoek

objectIdAccountableParty

object-ID bronhouder

qualityControlMethod

beoordelingsprocedure

GAR_O (FeatureType)

Grondwatersamenstellingsonderzoek

fieldResearch

veldonderzoek

laboratoryAnalysis

laboratoriumonderzoek

qualityControlMethod

beoordelingsprocedure

registrationHistory

registratiegeschiedenis

GAR_O_DP (FeatureType)

Grondwatersamenstellingsonderzoek

GroundwaterMonitoringTube (FeatureType)

GMW-monitoringbuis

broId

BRO-ID

tubeNumber

buisnummer

GroundwaterMonitoringNet (FeatureType)

Grondwatermonitoringnet

broId

BRO-ID

LaboratoryAnalysis (AttributeGroupType)

Laboratoriumonderzoek

analysisProcess

analyseproces

responsibleLaboratory

uitvoerder laboratoriumonderzoek

Organization (Union)

Organisatie

chamberOfCommerceNumber

kvk-nummer

europeanCompanyRegistrationNumber

europees handelsnummer

PartialDate (Union)

OnvolledigeDatum

date

volledige datum

voidReason

onbekend

year

jaartal

yearMonth

jaar en maand

RegistrationHistory (AttributeGroupType)

Registratiegeschiedenis

corrected

gecorrigeerd

deregistered

uit registratie genomen

deregistrationTime

tijdstip uit registratie genomen

latestAdditionTime

tijdstip laatste aanvulling

latestCorrectionTime

tijdstip laatste correctie

objectRegistrationTime

tijdstip registratie object

registrationCompletionTime

tijdstip voltooiing registratie

registrationStatus

registratiestatus

reregistered

weer in registratie genomen

reregistrationTime

tijdstip weer in registratie genomen

underReview

in onderzoek

underReviewTime

in onderzoek sinds

RegistrationObject (FeatureType)

Registratieobject

deliveryAccountableParty

bronhouder

deliveryResponsibleParty

dataleverancier

objectIdAccountableParty

object-ID bronhouder

qualityRegime

kwaliteitsregime

RegistrationObjectCode (PrimitiveDatatype)

Registratieobjectcode

RegistrationRequest (FeatureType)

Registratieverzoek

sourceDocument

brondocument

SamplingDevice (AttributeGroupType)

Bemonsteringsapparaat

pumpType

pomptype

JavaScript errors detected

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

If this problem persists, please contact our support.