| | 1 | = Vektis Berichten = |
| | 2 | |
| | 3 | == Berichten Bekijken == |
| | 4 | |
| | 5 | De (ontwikkelaars) tool `zhviewer` kan gebruikt worden om een |
| | 6 | Vektis-bestand te bekijken op een iets makkelijkere manier |
| | 7 | dan als lange regels tekst. |
| | 8 | |
| | 9 | 1. Sla het EI-bericht ergens op. Onthoud welke standaard bij dit bericht hoort (bv. ''aw319'' of ''zh309''). |
| | 10 | 1. Start een command-prompt in de OpenAC installatie-directory. Voer dit uit: |
| | 11 | {{{ |
| | 12 | Python25\python.exe tools\zhviewer.py -t <standaard> |
| | 13 | }}} |
| | 14 | 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. |
| | 15 | |
| | 16 | |
| | 17 | == Nieuwe Berichttypes Opnemen == |
| | 18 | |
| | 19 | 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. |
| | 20 | 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''). |
| | 21 | 1. Draai vervolgens het (Python) programma `zhmaker.py`. Ga naar de OpenAC installatie-directory en voer dit uit: |
| | 22 | {{{ |
| | 23 | Python25\python.exe bin\zhmaker.py <naam-van-standaard> |
| | 24 | }}} |
| | 25 | Gebruik hierbij alleen de naam, zonder extensie `.txt`. |
| | 26 | 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. |
| | 27 | 1. Voeg de `.txt` en de `.py` bestanden toe aan OpenAC SVN. Commit ze. |
| | 28 | 1. Voeg een regel toe aan `tools/zhviewer.py` om de standaard daar toe te voegen. |
| | 29 | De dictionary ''berichttypes'' geeft voor elke standaard een herkenning |
| | 30 | van verschillende versies van de standaard en een bijbehorende Python- module om berichten van die standaard te lezen. |
