Het script is geschreven in javascript en gebruikt Node.js als runtime. Om dit op jouw computer te kunnen uitvoeren, moet je Node.js geïnstalleerd hebben staan. Geen zorgen, dit is een simpele procedure, en je zal er verder niks van merken.
Ga naar de downloadpagina van Node.js: https://nodejs.org/en/download/
Download de LTS versie voor jouw besturingsstysteem. Kies voor de .msi versie (voor Windows gebruikers) of de .pkg versie (voor MacOS gebruikers). Installeer vervolgens Node op je computer door de stappen van de installer te volgen. Je mag bij alle mogelijke tussenstappen op het standaard antwoord laten staan en op Volgende klikken.
Let wel op: mogelijks heb je voor de installatie wel de hulp of rechten nodig van je systeembeheerder.
Klik op de github pagina rechtsboven op download en download de bestanden in een zip formaat. Pak vervolgens het zip bestand uit op je computer. Ben je meer gevorderd met git en github, dan kan je ook altijd de repo forken.
Heb je het script reeds aangeleverd gekregen als zip bestand? Kijk dan zeker op de githubpagina naar de datum van de laatste update. Indien het script recent geupdated is geweest, download je best de nieuwste versie van het script.
Het script vergt aangeleverde data in het juiste formaat. In de map data vind je de Excel-template (Data_input.xlsx) die nodig is voor het aanleveren van de data.
Vul het Excel-bestand in met de data die je in DOV wenst toe te voegen. Als je klaar bent sla je elk blad van de Excel die je wenst toe te voegen op als txt-bestand. De naam van dit txt-bestand moet de naam van het excel blad zijn (bv. grondwaterlocatie.txt, filter.txt, filtermeting.txt, ...). Sla de txt-bestanden op in de map 'data'.
In het excel bestand zijn enkele gegevensvalidaties aanwezig. Zo zijn enkel datums later dan 01/01/1900 toegelaten in velden waar een datum wordt verwacht. Ook zijn er enkele velden waar de optie uit een codelijst moet komen. Deze zijn makkelijk zichtbaar aan de verwijzing in de kolomnamen, die rechtstreeks verwijzen naar de relevante codelijst op het Excel-blad "Codelijsten".
Op het blad Codelijsten zul je zien dat in elke tabel een rood veld aanwezig is. De waarden onder dit veld zijn de waarden die kunnen ingevuld worden in de voorgaande bladen. De andere kolommen bevatten extra informatie omtrent deze attribuutwaarden.
Het script kan uitgevoerd worden met een commando in de terminal. Dit kan op verschillende manieren:
Open je Windows verkenner. Houdt de SHIFT toets ingedrukt en rechtermuisklik op de map met het main script. Er verschijnt een menu, en kies voor de optie 'Open PowerShell venster'.
Open Finder. Rechtermuisklik op de map met het main script. Er verschijnt een menu, en kies voor de optie 'Nieuwe terminal op Map'.
Om het script uit te kunnen voeren moeten er nog een aantal extensies geïnstalleerd worden. Dit kan je eenvoudigweg doen door in de terminal die hebt openstaan het volgende commando uit te voeren (typ het commando en druk op Enter):
npm install
Indien uw netwerk een proxy server vereist voert u het volgende commando uit (vervang PROXYSERVER met de URL naar de proxy server).
npm config set proxy PROXYSERVER
npm config set https-proxy PROXYSERVER
npm install
Nu je een terminal hebt open staan, kan je een van volgende commando's uitvoeren (typ het commando en druk op Enter):
node main -opdracht
voor opdrachtdata of
node main -grondwater
voor grondwaterdata.
Wanneer het script gedaan is, worden de xml bestanden toegevoegd aan de map 'dist'. Indien er zich errors voordoen, krijg je die te zien. Indien u verwijst naar een opdracht in een grondwaterlocatie of filter is het belangrijk dat u eerst de opdracht-xml uploadt.
Wanneer er rijen ongeldig waren werden die overgeslagen in het script. Om meer informatie te krijgen waarom de rijen ongeldig waren, voeg -v toe aan je commando en voer het script op nieuw uit.