Webloket bodem - XML/XSD-wijzigingen

Webloket bodem - XML/XSD-wijzigingen

Inleiding

Webloket eBSD heeft verschillende XML upload functionaliteiten:

Import Feature

 

Import Feature

 

  • Full import op basis van een model.xsd

image-20260429-133258.png
  • Partiële import van Profielen

    • Analyses (analyses.xsd)

    • Veldwerk (Partiele import van de model.xsd)

    • DOV (DOV.xsd)

image-20260429-133359.png

 

Dit document beschrijft de geplande wijzigingen aan de XML/XSD-wijzigingen in kader van de geplande release van 1 oktober 2026.

Domeinwijziging

Naar aanleiding van Databank Grondverzet voeren we een grote wijziging door in het domein van het webloket Bodem: het concept ‘analysestaal’ wordt toegevoegd aan de user interface en het XML-schema. Momenteel is er immers geen correcte mogelijkheid om een mengstaal in te geven, en dat is noodzakelijk om grondverzetsdata correct te kunnen ontvangen.

Planning

Vanaf 1 oktober 2026 zal het nieuwe schema beschikbaar zijn in het webloket (in productie). Deze dient verplicht gebruikt te worden binnen Databank Grondverzet, omwille van de mengstalen.

Voor alle andere bodemonderzoeken zal er vervolgens een overgangsperiode zijn waarin het nieuwe schema of een van de oude schema’s gebruikt kan worden.

Vanaf 1 december zal enkel het nieuwe schema aanvaard worden. Er zal dus geen backwards compatibility meer gehanteerd worden zoals voorheen het geval.

 

Backwards compatibility

  • Huidige versies (model_8_9.xsd) zullen:

    • geen Grondverzet ondersteunen

    • omgezet worden zodat ze enkelvoudige stalen bevatten (1 AnalyseStaal voor 1 Staalname)

  • De nieuwe versie (model_9_0.xsd) zal:

    • Grondverzet ondersteunen

    • Het concept van Mengstalen ondersteunen

Technisch

DISCLAIMER
Hieronder lichten we de wijzigingen toe in het XSD-schema. We hebben ons best gedaan deze zo volledig mogelijk uit te werken (alvorens de implementatie te starten, zodat we dit zo snel mogelijk kunnen delen).
Dit neemt niet weg dat ten gevolge van de implementatie ervan (kleine) wijzigingen mogelijk zijn. Deze zullen gedocumenteerd worden op deze pagina.

Aanpassingen aan DOV.xsd

De DOV.xsdblijft hetzelfde en krijgt geen aanpassingen. Deze import functionaliteit werkt hedendaags enkel op het niveau van profielen en vereist dus geen update.

Aanpassingen aan Model.xsd (model_8_9.xsdmodel_9_0.xsd)

Versienummer

  • Schemaversie verhoogd van 8.9 naar 9.0.

Nieuw toegevoegd

Analyse stalen (nieuw concept)

  • Een Opdracht bevat analyseStalen

    • Nieuw type analyseStaal met velden: naam, topMin, basisMax, commentaar, medium en een lijst van analyseResultaten.

  • Nieuw type analyseResultaat (hernoemd van profielOpdrachtStaalNameAnalyse)

  • Nieuw type samenstellingAnalyseStaal dat een koppeling legt tussen een staalname en een analyseStaal.

Grondverzet onderzoek (nieuw opdrachttype)

  • Nieuw opdrachttype opdrachtGrondverzetOnderzoek toegevoegd met een veld meldingsreferentie.

    • In het basismodel is dit veld optioneel.

    • In het validatiemodel is dit veld verplicht (minOccurs=1) en beperkt tot maximaal 6 tekens.

  • Het nieuwe opdrachttype is toegevoegd aan de lijst van mogelijke opdrachten in het schema.

Verwijderd

Vlarebos-functionaliteit volledig verwijderd

Vlarebo’s worden momenteel verwerkt binnen het project beheer-risicolocaties. Gemeentes beheren de data.

  • Root-elementen vlarebos en vlarebosXml verwijderd.

  • Types vlarebo, grondVlarebo, inventarisVlarebo, vlarebos en vlareboWrapper volledig verwijderd.

  • Veld grondVlarebos verwijderd uit het grond-type.

  • Veld inventarisVlarebos verwijderd uit de GINV-opdracht.

  • Verwijzing naar vlarebosXml in de algemene referentietabel verwijderd.

Asbest-gerelateerde velden verwijderd van grond

  • Veld asbestDakWebloket verwijderd.

  • Veld asbestNota verwijderd.

  • Veld asbestPuinlaagWebloket blijft behouden.

Profielanalyse-koppeling vereenvoudigd

  • Het ingebedde blok profieleStaalnameAnalyses (met profielStaalnameAnalyse-elementen) verwijderd uit het profielopdracht-type.

  • Het IDREF-attribuut profielOpdrachtStaalName verwijderd uit het (hernoemde) analyseResultaat-type.

Bestanden

Bestandsnaam

Bestand

GIT Diff (met model_8_9)

Bestandsnaam

Bestand

GIT Diff (met model_8_9)

model_9_0.xsd

 

 

model_validation_9_0.xsd

 

 

Analyses.xsd

Deze schema definitie staat niet expliciet gepubliceerd zoals het voorgaande model, dit is een formaat dat al lang meeloopt en ingeburgerd is bij de Labo’s om data aan te leveren aan de eBSD’s.

De huidige versie hiervan is als volgt:

Bestandsnaam

Versie

Bestand

Bestandsnaam

Versie

Bestand

analyses.xsd

1.0.1 (sinds 18/04/2008)

 

ovam_lookup.xsd

2.0.2 (sinds 18/04/2008)

 

opdracht.xsd

2.0.2 (sinds 18/04/2008)

 

Aanpassingen

  • Nieuw type analyseStaal met velden: naam, topMin, basisMax, commentaar, medium en een lijst van analyseResultaten.

  • Nieuw type analyseResultaat (hernoemd van analyse)

  • Nieuw type samenstellingAnalyseStaal dat een koppeling legt tussen een staalname en een analyseStaal. (Geen koppeling meer tussen staalname en analyseResultaten)

Bestandsnaam

Versie

Bestand

GIT Diff (met vorige versie)

Bestandsnaam

Versie

Bestand

GIT Diff (met vorige versie)

analyses_2_0_0.xsd

2.0.0

 

 

ovam_lookup_3_0_0.xsd

3.0.0

 

 

opdracht_3_0.xsd

3.0.0

 

 

Veldwerk

Er is nergens een expliciete veldwerk.xsd gedocumenteerd, ook niet bij OVAM intern. Het is een partial update op basis van de huidige ondersteunde model.xsd. Omdat Mistral meerdere versies van de model.xsd tegelijk kan ondersteunen, is het de Veldwerk upload zeer permissief op het uploaden van oudere versies. Zolang de achterliggende XSLT-transformaties lukken en valideren naar de huidige model.xsd werkt de import. Dit gaan we niet veranderen, we garanderen echter niet dat oudere modelversies die nu werken, zullen blijven werken.

We garanderen de backwards compatibilty enkel op model_8_9.xsd.