Introduction
BRO_GLD_Addition_Server is a server export using the XML export format of the Basis Registratie Ondergrond standard: https://schema.broservices.nl/xsd/isgld/1.0/isgld-messages.xsd. It is simular to the BRO_GLD_Addition export, that writes GLD_Addation documents to the filesystem.
The export can be used to automatically upload GLD_Addition documents at: https://basisregistratieondergrond.nl/werken-bro/producten-diensten/bronhouderportaal/
BRO_GLD_Addition_Server Export Configuration
The configuration of the BRO_GLD_Addition_Server 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
- skipBroValidation: default false. Before uploading the GLD_Addition document to the BRO, the XML document will be validated using the validation API of the BRO. This is an optional feature and can make the export take a lot of time. The uploaded document will also be validated again after upload by the BRO. To disable validation, set the skipBroValidation property to true.
- splitFiles: default false. If set to true, timeseries that have 10000 or more time steps, will be splitted in files with 9999 timesteps. The BRO Portal currently doesn't support more than 9999 time steps.
For each exported XML file a BRO ID is required. This 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:
<?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_Addition_Server can be configured as follows.
<?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_Server</exportType>
<serverUrl>https://demo.bronhouderportaal-bro.nl</serverUrl>
<!-- BRO can take a long time to upload. Set timeout to 5 minutes -->
<connectionTimeOutMillis>300000</connectionTimeOutMillis>
<!-- username and password can be acquired from the BRO portal bij getting a token. -->
<user>myuserid</user>
<password>mytokenvalue</password>
<idMapId>IdExportBro</idMapId>
</general>
<properties>
<string key="chamberOfCommerceNumber" value="XXXXX" ></string>
<string key="qualityRegime" value="IMBRO" ></string>
<!-- Validation can take quite some time. To skip BRO validation, set this property to true. Validation will also be done in the portal. -->
<bool key="skipBroValidation" value="false" ></bool>
</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>
Acquire a BRO "Aanlevertoken"
To get a BRO Aanlever token, login to the BRO portal (Demo or Production environment). Select the "Aanlevertokens" tab and use the button "Nieuw aanlevertoken aanmaken".
In the configuration example above you should:
- fill in the "token username" (in the blue bar above) in the <user> element
- fill in the "token" (in the black bar above) in the <password> element
