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 visie van DOV 2030, bekijk dan   deze pagina.

Data governance

Databeheer

DOV biedt 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 deze 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

data aanleveren?

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

Stap 1 -

Intakegesprek met DOV-medewerkers

We starten 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 waar afspraken en volgende stappen stappen worden doorlopen worden.  Maak hiervoor een afspraak via via meldpunt@dov.vlaanderen.be.

Stap 2 -

Rechten toekennen aan

databeheerders

Om data te kunnen inladen in DOV moeten de betrokken gebruikers databeheerders 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 hiervoor het gebruikersbeheer van  de de Vlaamse overheid.
    • stap 1: de medewerker moet krijgt 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 externe organisaties (= i.e. gebruikers die niet voor de Vlaamse Overheid of een lokaal bestuur werken):
  • DOV-medewerkers kunnen voegen nieuwe externe gebruikers toevoegen toe aan het systeem :met volgende gegevens
    • Rijksregisternummer
    • 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: 'eDOV invoerder andere bedrijven' binnen het gebruikersrecht 'Databank Ondergrond Vlaanderen Externe gebruiker'.
• 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.een certificaat dat specifiek is per toepassing.
  • Het proces om een certificaat aan te vragen wordt uitgebreid beschreven op de pagina Data aanleveren via DOV-webservices (API).

Stap 3 - Data aanleveren

Om data te kunnen aanleveren bij DOV moeten een eerst een aantal nieuwe objecten worden aangemaakt, zoals

• putten,
• filters en
• instrumenten en sensoren.

Het toevoegen van metingen kan op verschillende manieren:

• manueel opladen via het DOV Portaal
  • Zowel manueel peilmetingen als peilmetingen in bulk kunnen manueel worden opgeladen via het DOV Portaal.
• automatische opladen van hoogfrequente meetreeksen via DOV-webservices (API)
  • Zo kan de uitwisseling van data tussen je eigen applicatie en DOV geautomatiseerd worden.
  • 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.