Introduction
BRO_GLD_Addition is a XML export format following the Basis Registratie Ondergrond standard: https://schema.broservices.nl/xsd/isgld/1.0/isgld-messages.xsd.
The export can be used to upload GLD_Addition documents at: https://basisregistratieondergrond.nl/werken-bro/producten-diensten/bronhouderportaal/
Getting BRO GLD IDs
To get the BRO GLD IDs, you need to start the registration in the BRO for a groundwater filter. To achieve this you need to upload a BRO GLD Start Registration xml file to the bronhouder portal. The bronhouder portal will give you (if the BRO GLD Start Registration xml is valid) back to GLD ID.
To make the BRO GLD Start Registration xml files, the attached tool can be used. Note: the tool itself doesn't fall under support of Deltares and it is the responsibility of the configurator to use it correctly!
maak_gld_start_registraties.zip
BRO_GLD_Addition Export Configuration
The configuration of the BRO_GLD_Addition export module is shown in the following example.
The following are the required properties that have to be configured:
- chamberOfCommerceNumber: will be used to set the value of the brocom:chamberOfCommerceNumber element.
- qualityRegime: will be used to set the brocom:qualityRegime value. Can be either IMBRO or IMBRO/A
Optional properties that can be configured:
- unitOfMeasurement: optional property to set the unit of measurement. Default value is 'm'.
- splitFiles: default false. If set to true, timeseries that have 10000 or more time steps, will be split in files with 9999 timesteps. The BRO Portal currently doesn't support more than 9999 time steps.
- statusQualityControl: default '"goedgekeurd" allowed values are:
"afgekeurd", "goedgekeurd", "nogNietBeoordeeld", "onbeslist", "onbekend" - observationType: default "reguliereMeting" allowed values are:
"reguliereMeting", "controleMeting" - statusCode: default is none allowed values are:
"volledigBeoordeeld", "voorlopig", "onbekend" - processReference: default "NEN_EN_ISO22475v2006_C11v2010" allowed values are:
"NEN5120v1991", "NEN_EN_ISO22475v2006_C11v2010", "NEN_ISO21413v2005", "NPR_ISO.TR23211v2009", "RWSgwmon", "STOWAgwst", "vitensMeetprotocolGrondwater", "waternetMeetprocedure", "onbekend" - measurementInstrumentType: default "druksensor" allowed values are:
"akoestischeSensor", "akoestischHandapparaat", "analoogPeilklokje", "druksensor", "elektronischPeilklokje", "opzetStuk", "radarsensor", "stereoDruksensor", "onbekend", "onbekendPeilklokje" - processType: default "" allowed values are:
"Algorithm", "Manual Method", "Sensor", "Simulation", "Unknown" - evaluationProcedure: default "oordeelDeskundige" allowed values are:
"brabantWater2013", "eijkelkampDataValidatiev0.0.9", "oordeelDeskundige", "PMBProtocolDatakwaliteitscontroleQC2018v2.0", "RWSAATGrondwaterv1.0", "validatieprocedureEvidesWaterbedrijf", "vitensBeoordelingsprotocolGrondwater", "waternetBeoordelingsprocedure", "warecoWaterDataValidatieProtocolv20200219", "onbekend" - airPressureCompensationType: default is none, allowed values are:
"capillair", "gecorrigeerdLokaleMeting", "KNMImeting", "monitoringnetmeting", "putlocatiemeting", "onbekend"
Setting a property to an empty value "" will have the same result as omitting the property from the XML configuration.
The "onbekend" value that is listed for some properties can only be used in combination with qualityRegime IMBRO/A, which can be selected during registration of a GLD and cannot be changed afterwards.
For each exported XML file a BRO ID is required. This can either be the same as the internal locationId or (preferably) should be configured as a location attribute. The location attribute that holds the BRO ID should be mapped, using a location id function. For example:
idExportBro.xml
<?xml version="1.0" encoding="UTF-8"?> <idMap xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/idMap.xsd" version="1.1"> <locationIdFunction internalLocationSet="Peilbuizen_BRO" externalLocationFunction="@BRO_GLD_ID@"/> <enableOneToOneMapping/> </idMap>
The BRO GLD doesn't have multiple parameters (in the FEWS sense) only the heads in reference to NAP (for details see Basisregistratie Ondergrond Catalogus Grondwaterstandonderzoek (geostandaarden.nl)), so the external BRO parameter will always be mapped to the specified internal parameterId. This also means that the timeSeriesSets should only hold 1 parameterId.
The BRO_GLD_Addition can generate multiple XML files that will be stored in the subfolder that has been configured in the exportFileName element.
<?xml version="1.0" encoding="UTF-8"?>
<timeSeriesExportRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews
http://fews.wldelft.nl/schemas/version1.0/timeSeriesExportRun.xsd">
<export>
<general>
<exportType>BRO_GLD_Addition</exportType>
<folder>$EXPORT_FOLDER_ROOT$/BRO</folder>
<exportFileName>
<name>GLD</name>
</exportFileName>
<idMapId>IdExportBro</idMapId>
</general>
<properties>
<string key="chamberOfCommerceNumber" value="kvkNumber" ></string>
<string key="qualityRegime" value="IMBRO/A" ></string>
</properties>
<timeSeriesSet>
<moduleInstanceId>ImportEllitrack</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>GW.m</parameterId>
<locationSetId>Peilbuizen_BRO</locationSetId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="nonequidistant"/>
<readWriteMode>read complete forecast</readWriteMode>
</timeSeriesSet>
</export>
</timeSeriesExportRun>
The following code shows a sample output file:
<?xml version="1.0" encoding="UTF-8"?>
<registrationRequest xmlns="http://www.broservices.nl/xsd/isgld/1.0" xmlns:wml2="http://www.opengis.net/waterml/2.0" xmlns:gmd="http://www.isotc211.org/2005/gmd" xmlns:gco="http://www.isotc211.org/2005/gco" xmlns:om="http://www.opengis.net/om/2.0" xmlns:swe="http://www.opengis.net/swe/2.0" xmlns:brocom="http://www.broservices.nl/xsd/brocommon/3.0" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.broservices.nl/xsd/isgld/1.0 https://schema.broservices.nl/xsd/isgld/1.0/isgld-messages.xsd">
<brocom:requestReference>GLD_Addition_sensorisch_id_fb7b8963-e880-4dc6-a15a-bf7945d0c6ed</brocom:requestReference>
<brocom:deliveryAccountableParty>27376655</brocom:deliveryAccountableParty>
<brocom:broId>GLD000000041620</brocom:broId>
<brocom:qualityRegime>IMBRO/A</brocom:qualityRegime>
<sourceDocument>
<GLD_Addition gml:id="id_7a5d7c57-3c2a-4597-a499-cd4e234557e3">
<observation>
<om:OM_Observation gml:id="id_29b995ca-c627-4823-a28a-1d079537e874">
<om:type xlink:href="http://www.opengis.net/def/observationType/waterml/2.0/MeasurementTimeseriesTVPObservation"></om:type>
<om:metadata>
<wml2:ObservationMetadata>
<gmd:contact>
<gmd:CI_ResponsibleParty>
<gmd:organisationName>
<gco:CharacterString/>
</gmd:organisationName>
<gmd:role>
<gmd:CI_RoleCode codeList="urn:ISO:19115:CI_RoleCode" codeListValue="principalInvestigator">principalInvestigator</gmd:CI_RoleCode>
</gmd:role>
</gmd:CI_ResponsibleParty>
</gmd:contact>
<gmd:dateStamp gco:nilReason="unknown"/>
<gmd:identificationInfo gco:nilReason="unknown"/>
<wml2:status xlink:href="urn:bro:gld:StatusCode:voorlopig"/>
<wml2:parameter>
<om:NamedValue>
<om:name xlink:href="urn:bro:gld:ObservationMetadata:principalInvestigator"/>
<om:value xsi:type="brocom:OrganizationType">
<brocom:chamberOfCommerceNumber>kvkNumber</brocom:chamberOfCommerceNumber>
</om:value>
</om:NamedValue>
</wml2:parameter>
<wml2:parameter>
<om:NamedValue>
<om:name xlink:href="urn:bro:gld:ObservationMetadata:observationType"/>
<om:value xsi:type="gml:CodeWithAuthorityType" codeSpace="urn:bro:gld:ObservationType">reguliereMeting</om:value>
</om:NamedValue>
</wml2:parameter>
</wml2:ObservationMetadata>
</om:metadata>
<om:phenomenonTime>
<gml:TimePeriod gml:id="id_8852b8a7-66c8-43a2-b4e5-49bb468f2691">
<gml:beginPosition>2020-11-01T13:00:00Z</gml:beginPosition>
<gml:endPosition>2021-11-01T13:00:00Z</gml:endPosition>
</gml:TimePeriod>
</om:phenomenonTime>
<om:resultTime>
<gml:TimeInstant gml:id="id_552c694e-8938-427c-ac8d-b69eb7c4d7b8">
<gml:timePosition>2021-11-01T13:00:00Z</gml:timePosition>
</gml:TimeInstant>
</om:resultTime>
<om:procedure>
<wml2:ObservationProcess gml:id="id_47c053aa-4aa3-4b6c-a4ab-ba0c666a7c5c">
<wml2:processType xlink:href="http://www.opengis.net/def/waterml/2.0/processType/Algorithm"/>
<wml2:processReference xlink:href="urn:bro:gld:ProcessReference:NEN_EN_ISO22475v2006_C11v2010"/>
<wml2:parameter>
<om:NamedValue>
<om:name xlink:href="urn:bro:gld:ObservationProcess:airPressureCompensationType"/>
<om:value xsi:type="gml:CodeWithAuthorityType" codeSpace="urn:bro:gld:AirPressureCompensationType">monitoringnetmeting</om:value>
</om:NamedValue>
</wml2:parameter>
<wml2:parameter>
<om:NamedValue>
<om:name xlink:href="urn:bro:gld:ObservationProcess:evaluationProcedure"/>
<om:value xsi:type="gml:CodeWithAuthorityType" codeSpace="urn:bro:gld:EvaluationProcedure">oordeelDeskundige</om:value>
</om:NamedValue>
</wml2:parameter>
<wml2:parameter>
<om:NamedValue>
<om:name xlink:href="urn:bro:gld:ObservationProcess:measurementInstrumentType"/>
<om:value xsi:type="gml:CodeWithAuthorityType" codeSpace="urn:bro:gld:MeasurementInstrumentType">druksensor</om:value>
</om:NamedValue>
</wml2:parameter>
</wml2:ObservationProcess>
</om:procedure>
<om:observedProperty/>
<om:featureOfInterest/>
<om:result>
<wml2:MeasurementTimeseries gml:id="id_3ac2b742-1520-4031-a7e5-39b429bd0ef9">
<wml2:point>
<wml2:MeasurementTVP>
<wml2:time>2020-11-01T13:00:00Z</wml2:time>
<wml2:value uom="m+NAP">-0.881</wml2:value>
<wml2:metadata>
<wml2:TVPMeasurementMetadata>
<wml2:qualifier>
<swe:Category>
<swe:codeSpace xlink:href="urn:bro:gld:StatusQualityControl"/>
<swe:value>goedgekeurd</swe:value>
</swe:Category>
</wml2:qualifier>
</wml2:TVPMeasurementMetadata>
</wml2:metadata>
</wml2:MeasurementTVP>
</wml2:point>
<wml2:point>
<wml2:MeasurementTVP>
<wml2:time>2020-11-01T14:00:00Z</wml2:time>
<wml2:value uom="m+NAP">-0.881</wml2:value>
<wml2:metadata>
<wml2:TVPMeasurementMetadata>
<wml2:qualifier>
<swe:Category>
<swe:codeSpace xlink:href="urn:bro:gld:StatusQualityControl"/>
<swe:value>goedgekeurd</swe:value>
</swe:Category>
</wml2:qualifier>
</wml2:TVPMeasurementMetadata>
</wml2:metadata>
</wml2:MeasurementTVP>
</wml2:point>
<wml2:point>
<wml2:MeasurementTVP>
<wml2:time>2020-11-01T15:00:00Z</wml2:time>
<wml2:value uom="m+NAP">-0.881</wml2:value>
<wml2:metadata>
<wml2:TVPMeasurementMetadata>
<wml2:qualifier>
<swe:Category>
<swe:codeSpace xlink:href="urn:bro:gld:StatusQualityControl"/>
<swe:value>goedgekeurd</swe:value>
</swe:Category>
</wml2:qualifier>
</wml2:TVPMeasurementMetadata>
</wml2:metadata>
</wml2:MeasurementTVP>
</wml2:point>
</wml2:MeasurementTimeseries>
</om:result>
</om:OM_Observation>
</observation>
</GLD_Addition>
</sourceDocument>
</registrationRequest>
