Doelstelling

Het gecentraliseerd aanbieden van grondwatermeetdata is één van de doelstellingen van DOV. Denk hierbij aan grondwaterstanden, bodemvochtmetingen en grondwaterkwaliteitsmetingen. DOV ontsluit uiteraard de meetdata van de drie DOV-partners, maar ondertussen ook de meetnetten van o.a. natuurorganisaties, INBO, Curieuzeneuzen, boorbedrijven en een aantal lokale overheden. Daarnaast lopen er bijkomende trajecten met beheerders van meetnetten. Wil je meer weten over deze doelstelling en hoe het aansluit bij de Lange TermijnVisie van DOV 2030, bekijk dan deze pagina.

Data governance

Wat betreft data governance biedt DOV zowel de mogelijkheid om jullie data volledig via DOV te beheren, als om de data in een eigen datasysteem te beheren en enkel ontsluiten via DOV. In beide gevallen wordt het meetnet dan ontsloten samen met alle meetnetten in Vlaanderen, wat een enorm voordeel biedt voor eindgebruikers. In beide gevallen blijft het ook mogelijk om de data via een eigen dataportaal aan te bieden (eventueel toegespitst op specifieke eindgebruikers of streek).

Het gecentraliseerd aanbieden en bevraagbaar maken leidt tot efficiëntiewinsten bij iedereen die met de data aan de slag wil:

• Grondwaterlocaties en meetreeksen kunnen op een uniforme manier worden opgeslagen, bevraagd en gevisualiseerd.
• In de DOV-verkenner zijn ruimtelijke queries mogelijk.
• Jouw metingen kunnen vergeleken of gevisualiseerd worden met metingen van andere meetnetten of organisaties.
• Voor expert-gebruikers biedt pydov dé tools om gericht en reproduceerbaar data binnen te halen in eigen toepassingen.
• Beheerders van kleinere meetnetten hoeven niet te investeren in de ontwikkeling van een eigen beheerplatform.

Hoe kan ik data aanleveren?

Je bent een lokale overheid of een bedrijf dat beschikt over grondwaterdata. Dan staan hieronder de stappen om deze data ter beschikking te stellen via het DOV-platform.

Stap 1 - intakegesprek met medewerkers van DOV

Om jullie data via DOV ter beschikking te stellen, starten we steeds met een kort intakegesprek met één van de DOV-medewerkers. 
Zo kunnen de afspraken en volgende stappen doorlopen worden. 

Maak hiervoor een afspraak via meldpunt@dov.vlaanderen.be

Stap 2 - rechten toekennen aan gebruikers die het databeheer voor hun rekening nemen

Om data te kunnen inladen in DOV moeten de betrokken gebruikers of toepassingen over de nodige rechten beschikken

• Voor medewerkers van een lokaal bestuur:
  • de nodige rechten worden toegekend door de lokale beheerder van het bestuur. De lokale beheerder gebruikt daarvoor de toepassing gebruikersbeheer van  de Vlaamse overheid.
    • stap 1: de medewerker moet rechten worden toegekend binnen de werkrelatie met de betrokken gemeente/stad/provincie.
    • stap 2: de medewerker krijgt rechten op het profiel "eDOV invoerder andere bedrijven" binnen het gebruikersrecht "Databank Ondergrond Vlaanderen Externe gebruiker ".
  • Wenst u na te gaan wie uw lokale beheerder is dan kan dit "Mijn Profiel".
• Voor gebruikers van andere organisaties (= gebruikers die niet voor de Vlaamse Overheid of een lokaal bestuur werken)
  • DOV-medewerkers kunnen gebruikers toevoegen aan het systeem:
    • Ze hebben hiervoor het rijksregisternummer nodig, en het KBO-nummer van de organisatie,
    • Ze voegen een werkrelatie toe met de betrokken organisatie (bedrijf, vzw, ...)
    • Ze voegen de nodige rechten op profielen toe
• Voor toepassingen die automatisch data uitwisselen met DOV via API's of via XML:
  • De toegang wordt beheerd via certificaten (en dus niet met een persoonlijke login). Deze certificaten worden aangemaakt op niveau van de toepassing/server die de data doorstuurt naar DOV.
  • De certificaten worden aangemaakt in overleg met de DOV-medewerkers. Dit loopt als volgt:
    • De DOV-medewerkers hebben volgende info nodig: de naam het bedrijf, het KBO-nummer, een naam voor de aanroepende toepassing en een korte beschrijving van de toepassing. 
    • Op basis van deze informatie voorziet het DOV-team een Common Name (CN) . Deze CN heeft het formaat naambedrijf/dov-services/oefen/naamtoepassing. Er is een apart CN voor de productie- en de oefenomgeving van DOV, en er is voor elk dus een apart certificaat nodig. 
    • Met dit CN maakt het bedrijf een Certificate Signing Request (CSR) aan. In het CSR wordt het CN gecombineerd met de public key van de toepassing.
    • Het bedrijf maakt nu een certificaat aan via de toepassing VO-DCBaaS (https://dcb.vlaanderen.be). Het certificaat kan uit deze toepassing worden gedownload. 
    • De toepassing van het bedrijf moet dit certificaat meesturen bij elke API-call naar DOV (in de HTTP-header).
  • Meer info over het aanmaken van een CSR en voor het aanmaken van certificaten is te vinden op Synchronisatie - gebruik DOV-webservices. 
    • handleiding Private Sleutel en CSR aanmaken
    • handleiding certificaten aanmaken via VO-DCBaaS
    • Voor het gebruik van VO-DCBaas moet de lokale beheerder van het bedrijf de rol DCBaaS Certificatenbeheerder Organisatie toekennen (noot: zie handleiding hoofdstuk 2.2.1 voor info over deze rol). Het toekennen van rollen en rechten gebeurt via https://gebruikersbeheer.vlaanderen.be. De rol DCBaaS Certificatenbeheerder Organisatie is te vinden onder het recht lokaal beheerder gebruikersrechten. De lokale beheerder van het bedrijf kan deze rol toekennen aan elke medewerker van het bedrijf (of zichzelf). Let op: na het toekennen van de rol, kan het even duren voor de rol is doorgestroomd in het systeem.
    • Na het doorstromen van de rollen, kan de medewerker inloggen op de applicatie VO-DCBaas (https://dcb.vlaanderen.be). In deze toepassing kunnen de certificaten worden aangemaakt. 

Stap 3 - data aanleveren

Data aanleveren bij DOV bestaat uit het aanmaken van nieuwe objecten (zoals putten, filters of sensoren) en het toevoegen van manuele of automatische metingen.

Dit kan op verschillende manieren:

• manueel via het DOV-webportaal: via de invoervensters van de webtoepassing kan je nieuwe objecten aanmaken, editeren en verwijderen. Je kan er ook meetwaarden toevoegen,
• manuele bulkingave via het DOV-webportaal: meerdere objecten of metingen kunnen gelijktijdig worden ingegeven door een bestand op te laden in het webportaal (XML, CSV of XLS-bestanden), 
• automatische uitwisseling via webservices: hiermee kan de uitwisseling van data tussen je eigen applicatie en DOV geautomatiseerd worden,