Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Beschrijving vraag CSV bestand voor Wagenpark Verrijking

Algemeen

De vragen worden opgegeven in een CSV formaat. Elke lijn bevat 1 vraag. 

Hieronder een overzicht van de flow die op deze pagina behandeld wordt.

CSV input formaat

Het bestand dat aangeleverd wordt moet voldoen aan al volgende richtlijnen

  • UTF-8 encoding

  • Geen header rij. De eerste rij moet effectieve gegevens bevatten

  • De volgorde van de velden moet voldoen aan onderstaande lijst

  • De velden worden afgebakend met dubbele aanhalingstekens (")

  • De velden worden gescheiden door een punt-komma (;)

  • Lege velden worden steeds weergegeven door twee opeenvolgende dubbele aanhalingstekens. Velden worden nooit weggelaten

  • Geen line feed na de laatste datalijn, bestand eindigt m.a.w. bij het laatste karakter van de laatste datalijn

Bestandsnaam

<Prefix>_<Naam LEZ inrichter>_<Omschrijving> _<Referte UUID>_<Tijdstip aanmaak bestand>.<Extensie>

De vraagbestanden dienen door de LEZ inrichter op de daarvoor bestemde FTP folder geplaatst te worden:

  • /antwerpenctod/to_vip/

  • /gentctod/to_vip/

Indien aan de vormvereisten voldaan is, verloopt de verdere verwerking automatisch. De duurtijd van verwerking is afhankelijk van de grootte van de aangeleverde bestanden. De FTP verwerking loopt elk uur en elke 10 minuten vóór het uur. De start van een verwerking kan dus maximaal 50 minuten in beslag nemen afhankelijk van het moment van opladen van de bestanden.

Gegeven

Omschrijving

Voorbeeld

Prefix

Verwijzing naar Wagenpark verrijking, vast formaat “Wagenpark_LEZ”

Wagenpark_LEZ

Naam LEZ inrichter

Naam van de LEZ inrichter. Kan dus Antwerpen of Gent zijn op dit moment

Antwerpen

Gent

Omschrijving

Omschrijving van de inhoud van het bestand, vrij te bepalen

2022_week38

Referte UUID

Unieke referte van de aangeleverde lijst, 128-bit, 36 tekens, structuur 8-4-4-4-12.
Deze referte laat toe om het vragen document te koppelen aan het resultaat document.

78852dd8-69d2-11e6-8b77-86f30ca893d3

Tijdstip aanmaak bestand

Datum en tijdstip van aanmaak bestand, formaat YYYYMMDDHHMMSSSSS

20190524081035123

Extensie

Extensie waarmee het bronbestand wordt aangeleverd

CSV

Voorbeeld

Wagenpark_LEZ_Antwerpen_2022_week38_78852dd8-69d2-11e6-8b77-86f30ca893d3_20160824081035123.csv

Detail

Veld Nr

Veld

Kardinaliteit

Omschrijving

1

Referte

[1..1]

UUID, unieke referte per vraag (wordt niet gevalideerd). Deze referte wordt gebruikt om de vraag aan het antwoord te koppelen

3

Nummerplaat

[1..1]

Nummerplaat van het voertuig waarvoor voertuigkenmerken moeten verrijkt worden.

4

LandISOCode

[1..1]

ISO land code van het voertuig waarvoor we gegevens willen registreren.

5

DatumVoertuigkenmerken

[1..1]

De datum waarop de geldende voertuigkenmerken voor de nummerplaat moeten gezocht worden.
Formaat: jjjj-mm-dd

6

ResultaatToegangscontrole

[0..1]

Eén van volgenden waarden:

  • Toegelaten

  • NietToegelaten

  • TeControleren

Deze info wordt niet gebruikt door de verwerking, maar is gewoon aanwezig omdat dezelfde stroom gebruikt wordt om resultaat bestanden van een toegangscontrole te verrijken met voertuig gegevens.

Validaties

In de verwerking van de het CSV bestand wordt geen inhoudelijke validatie gedaan, enkel de validatie op de CSV structuur en of de gegevens ingevuld zijn.

Indien het formaat technisch niet voldoet, dan blokkeert de verwerking zonder terugkoppeling.

Voorbeelden

"Ref1";"TXAG863";"BE";"2023-04-17";"TeControleren" "Ref2";"1YVN011";"BE";"2023-04-17";"TeControleren" "Ref3";"1CJQ348";"BE";"2023-04-17";"TeControleren"

Excel bestand met bovenstaande data en CSV exporteer macro

OPGELET

De macro in dit Excel bestand is getest binnen MAGDA en dient enkel als voorbeeld om een correct CSV bestand aan te maken. MAGDA biedt geen support op deze code.

 

Op deze pagina


Binnen deze handleiding


Met vragen kunt u steeds terecht bij de MAGDA Service Desk.

 


Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid

uitgegeven door Digitaal Vlaanderen