Berichtencatalogus Innamewebservice SFR

Inleiding

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

Het document veronderstelt dat de lezer bekend is met de SFR 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).

Leeswijzer

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

Hoofdstuk 3 bevat een toelichting op enkele voorbeeldberichten.

Hoofdstuk 4 bevat de toegestane waarden van de gebruikte enumeraties (niet-beheerde waardenlijsten).

Hoofdstuk 5 bevat verwijzingen (URL's) naar de websites met toegestane waarden van de codelijsten (beheerde waardenlijsten).

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.

Versiehistorie

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.

Voor vragen, suggesties of opmerkingen kunt contact opnemen met de BRO Servicedesk via een mail naar support@broservicedesk.nl .

Als u toegang heeft tot de  BRO Selfservicedesk (alleen via desktop of laptop), kunt u daar inloggen en uw vraag stellen voor een extra snelle afhandeling.

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

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 SFR inname webservice. Paragraaf 2.2 beschrijft het verband tussen de deelonderzoeken, waaruit een bodemkundig wandonderzoek kan bestaan, en de wijze van aanleveren. Paragraaf 2.3 beschrijft de verschillende brondocumenten die in een request opgenomen kunnen worden. 

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 SFR innamewebservice ondersteunt twee BRO-verzoeken. Zie onderstaande tabel.

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

RegistrationRequest

Met een registrationRequest (innameverzoek) wordt een nieuw registratieobject toegevoegd aan de BRO .

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

correctionRequest

Met een correctionRequest (correctieverzoek) kan de dataleverancier een registratieobject in één keer corrigeren. Het is niet mogelijk de waarde van een individueel attribuut te corrigeren; correcties kunnen alleen uitgevoerd worden door één van de gedefinieerde brondocumenten aan te bieden.

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

Deelonderzoeken

SFR bestaat uit drie deelonderzoeken:

• Wandbeschrijving.
• Wandmonsteranalyse.
• Wandfotografie.

De resultaten van een bodemkundig wandonderzoek worden in delen of in hun geheel gerapporteerd. Wanneer de resultaten in delen worden gerapporteerd worden deze per deelonderzoek geregistreerd en dat betekent in transactietermen dat een SFR registratieobject aangevuld moet kunnen worden en dat het daarmee een materiële geschiedenis opbouwt. Voor objecten met geschiedenis is het registreren een proces met een zekere duur. Het proces heeft een begin en een eind en daartussen kan zich de noodzaak voordoen nieuwe gegevens over te dragen.

SFR wordt gefaseerd gerealiseerd en daarmee ontstaat een tijdelijke situatie waarin SFR nog niet volledig is gedefinieerd en slechts een deel van de gegevens aangeboden kan worden. De huidige brondocumenten (zie paragraaf 2.3) beschrijven een deel van SFR en dat is de wandbeschrijving. In de volgende fase worden de wandmonsteranalyse toegevoegd en ontstaan nieuwe brondocumenten die de huidige brondocumenten vervangen. Later worden wandmonsterfotografie toegevoegd (termijn nog onbekend). Pas dan is SFR volledig gedefinieerd. Raadpleeg voor meer informatie de planning op  www.basisregistratieondergrond.nl.

Brondocumenten

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

Een brondocument is de eenheid waarin een verzameling gegevens worden geregistreerd, aangevuld 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.

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.

Het feit, dat de resultaten van een bodemkundig wandonderzoek per deelonderzoek geregistreerd moeten kunnen worden en dat het bodemkundig wandonderzoek gefaseerd gerealiseerd wordt, leidt ertoe dat momenteel de volgende twee brondocumenten zijn gedefinieerd:

Onderstaande tabel geeft per brondocument de belangrijkste onderdelen weer.

De betekenis van de tekens in de laatste 5 kolommen is als volgt:

• Een √ geeft aan dat het onderdeel  aanwezig moet zijn  in het brondocument.
• Een + geeft aan dat het onderdeel  aanwezig mag zijn in het brondocument.
• Een leeg veld geeft aan dat het onderdeel  niet aanwezig mag zijn in het brondocument.

SFR_CompleteReport_V1

Onderstaande tabel definieert dit brondocument, inclusief de inhoud als deelverzameling van de gegevensdefinitie in de catalogus en de regels aanvullend op de bedrijfsregels in de catalogus.

SFR_StartReport_V1

Onderstaande tabel definieert dit brondocument, inclusief de inhoud als deelverzameling van de gegevensdefinitie in de catalogus en de regels aanvullend op de bedrijfsregels in de catalogus.

Voorbeeldberichten

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

Integrale voorbeeldberichten

Dit hoofdstuk bevat enkele voorbeeldberichten met regel voor regel een toelichting.  De integrale voorbeeldberichten zijn te vinden op de GitHub website (github.com/BROprogramma/SFR/tree/gh-pages/Berichtencatalogus/innameservice).

Wandbeschrijving en rapage direct afronden

Dit voorbeeldbericht is van toepassing als alle gegevens van een bodemkundig wandonderzoek in één keer worden aangeleverd. Het uitgevoerde deelonderzoek is alleen een wandbeschrijving. Met dit BRO-verzoek worden de gegevens over het veldwerk en de wandbeschrijving gerapeerd en wordt aangegeven dat de registratie van het bodemkundig wandonderzoek meteen voltooid is.

Randvoorwaarden

In het voorbeeldbericht zijn de volgende keuzes gemaakt:

• Het bodemkundig wandonderzoek bestaat uit alleen het veldwerk en een wandbeschrijving. Er  zijn geen wandmonsteranalyses uitgevoerd of wandfoto's gemaakt,
• De dataleverancier is niet tevens bronhouder.
• De bronhouder heeft aangegeven dat alle uitvoerende partijen vermeld moeten worden.
• De wandbeschrijving is opgesteld conform de nieuwe standaard AlterraTD19A, versie 2020, en wordt in het kader van een publieke taak onder het kwaliteitsregime IMBRO aangeboden.
• Het graven van de wandkuil is uitgevoerd op 1 januari 2018. Op dezelfde dag is de wandbeschrijving opgesteld en heeft de uitvoerder van het wandonderzoek alle gegevens van het bodemkundig wandonderzoek aangeboden bij het Bronhouderportaal en daarmee de rapportage afgerond.
• De wandbeschrijving bestaat uit:
  • Een wandprofiel, bestaande uit.
    • Eén strooisellaag.
    • Twee bodemlagen:
      • De eerste bestaat uit drie laagcomponenten met horinzontcodes Ah, AB en Bt, inclusief grondsamenstelling, fractieverdeling en Munsell-kleur.
      • De tweede is homogeen met oer als bijzonder materiaal.
    • Eén verstoord interval.
    • Een verdicht interval.
  • Bodemclassificatie.

Toelichting

Dit voorbeeldbericht bestaat in hoofdlijnen uit de beschrijving van het veldwerk (objectIdAccountableParty .. litterLayerInvestigated, deliveredLocation, deliveredVerticalPosition, soilUncovering en siteCharacteristic), de wandbeschrijving (soilFaceDescription) en een rapportagedatum (researchReportDate).

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

Regel 2 t/m 8 bevatten het registrationRequest  (innameverzoek) als root XML-element en de namespaces van de gebruikte XML-schemadefinities (XSD's).

Regel 13 t/m 16 bevatten de transactiegegevens van het BRO-verzoek, waaronder in regel 16 de waarde IMBRO voor het qualityRegime  (kwaliteitsregime).

Regel 17 bevat de opening tag van het   sourceDocument  (brondocument) .

Regel 18 geeft aan welk type brondocument wordt aangeboden . Het XML-attribuut gml:id bevat een waarde die uniek is binnen dit bericht.

Regel 19 is het eerste gegeven binnen dit brondocument, de objectIdAccountableParty (object-ID bronhouder).

Regel 23 t/m 32 bevatten de fieldworkDate (veldwerkdatum). In dit voorbeeldbericht is de waarde een volledige datum (jaar-maand-dag, oftewel brocom:date). Uitgecommentarieerd staan de alternatieven voor een onvolledige datum: jaar en maand, alleen een jaartal of 'onbekend'.

Regel 34 t/m 41 geven aan dat de researchOperator (uitvoerder van het wandonderzoek) wordt geïdentificeerd met een  chamberOfCommerceNumber  (KvK-nummer). Het moet dus gaan om een Nederlandse onderneming of maatschappelijke activiteit van een rechtspersoon. Deze regels bevatten ook een alternatief voorbeeld voor het geval de uitvoerder een equivalent daarvan is in een handelsregister van een andere lidstaat van de Europese Unie dan Nederland, waarbij de uitvoerder dan geïdentificeerd wordt door zijn  europeanCompanyRegistrationNumber  (Europees handelsnummer).

Daarna volgen 2 blokken met XML-elementen van AttributeGroups (gegevensgroepen). Na de opening tag volgt meteen de reeks van XML-elementen van de AttributeGroup (gegevensgroep). Zie de catalogus voor nadere details;

• Regel 43 t/m 63: deliveredLocation (Aangeleverde locatie), oftewel de plaats van het wandonderzoek op het aardoppervlak.
• Regel 64 t/m 88: deliveredVerticalPosition (Aangeleverde verticale positie).

De deliveredLocation (Aangeleverde locatie) kan aangeleverd worden in het Rijks Driehoekstelsel (EPSG 28992; eerst de X-coördinaat daarna de Y-coördinaat, gescheiden door een spatie en met een punt tussen de meters en de decimalen daarvan) of in het European Terrestrial Reference System 1989 (EPSG 4258; eerst de latitude daarna de longitude, gescheiden door een spatie en met een punt tussen de graden en de decimalen daarvan).

Daarna volgen 3 blokken met gegevens van FeatureTypes (Objecttypes). De XML-codering van een FeatureType (Objecttype) volgt het 'property type' patroon: na de opening tag volgt een tweede tag met de naam van het type van het FeatureType (Objecttype) en een XML-attribuut gml:id. Daarna volgt de reeks van XML-elementen van het FeatureType (Objecttype), afgesloten met de closing tag van het type en de closing tag van het blok met XML-elementen. Zie de catalogus voor nadere details;

• Regel 89 t/m 99: soilUncovering (wandontsluiting).
• Regel 100 t/m 120: siteCharacteristic (terreintoestand).
• Regel 121 t/m 622: soilFaceDescription (wandbeschrijving).

Regels 148 t/m 165 bevatten de algemene gegevens van een soilProfile (wandprofiel).

Vanaf regel 167 volgt de beschrijving van de litterLayers (strooisellagen). De strooisellagen zijn optioneel en dit voorbeeldbericht bevat één strooisellaag. Dit is ook een FeatureType (Objecttype) en de inhoud volgt dus ook het het 'property type' patroon.

Vanaf regel 180 volgen de beschrijvingen van de soilLayers (bodemlagen). Een soilProfile (wandprofiel) bevat minstens één soilLayer (bodemlaag). Dit voorbeeldbericht heeft twee bodemlagen. De bodemlaag is ook een FeatureType (Objecttype) en de inhoud volgt dus ook het het 'property type' patroon.

Regel 181 t/m 517 bevat de eerste soilLayer (bodemlaag). Deze bestaat uit drie layerComponents (laagcomponenten) met horizonCodes (horizontcodes) Ah, AB en Bt. De drie laagcomponenten hebben een soil (grond) als beschrijving van de grondsamenstelling, inclusief fractionDistribution (fractieverdeling) en munsellColour (Munsell-kleur).

Regel 518 t/m 563 bevat de tweede soilLayer (bodemlaag). Deze is homogeen met oer als bijzonder materiaal.

Als laatste volgen twee optionele onderdelen van het wandprofiel, de reeks van disturbedIntervals (verstoorde intervallen; regel 564 t/m 573) en het compactedInterval (verdicht interval; regel 574 t/m 582).

De wandbeschrijving wordt afgesloten met de soilClassification (bodemclassificatie; regel 583 t/m 620) met daarin, in dit voorbeeld, twee keer een specialFeatureBottom (bijzonderheid onderin). De twee soilClassifications (bodemclassificaties) zijn ook FeatureTypes (Objecttypes) en volgen dus het property-type patroon.

Als laatste volgt in regel 623 t/m 632 de researchReportDate (rapportagedatum). De aanwezigheid van dit element geeft aan dat met het verwerken van dit bericht de registratie van het bodemkundig wandonderzoek is voltooid. Voor de waarde van de rapportagedatum is een volledige datum gebruikt (jaar-maand-dag, oftewel brocom:date). Uitgecommentarieerd staan de alternatieven voor een onvolledige datum: jaar en maand, alleen een jaartal of 'onbekend'.

Wandbeschrijving maar rapportage nog niet afronden

Dit voorbeeldbericht is van toepassing als een bodemkundig wandonderzoek bestaat uit 2 of meer deelonderzoeken, waarbij met dit BRO-verzoek de gegevens over het veldwerk en de wandbeschrijving worden gerapporteerd. Op een later tijdstip zullen de andere deelonderzoeken gerapporteerd worden.

Randvoorwaarden

In het voorbeeldbericht zijn de volgende keuzes gemaakt:

• Het bodemkundig wandonderzoek bestaat uit ten minste twee deelonderzoeken:
  • Met dit BRO-verzoek zullen de gegevens over de wandkuil en het overige veldwerk alsmede de wandbeschrijving worden aangeboden.
  • Op een later tijdstip, als versie V2 van de brondocumenten beschikbaar is, zal het wandonderzoek worden aangevuld en gelijktijdig of later worden afgerond.
• De dataleverancier is niet tevens bronhouder.
• De bronhouder heeft aangegeven dat alle uitvoerende partijen vermeld moeten worden.
• De wandbeschrijving is opgesteld conform AlterraTD19A, versie 1995 en wordt in het kader van archiefoverdracht onder het kwaliteitsregime IMBRO/A aangeboden.
• Het werk is uitgevoerd en de rapportage opgesteld in het jaar 2018. Nadere duiding van de datum is niet bekend.
• De wandbeschrijving bestaat uit:
  • Een wandprofiel, bestaande uit:
    • Eén strooisellaag.
    • Eén homogene bodemlaag met oer als bijzonder materiaal.
    • Geen verstoord interval.
    • Geen verdicht interval.
  • Bodemclassificatie.

Toelichting

Dit voorbeeldbericht bestaat in hoofdlijnen uit één deelonderzoek (soilFaceDescription) en de beschrijving van het veldwerk (objectIdAccountableParty .. litterLayerInvestigated, deliveredLocation, deliveredVerticalPosition, soilUncovering en siteCharacteristic). In vergelijking met het voorbeeldbericht 'Wandbeschrijving en rapportage direct afronden' ontbreekt de researchReportDate (rapportagedatum).

Regel 18 geeft aan welk type brondocument wordt aangeboden: SFR_StartReport_V1. Het XML-attribuut gml:id bevat een waarde die uniek is binnen dit bericht.

Vanaf regel 186 volgen de beschrijvingen van de soilLayers (bodemlagen). Een soilProfile (wandprofiel) bevat minstens één soilLayer (bodemlaag). Dit voorbeeldbericht heeft één bodemlaag, bestaande uit één homogeneousMaterial (homogeen materiaal) met oer als specialMaterial (bijzonder materiaal). Het datatype van de soilProfile (wandprofiel) is een FeatureType (ObjectType). De XML-codering van een FeatureType (Objecttype) volgt het 'property type' patroon: na de opening tag volgt een tweede tag met de naam van het type van het FeatureType (Objecttype) en een XML-attribuut gml:id. Daarna volgt de reeks van XML-elementen van het FeatureType (Objecttype), afgesloten met de closing tag van het type en de closing tag van de soilProfile (wandprofiel).

De laatste twee onderdelen van het wandprofiel, de disturbedInterval (verstoorde intervallen) en het compactedInterval (verdichte interval), zijn optioneel en komen in dit voorbeeldbericht niet voor.

De wandbeschrijving wordt afgesloten met de soilClassification (bodemclassificatie; regel 243 t/m 280) met daarin in dit voorbeeld twee keer een specialFeatureBottom (bijzonderheid onderin). De twee soilClassifications (bodemclassificaties) zijn ook FeatureTypes (Objecttypes) en volgen dus het 'property type' patroon.

Regel 283 bevat de closing tag SFR_StartReport_V1 als type van het sourceDocument (brondocument). Merk op dat de researchReportDate (rapportagedatum) ontbreekt. Daarmee wordt aangegeven dat met dit bericht de registratie van het bodemkundig wandonderzoek nog niet is voltooid en dat er nog aanvullingen zullen volgen, met bijvoorbeeld wandmonsteranalyses of wandfotografie. Deze aanvullingen zijn nog niet mogelijk in de huidige versie van de SFR innamewebservice.

Regel 284 bevat de closing tag van het sourceDocument (brondocument).

Regel 285 bevat de closing tag van het registrationRequest (innameverzoek).

Correctieverzoek

Met dit voorbeeldbericht kan het registratieobject, zoals geregistreerd met het voobeeldbericht 'Wandbeschrijving maar rapportage nog niet afronden', gecorrigeerd worden. De inhoud is bijna gelijk; de verschillen zijn:

• Regel 2: de opening tag van het XML-root element is nu correctionRequest (correctieVerzoek).
• Regel 16: de broId (BRO-ID) van het te corrigeren registratieobject is toegevoegd.
• Regel 18: de correctionReason (correctiereden) is toegevoegd.
• Regel 116: binnen siteCharacteristic (terreintoestand) is het attribuut meanHighestGroundwaterTable (gemiddeld hoogste grondwaterspiegel) toegevoegd met de waarde 1,85 meter.
• Regel 118: binnen siteCharacteristic (terreintoestand) is het attribuut meanLowestGroundwaterTable (gemiddeld laagste grondwaterspiegel) toegevoegd met de waarde 2,15 meter.
• Regel 162: binnen soilProfile (wandprofiel) is de waarde van het attribuut meanHighestGroundwaterLevelReached (gemiddeld hoogste grondwaterstand bereikt) gewijzigd van 'onbekend' in 'nee'.
• Regel 287: de closing tag van het XML-root element is nu correctionRequest (correctieVerzoek).

Code snippets.

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

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) niet toegestaan als het sourceDocument (brondocument) een SFR_StartReport_V1 is. Bij de andere types brondocumenten en 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).

<?xml version="1.0" encoding="UTF-8"?>
<registrationRequest 
        xmlns="http://www.broservices.nl/xsd/issfr/2.0"
        xmlns:sfrcom="http://www.broservices.nl/xsd/sfrcommon/2.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/issfr/2.0 https://schem.broservices.nl/xsd/issfr/2.0/issfr-messages.xsd">
    <!-- Disclaimer: dit voorbeeldbericht valideert tegen de XSD van de innameservice.
            Het is niet gevalideert door de innameservice en is vaktechnisch/inhoudelijk niet voorbeeldig.
    -->
    <brocom:requestReference>SFR-BRO-1596</brocom:requestReference>
    <!--Optional:-->
    <brocom:deliveryAccountableParty>27376655</brocom:deliveryAccountableParty>
    <!--Optional:-->
    <!--brocom:broId>SFR123456789012</brocom:broId-->
    <brocom:qualityRegime>IMBRO/A</brocom:qualityRegime>
    <sourceDocument>
        <SFR_StartReport_V1 gml:id="id_0001">
           ...
        </SFR_StartReport_V1>
    </sourceDocument>
</registrationRequest>

Brondocument

Een BRO-verzoek bevat een brondocument. Een brondocument is de eenheid van aanleveren. De SFR 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 SFR_StartReport_V1. Deze regel geeft aan dat in dit bericht dat type brondocument is opgenomen. Het element SFR_StartReport_V1 is als root element gedefinieerd in het XSD-bestand issfr-messages.xsd van de SFR innamewebservice. Na deze regel komt het eerste XML element van het brondocument.

Codelijst

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

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:

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:

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.

Locatie

De gegevenscatalogus definieert voor de DeliveredLocation (Aangeleverde locatie) en StandardizedLocation (Gestandaardiseerde locatie) onder andere de volgende twee attributen:

• Coördinaten: de coördinaten die zijn aangeleverd.
• Referentiestelsel: het referentiestelsel van de aangeleverde coördinaten.

Conform de GML encoding rules van NEN3610 worden deze twee attributen omgezet in een gml:Point. Die bestaat op zijn beurt uit:

• XML-element gml:pos - de coördinaten
• XML-attribuut srsName - een verwijzing naar het referentiestelsel waarin de coördinaten zijn uitgedrukt.
• XML-attribuut gml:id - een unieke identificatie van het object

Het bereik en de betekenis van de coördinaten is afhankelijk van het gebruikte referentiestelsel. Onderstaande tabel geeft per referentiestelsel de waarde voor het XML-attribuut srsName en de betekenis, toepassingsgebied, eenheid en volgorde van de ordinaten.

Voorbeeld van de XML-encoding voor dezelfde locatie in RD en in ETRS89:

Meetreeks

De gegevenscatalogus definieert voor een aantal bepalingen een meetreeks als resultaat. Daarbij wordt op gezette tijden (of bij bepaalde waarden van een andere onafhankelijke grootheid) steeds de waarde van een aantal grootheden bepaald. Bij bijvoorbeeld ShrinkageState (Krimptoestand) wordt per keer van vier grootheden de waarde gemeten (massa, volume, hoogte en diameter), terwijl bij HydraulicConductivityState (waterdoorlatendheidstoestand) van drie grootheden de waarde wordt gemeten (bodemvochtpotentiaal, waterdoorlatendheid en volumetrisch watergehalte).

Bij een meetreeks wordt één of meer keren een meetronde uitgevoerd; dit leidt tot een reeks van verzamelingen met meetwaarden. Het aantal uitgevoerde meetronden is bekend. Iedere meetreeks heeft zijn eigen aantal uitgevoerde meetrondes. Bijvoorbeeld de Shrinkage (Krimpverloop) bestaat uit 2 tot 30 keer een ShrinkageState (Krimptoestand).

Je kunt een meetreeks ook zien als een tabel. Iedere meetreeks heeft zijn eigen tabel. De tabel heeft een aantal kolommen en een aantal regels. Iedere regel komt overeen met een meetronde. De kolommen komen overeen met de gemeten waarden van de onafhankelijke en afhankele grootheden. De tabel in zijn geheel kun je zien als een reeks van records.

Omdat het in deze situaties potentieel om een groot aantal waarden kan gaan, worden de waarden van de grootheden niet uitgeleverd als XML-elementen, maar wordt er gebruikt gemaakt van een compacte codering volgens de SWE standaard (Sensor Web Enablement) van het OGC (Open Geospatial Consortium). De meetreeks is daarbij gemodelleerd als een swe:DataArray. De gemeten of bepaalde waarden van de grootheden worden gemodelleerd als een swe: DataRecord.

Een swe:DataArray bestaat uit vier XML-elementen:

• elementCount: het aantal meetpunten in de meetreeks.
• elementType: beschrijving van een meetpunt als onafhankelijke en afhankelijke grootheden in een swe:DataRecord.
• encoding: aanduiding voor de codering van:
  • Een decimalSeparator (decimaalscheidingsteken) voor de waarden van een grootheid in een meetpunt.
  • Een tokenSeparator (tokenscheidingsteken) om de waarden van de grootheden binnen een meetpunt te scheiden.
  • Een blockSeparator (recordscheidingsteken) om de  meetpunten binnen de meetreeks te scheiden.
• values: de 'CSV'-gecodeerde reeks van waarden van de grootheden van de meetpunten van de meetreeks.

Het DataRecord met de beschrijving van de onafhankelijke en afhankelijke grootheden kan in-line worden opgenomen of externe gedefinieerd worden. Bij de BRO is ervoor gekozen om de definitie van de swe:DataRecords niet in-line op te nemen, maar om deze centraal vast te leggen. In een DataArray wordt dan een verwijzing (xlink:href) opgenomen naar het bestand met daarin een DataRecord. De bestanden met de DataRecords kunnen gedownload worden vanaf dezelfde locatie als de XSD-bestanden (zie bijvoorbeeld https://schema.broservices.nl/xsd/srcommon/1.0/).

Voor iedere grootheid moet een waarde opgenomen worden in de values met meetpunten van de meetreeks. Het DataRecord geeft aan hoe het ontbreken van een waarde moet worden weergegeven door middel van een nilValue.

Onderstaande tabel geeft een samenvatting van de meetreeksen in de gegevenscatalogus waar dit SWE patroon is toegepast, de XML-elementen die dientengevolge het datatype swe:DataArray hebben gekregen en de bijbehorende XML-bestanden waarin de definities van de swe:DataRecords zijn opgenomen.

Hieronder een voorbeeld van een meetreeks voor een shrinkage (krimpverloop) bestaande uit 5 dataRecords:, waarbij de waaarde voor de derde en vierde grootheid (hoogte en diameter) telkens ontbreekt:

  <srcom:shrinkage>
        <swe:DataArray id="wenr.sfr.PFB-936.29">
            <swe:identifier>shrinkage</swe:identifier>
            <swe:elementCount>
                <swe:Count>
                    <swe:value>5</swe:value>
                </swe:Count>
            </swe:elementCount>
            <swe:elementType name="krimptoestand" ns3:href="D:\projecten\sandbox\work\ea\sfr\xsd\meetreeksen\ShrinkageState.xml"/>
            <swe:encoding>
                <swe:TextEncoding collapseWhiteSpaces="false" decimalSeparator="." tokenSeparator="," blockSeparator=";"/>
            </swe:encoding>
             <swe:values>66.4,39.4,NaN,NaN;65.5,38.8,NaN,NaN;64.8,38.4,NaN,NaN;60.8,35.4,NaN,NaN;60.3,35.0,NaN,NaN</swe:values>
        </swe:DataArray>
    </srcom:shrinkage>

Als we als blockSeparator (recordscheidingsteken) een spatie gebruiken in plaats van een punt-komma en voor collapseWhiteSpaces de waarde true invullen (we mogen spaties toevoegen voor en na iedere tokenseparator en blockseparator), dan ontstaat het volgende voorbeeld, met een betere human-readability:

    <srcom:shrinkage>
        <swe:DataArray id="wenr.sfr.PFB-936.29">
            <swe:identifier>shrinkage</swe:identifier>
            <swe:elementCount>
                <swe:Count>
                    <swe:value>5</swe:value>
                </swe:Count>
            </swe:elementCount>
            <swe:elementType name="krimptoestand" ns3:href="D:\projecten\sandbox\work\ea\sfr\xsd\meetreeksen\ShrinkageState.xml"/>
            <swe:encoding>
                <swe:TextEncoding collapseWhiteSpaces="true" decimalSeparator="." tokenSeparator="," blockSeparator=" "/>
            </swe:encoding>
            <swe:values>
                66.4,39.4,NaN,NaN
                65.5,38.8,NaN,NaN
                64.8,38.4,NaN,NaN
                60.8,35.4,NaN,NaN
                60.3,35.0,NaN,NaN
            </swe:values>
        </swe:DataArray>
    </srcom:shrinkage>

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, maar wordt het XML attribuut uom (eenheid) wel opgenomen. Zie onderstaande voorbeelden voor een offset (verschuiving) met en zonder een waarde.

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.

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:

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:

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.

Property type pattern

De SFR 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 siteCharacteristic (terreintoestand), na de opening tag een tweede tag volgt, in dit geval SiteCharacteristic (Terreintoestand) 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 siteCharacteristic (terreintoestand). Daardoor is voor een ontvangend systeem eenduidige bekend is hoe de inhoud geparsed moet worden. Voorbeeld:

    <sfr:siteCharacteristic>
        <sfrcom:SiteCharacteristic ns2:id="PFB-936.002">
            <sfrcom:soilUse codeSpace="urn:bro:sfr:SoilUse">akkerGranen</sfrcom:soilUse>
            ...
        </sfrcom:SiteCharacteristic>
    </sfr:siteCharacteristic>

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 bodemkundig wandonderzoek. 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.

Codelijsten

Dit hoofdstuk bevat verwijzingen (URN's en URL's) naar de codelijsten (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 beheerde waardenlijst een codelijst. Bij een codelijst kan de lijst met toegestane waarden worden aangepast zonder dat aanpassingen nodig zijn in de berichtdefinities (XSD-bestanden) en/of de software (voor het maken of verwerken van een bericht). De catalogus bevat per codelijst de toegestane waarden, zoals gedefinieerd op het moment dat de catalogus werd vastgesteld.

De onderstaande tabel geeft een overzicht van de codelijsten die van belang zijn bij het maken van een BRO-verzoek over een bodemkundig wandonderzoek. 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  in  een BRO-verzoek gebruikt moet worden als waarde voor het XML-attribuut  codeSpace. De vierde kolom bevat een link naar de website waar de actuele lijst is te raadplegen met toegestane waarden die in een BRO-verzoek gebruikt mogen worden als waarde voor een XML-element.

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.