Het script is geschreven in python. Om dit op jouw computer te kunnen uitvoeren, moet je Python geïnstalleerd hebben staan. Geen zorgen, dit is een simpele procedure, en je zal er verder niks van merken.
Als je nog geen Python hebt geïnstalleerd op je systeem, volg dan deze stappen:
- Ga naar de officiële Python-website op python.org.
- Klik op de "Downloads" knop in het menu.
- Kies de versie van Python die overeenkomt met je besturingssysteem (meestal wordt de nieuwste stabiele versie aanbevolen).
- Download het installatiebestand en voer het uit.
- Volg de installatie-instructies op het scherm.
Alternatief kan je als je Windows 10 gebruikt, Python eenvoudig installeren via de Microsoft Store:
- Open de Microsoft Store-app op je Windows 10-computer.
- Zoek naar "Python" in de zoekbalk van de Microsoft Store.
- Klik op de recentste versie van Python die wordt weergegeven in de zoekresultaten.
- Klik op de knop "Installeren" om de installatie te starten.
- Volg de instructies op het scherm om de installatie te voltooien.
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 (template.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. 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".
Wanneer over een bepaald object meerdere rijen aan gegevens moeten ingevuld worden, dan kan dit door de gegevens in de verplichte velden te dupliceren naar de onderstaande rijen en vervolgens de gegevens in de corresponderende kolom toe te voegen.
Een voorbeeld van dit proces wordt weergegeven in onderstaande afbeelding:
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 de volgende commando's uit te voeren (typ het commando en druk op Enter):
python.exe -m pip install --upgrade pip
pip install -r requirements.txt
Nu je een terminal hebt open staan, kan je een van volgende commando's uitvoeren (typ het commando en druk op Enter):
python xls2xml.py
Wanneer het script klaar is, worden de xml bestanden toegevoegd aan de map 'dist'. Indien er zich errors voordoen, krijg je die te zien.
Het is mogelijk om enkele opties aan deze functie toe te voegen:
usage: xls2xml [-h] [-i INPUT_FILE] [-o OUTPUT_FILE] [-m MODE] [-omg OMGEVING] [-s SHEETS [SHEETS ...]]
Function to parse data from xlsx-files to XML ready to be uploaded in DOV
options:
-h, --help show this help message and exit
-i INPUT_FILE, --input_file INPUT_FILE
Input xlsx file that will be parsed to XML, default: data/template.xlsx
-o OUTPUT_FILE, --output_file OUTPUT_FILE
Output file to which the parsed XML-file is outputted, default: dist/dev.xml
-m MODE, --mode MODE Run in local or online mode, options are 'local' and 'online', default: local
-omg OMGEVING, --omgeving OMGEVING
Determines which xsd-schema is used, options are 'ontwikkel','oefen' and 'productie', default:
productie
-s SHEETS [SHEETS ...], --sheets SHEETS [SHEETS ...]
Sheet(s) from excel file that needs to be parsed, by default all sheets will be parsed