[[TOC(heading=Omgeving, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Omgeving/)]]
[[TOC(heading=Procedures, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Procedures/)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]

= Vektis Berichten =

Vektis berichten zijn kolom-gebaseerde berichten: een bericht bestaat uit records, een per regel. Er staan geen scheidingstekens in een record, elk veld heeft een vaste grootte. OpenAC heeft een tool(tje) om de inhoud van deze berichten te lezen
in een GUI-applicatie.

Met enige regelmaat is er een nieuwe versie van de Vektis-berichten behorende bij een van de declaratiestandaarden (bijvoorbeeld standaard ZH308 zit nu in versie 9). Zo'n nieuwe versie wordt vergezeld door nieuwe bericht-formaten. Deze pagina beschrijft ook een makkelijke manier om een nieuwe versie op te nemen in OpenAC.

== Berichten Bekijken ==

De (ontwikkelaars) tool `zhviewer` kan gebruikt worden om een 
Vektis-bestand te bekijken op een iets makkelijkere manier 
dan als lange regels tekst.

 1. Sla het EI-bericht ergens op. Onthoud welke standaard bij dit bericht hoort (bv. ''aw319'' of ''zh309'').
 1. Start een command-prompt in de OpenAC installatie-directory. Voer dit uit:
{{{
Python27\python.exe tools\zhviewer.py -t <standaard>
}}}
 1. De viewer start op en je kan een bestand kiezen om te bekijken. Je kan ook de naam van het te-bekijken-bestand opgeven in de commando-regel.


== Nieuwe Berichttypes Opnemen ==

 1. Begin met een Vektis-bestandsformaat Excel sheet. Open de sheet en sla de sheet daarna op als TSV bestand (in OpenOffice Calc is dat ''File'' -> ''Save As'' en dan kies je ''Text CSV'' als formaat). Let op dat je bij het opslaan een '''tab''' als scheidingsteken kiest.
 1. Open dit TSV bestand in een tekst editor en haal de bovenste regels weg die overeenkomen met de beschrijving van het sheet; je wilt dat de eerste regel de kolom-kopjes zijn (rond regel 10 staan ze, iets als ''Standaardcode'''tab'''Recordnaam'''tab'''...''). Sla het gewijzigde TSV bestand op in de OpenAC map `kern/f080_vektis` onder een naam die verwijst naar de standaard. Gebruik extensie `.txt`. Ondhoud de naam (bv. ''AW319v14'' of ''ZH309v80'').
 1. Draai vervolgens het (Python) programma `zhmaker.py`. Ga naar de  OpenAC installatie-directory en voer dit uit:
{{{
Python27\python.exe bin\zhmaker.py <naam-van-standaard>
}}}
 Gebruik hierbij alleen de naam, zonder extensie `.txt`.
 Als er helmaal niks op het scherm verschijnt, is de Python-code voor de berichten in de standaard aangemaakt; kijk in de map `kern/f080_vektis`, daar zie je een Python-file met dezelfde naam als de standaard, met extensie `.py`. Controleer even of het er redelijk uitziet.
 1. Voeg de `.txt` en de `.py` bestanden toe aan OpenAC SVN. Commit ze.
 1. Voeg een regel toe aan `tools/zhviewer.py` om de standaard daar toe te voegen.
 De dictionary ''berichttypes'' geeft voor elke standaard een herkenning
 van verschillende versies van de standaard en een bijbehorende Python- module om berichten van die standaard te lezen.