Protokolle

Protokoll-Integration ins GaZMa

Protokolle sind Textdateien, in die zusätzliche Daten (neben den Standard-GaZMa-
Daten) eingegeben werden können.
Protokolle sind frei definierbar. Fest stehender Text, sowie Eingabepositionen
können definiert werden. Ev. gibt es in der MonDa Dokumentation noch mehr Infos.

Protokolle, die für die Monda-Geräte geschrieben wurden können nun auch im GaZMa
aufgerufen und bearbeitet werden. Ist ein Auftrag offen, so kann man das passende
Protokoll mit <Strg> und <1>, <2> usw. aufrufen. Der Name des Protokolles wird aus
"Baustellenkürzel"-"ZählerArt"-"NummerDerProtokollAlternative".txt zusammengesetzt.
Protokolle werden im Verzeichnis .\Protokolle erwartet.

Muss man Änderungen an einem Protokoll machen, so ruft man das Protokoll mit
<Shift>&<Strg> und <1>, <2> usw. auf.

Variablen-Namen werden mit "$" eingeleitet, und insofern sie nicht nur ein
Ankreuzfeld sind, auch mit einem "$" abgeschlossen. Der Variablen-Name ist immer
2 Buchstaben lang. Handelt es sich dabei um eine Zahl 01 .. 99, so ist es keine
"echte" Eingabe-Position sondern ein Datenfeld, das aus GaZMa rauskopiert wird. Eine
Liste der Feldnummern befindet sich im Dokumentationsverzeichnis
.\Hinweise für GaZMa. Macht man eingaben in diese festen GazMa felder hat dies
keine Auswirkung.

Gibt es pro Baustelle mehrere Protokolle sollten eindeutige Variblennamen ver
wendet werden. z.B.

Protokoll 1 -> AA bis AZ, BA bis BZ
Protokoll 2 -> CA bis CZ, DA bis DZ
Protokoll 3 -> EA bis EZ, FA bis FZ
Protokoll 4 -> GA bis GZ, HA bis HZ
Protokoll 5 -> IA bis IZ, JA bis JZ

Datenausgabe: GaZMa erzeugt Ausgabedaten im bekannten .csv Format. In der Regel
jedoch ohne Protokolldaten. In der Baustelle kann man jedoch die Ausgabe der
csv-Dateien incl. der Protokoll-Eingaben ermöglichen.
Dazu "Baustelle", Reiter "Protokolle" das Häcken "Ausführlichen Protokollausgabe"
aktivieren.

Es werden nur die Protokoll-Felder ausgegeben, die in der Feld-Tabelle angeben
sind. Sind alle Protokolle definiert, und auch schon Daten eingegeben, so
drücken Sie "alle möglichen Werte neu ermitteln".
Übergeben Sie ev. Protokolle aus dem Verzeichnis "./Protokolle" dem
Auftraggeber, damit ihm klar wird was sich z.B. hinter der Spalte "V1" verbirgt.

Werden Protokolldaten mit ausgegeben erscheint der Ausgabewartenbalken als
voller Balken, ansonsten ist dieser Balken unterbrochen (da nur ein Teil der Daten
ausgegeben wird).

Ist schon eine Feldreihenfolge mit dem Auftraggeber vereinbart sollten neue Felder
nur hinten angefügt werden. die Funktion "alle möglichen Werte neu ermitteln"
fügt die neuen Spalten-Namen immer hinten an.

Ist noch keine Feldreihenfolge mit dem Auftraggeber vereinbart empfiehlt es sich
die Spaltennamen ev. inhaltlich oder vom Namen her zu sortieren, damit die Daten
de zusammengehören auch zusammen sind.

Zusammenfassung der Protokoll-Steuerzeichen

fester Text "Lücke für Eingabe"   ¦    $V1.....$
^ beliebig
            ^hier beginnt Ihr Eingabefeld
                                       ^ leite die Variable ein
                                        ^ V1 heisst später die Spalte
                                             ^ durch die Punkte bestimmen sie
                                               die Länge
                                               ^ Hier ist das Ende erreicht
Ankreuzfeld [ ]                   ¦          $P1
^ beliebiger fester text
            ^ eckige Klammer umschliessen immer das Ankreuzfeld
                                             ^Ankreuzfelder werden ohne 2. "$"
                                              angegeben

Benennung der Protokoll-Dateien.

im GaZMa finden sich die Dateien im Verzeichnis .\Protokolle. Sie werden
folgendermassen benannt:

 <Kürzel der Baustelle><Zählerart><Protokollvariante>.txt

 Bei <Protokollvariante> = "1" wird die Ziffer "1" NICHT angegeben! Beispiel:
 Baustelle KARL: es gibt "G" und "W" Zählertypen: die möglichen Protokolle sind
 somit:

 GaZMA/Monda
 ===========

 KARLG.TXT, KARLW.TXT

 GaZMA

 KARLG2.TXT, KARLW2.TXT
 KARLG3.TXT, KARLW3.TXT
 KARLG4.TXT, KARLW4.TXT
 KARLG5.TXT, KARLW5.TXT