...
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"
| Tip |
|---|
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. |
...
- Een aantal velden verwachten een waarde uit een codelijst. Andere waardes zijn niet toegelaten. De codelijsten met toegelaten waardes zijn voorlopig nog niet gestructureerd gedocumenteerd. Maar onderstaande tabel geeft voor enkele van de velden een API-call waarmee de codelijst kan opgevraagd worden (opgelet: deze api-calls zijn intern bedoeld, en kunnen dus onverwacht wijzigen). Voor een aantal velden kan dit ook teruggevonden worden in de XSD-bestanden die voor XML-bestanden gebruikt worden.
Opgelet: de api-calls hieronder zijn voor de productie-omgeving. Voor de oefen-omgeving moet de base-url worden aangepast naar XXXX
Nog aan te vullen - een veld 'code' of 'id' bevat altijd een string, dus met quotes. Ook als dit een getal bevat, bv. "code": "4".
- datumformaat is anders dan in XML: nl. dd-mm-yyyy HH:MM:SS (en niet yyyy-mm-dd zoals in de XML-bestanden). De tijdscomponent is verplicht.
3.1 Tips en Troubleshooting
Hieronder enkele fouten die kunnen voorkomen:
- Wanneer je een nieuw instrument probeert aan te maken: "Access is denied"
- Test of de certificaten goed werken via de healthcheck "/chucknorris".
- Kijk het object 'Databeheerder' na: dit ziet er als volgt uit: "databeheerder": { "id": "8", "kbonummer": "OVO000092", "naam": "VMM" }. Gebruik de call uit de tabel hierboven om een lijst te krijgen met alle databeheerders, Zoek naar je eigen databeheerder, daarin staat het juiste formaat.
- Wanneer je een nieuw instrument probeert aan te maken: "Referentie moet uniek zijn binnen organisatie" of "Er bestaat reeds een instrument met serienummer xxxxx":
- Het veld 'referentie' en 'serienummer' moet uniek zijn. Je kan dus geen twee instrumenten hebben met exact dezelfde referentie en/of serienummer.
- Ofwel heb je geprobeerd hetzelfde instrument opnieuw aan te maken van scratch, dat lukt dus niet omdat het al bestaat. Verwijder het bestaande instrument eerst, alvorens je het opnieuw aanmaakt. Je kan ook de permkey van het instrument meegeven in de json. Dan wordt dit beschouwd als een update-operatie, en worden alle velden overschreven met de nieuwe waarde.
- Ofwel heb je geprobeerd een instrument aan te maken met een referentie die al bij een ander instrument gebruikt wordt. In dat geval kan je bv. de serienummer toevoegen aan de referentie om de string uniek te maken.
- Wanneer je een nieuw instrument probeert aan te maken: "Sensoridentificatie niet mogelijk aan het instrument.":
- Gebruik de call uit tabel hierboven voor de codetabel sensoridentificatie. Kijk na of de combinatie sensortype (jsonlocatie=sensordata>sensoren>sensorIdentificatie>code) en instrument type (jsonlocatie=metadata>type>code) voorkomt in de lijst. Indien niet, best DOV contacteren om dit te laten rechtzetten.
- Wanneer je een instrument probeert te koppelen aan een grondwater- of bodemlocatie: "Unparseable date: "2020-06-01"
- het datum-formaat in de json-bestanden is dd-mm-yyyy HH:MM:SS (en niet yyyy-mm-dd zoals in de XML-bestanden). Het tijdscomponent is verplicht.
3. Een CSV-bestand opladen via RESTfull API
...