Eens je de nodige rechten hebt kan je fiches aanmaken in het DOV-portaal. Dit kan a) manueel via het DOV-portaal, b) in bulk door bestanden op te laden in het DOV-portaal, of c) door automatische uitwisseling via DOV-services. Deze pagina beschrijft stap-voor-stap hoe de automatische uitwisseling via DOV-services gebeurt (optie c).
Algemene info over gebruik van DOV-services is ook te vinden op de pagina "synchronisatie - gebruik DOV-webservices". Er is een voorbeeldscript te vinden waarin putten, filters en instrumenten worden aangemaakt en uitgelezen via Python. Dit script kan gedownload worden via de link https://www.milieuinfo.be/confluence/download/attachments/160110598/instrumenten_api_demoscript-master.zip?api=v2.
Dit werkt voor een hele reeks objecten: boring, put, filter, grondwaterlocatie, manuele metingen, ...
In het XML-bestand maak je een XML-object aan. Dit XML-object start met een specifieke tag (<grondwaterlocatie> voor put-objecten, en <filter> voor filter-objecten). Tussen de start- en eindtag van het object (bv. <filter> en </filter>) worden de andere eigenschappen van het object toegevoegd met hun eigen tags. Deze tags zijn specifiek voor DOV en worden gecontrolleerd via een XSD-bestand, waarin gedocumenteerd wordt welke tags toegelaten zijn, en wat ze precies betekenen. Er is een apart XSD-bestand voor objecten van het grondwatermeetnet. Meer informatie over validatie van XML-bestanden en het XML-formaat van DOV is te vinden op de pagina over het xml-import-uitwisselingsformaat.
Voorbeeld van XML-bestanden en een oplijsting van de belangrijkste velden die je moet meegeven, kan je vinden op de pagina "Data toevoegen via XML-bestanden"
Elke fiche in DOV heeft ook een XML-variant. Die kan je opvragen door achter de url van de fiche "?format=xml" toe te voegen. Bv. https://www.dov.vlaanderen.be/data/put/2022-101201 wordt dan https://www.dov.vlaanderen.be/data/put/2022-101201?format=xml. |
Hulpmiddel: het excelbestand metadata_wells.xlsx kan helpen om gemakkelijk de xml-bestanden aan te maken.
|
Het algemene stappenplan staat uitgelegd op de pagina "Case 1: Opladen van XML-bestanden voor boorbedrijven"
Er is een voorbeeldscript beschikbaar op XXXX Nog aan te vullen
Dit werkt momenteel enkel voor instrumenten, sensoren en links tussen sensor/gwlocatie.
Relevante info is te vinden in de API-guide. Specifiek moet je kijken naar volgende demo's:
Op deze pagina's staan telkens een uitgewerkt voorbeeld van het json-bestand dat in een POST-request moet worden meegegeven, en een tabel waarin alle velden worden opgelijst en beschreven.
Enkele nuttige tips:
Dit werkt voor HF-metingen (loggermetingen).
Consulteer de API-guide → Demo 4 . In de demo zoeken naar de subtitel 'CSV bestand'.
Het formaat staat beschreven in Bulkingave via het DOV-portaal#Stap1:maakeencsv-bestandaan
Via een POST-request wordt het CSV-bestand opgeladen naar de server. Daar komt het in een verwerkingsqueue. Het kan dus even duren voor de nieuwe data verwerkt wordt, en zichtbaar wordt in schermen (typisch 1 tot enkele minuten). De POST-request geeft een ImportLogID terug, waarmee de status van de verwerkingsjob kan opgevraagd worden.