TOC(heading=Vektis, sectionindex, compact, depth=4, allactive, Documentatie/Ontwikkelaar/Omgeving/Vektis/)? TOC(heading=Omgeving, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Omgeving/)? 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).
2. Start een command-prompt in de OpenAC installatie-directory. Voer dit uit:

   Python27\python.exe tools\zhviewer.py -t <standaard>
   

3. 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.
2. 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 StandaardcodetabRecordnaamtab...). 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).
3. 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.
4. Voeg de .txt en de .py bestanden toe aan OpenAC SVN. Commit ze.
5. 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.