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.
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>
The following code shows a sample output file: