V 1.2 14.03.06
1. EINFÜHRUNG...3 1.1 Softwareversion / Konventionen... 3 1.2 Systemanforderungen... 3 1.3 Installation / Deinstallation... 4 1.4 Start... 4 2. BEDIENOBERFLÄCHE...5 2.1 Menüleiste und Shortcuts... 5 2.2 Symbolleiste... 6 2.3 Auswahlfelder... 6 2.4 Anzeigefeld... 6 2.5 Statusleiste... 6 3. AUSWERTUNG...7 3.1 Anzeige der Daten... 7 3.2 Diagramm... 8 3.3 Suche... 8 3.4 Filter... 8 3.5 Protokollnummer... 9 4. ANWENDUNG BEENDEN...10 Dallmeier electronic GmbH &Co.KG 2 / 10
1. Einführung LogConvert ist eine Software die eine bequeme Darstellung und Auswertung der Protokolldatei protocol.txt von Wavelet Rekordern der zweiten und dritten Generation erlaubt. Die Protokollnummern der Protokolldatei werden in Klartext konvertiert und ausgegeben. Der Klartext kann anschließend nach bestimmten Protokollnummern oder Begriffen durchsucht bzw. gefiltert werden. Eine Auswertung nach der Summe der verschiedenen Einträge wird grafisch dargestellt. 1.1 Softwareversion / Konventionen Diese Anleitung ist gültig für die Software LogConvert. Sie wurde auf Basis der Version 2.14 erstellt. In diesem Dokument werden Formatierungen zur Steigerung der Lesbarkeit verwendet. Wort in fett und kursiv weisen auf eine Beschriftung oder einen Klickpfad des Programms hin. Software- oder Gerätenamen werden fett formatiert. 1.2 Systemanforderungen Bezüglich de Systemanforderungen verhält sich die Software LogConvert sehr genügsam. Wir empfehlen die Installation auf einem Dallmeier PVS III bzw. einem Dallmeier SPC 1200 oder auf einem entsprechenden Gerät. Details Dallmeier SPC 1200: Detail Desktop CPU Festplattencontroler RAM BS BS Service Packs Grafikkarte Monitor Ethernet Soundkarte Software Speicherplatzbedarf Anforderung PC (IBM kompatibel) oder Dallmeier PVS III bzw. Dallmeier Security-PC Intel Pentium ab 1,2 GHz oder AMD Athlon ab 1,2 GHz IDE oder SCSI Min.128 MB, Empfohlen 256 MB Microsoft Windows 2000 / XP Empfohlen, jeweils letzte Version VGA kompatibel Min. 64 MB Arbeitsspeicher DirectX fähig Auflösung min. 1024 x 768 Farbtiefe min. 16 Bit 100 MBit/s Optional Min. 16 Bit Microsoft DirectX 8.1 oder höher 200 MB Dallmeier electronic GmbH &Co.KG 3 / 10
1.3 Installation / Deinstallation Installation: 1. Starten Sie die Datei LogConvertInstaller.exe. 2. Folgen sie den Anweisungen der Installationsroutine. 3. Beenden Sie die Installation abschließend mit Finish. Deinstallation: Die Deinstallation des LogConvert können Sie durch Starten der Datei uninstall.exe auslösen. Diese Datei finden sie im Programmverzeichnis. Sie kann auch über das Starmenü (Default: Start / Programme / Dallmeier / LogConvert / Uninstall) aufgerufen werden. 1.4 Start Das Programm kann über die entsprechende Verknüpfung auf dem Desktop oder über das Startmenü (Default: Start / Programme/ Dallmeier/ LogConvert) gestartet werden. Beim ersten Aufruf startet LogConvert in der Sprache, die im Verlauf der Installation gewählt wurde. Dallmeier electronic GmbH &Co.KG 4 / 10
2. Bedienoberfläche Nach dem Start wird LogConvert im Grundzustand angezeigt. 2.1 Menüleiste und Shortcuts Die Menüleiste bietet zunächst die üblichen Optionen zum Arbeiten mit einer Datei. Daneben können Bearbeitungsfunktionen und ein Infofenster aufgerufen werden. Die verschiedenen Einträge der einzelnen Menüs können auch per Shortcut aufgerufen werden. Datei Öffnen... Speichern unter... Drucken... Beenden Bearbeiten Suchen... Protokollnummer... Filter... Hilfe Info Alt+D F U R Strg+X Alt+B S (siehe im Folgenden) (siehe im Folgenden) Alt+H I Dallmeier electronic GmbH &Co.KG 5 / 10
2.2 Symbolleiste Die Bedeutung der Icons wird durch ein Tooltip angezeigt. Dieses wird eingeblendet, wenn der Mauszeiger über einem Symbol stehen bleibt. 2.3 Auswahlfelder Sprache: Auswahl der Sprache für die Auswertung der Protokolldatei und der Oberfläche des LogConvert. Derzeit stehen Deutsch und Englisch zur Verfügung. Version-Nr.: Vor dem Öffnen einer Protokolldatei muss hier die Version der entsprechenden Rekordersoftware eingestellt werden. Die Informationen zu den Protokollnummern können sich je nach Version unterscheiden. Standardmäßig ist der zum Release-Zeitpunkt des LogConvert höchste Versionsstand eingetragen. Achtung: Bei Änderung der Sprache oder Versionsnummer, wird der Inhalt des Anzeigefeldes gelöscht! 2.4 Anzeigefeld Die Auswertung bzw. der Inhalt einer Protokolldatei wird im Feld Protokoll-Nr. / Meldung angezeigt. Beachten Sie, dass Texteingabe- bzw. Bearbeitung nicht möglich ist. 2.5 Statusleiste Am unteren Ende des Applikationsfensters wird die Statusleiste angezeigt. Sie bietet Platz für kontextsensitive Hinweise und die aktuelle Uhrzeit. Dallmeier electronic GmbH &Co.KG 6 / 10
3. Auswertung Achtung: Vor dem Öffnen der Protokolldatei immer die Versionsnummer der Rekordersoftware einstellen! 3.1 Anzeige der Daten Im ersten Schritt müssen Sie die Protokolldatei vom Rekorder exportieren und auf ihrem Arbeitsrechner speichern. Dann kann die Datei über die Menüleiste oder die Symbolleiste geöffnet werden. Die Einträge der Protokolldatei werden konvertiert und als Klartext im Feld Protokoll-Nr. / Meldung angezeigt. Ein Eintrag wird immer mit folgenden Daten dargestellt: - Datum - Uhrzeit - Protokollnummer - Flag (falls vorhanden) - Klartext Folgt (in der ursprünglichen Protokolldatei) nach Datum und Uhrzeit keine Nummer sondern Text (z.b. DAP2-0019 0h), wird dieser ohne Konvertierung angezeigt. Sollte der Klartext zu einer Protokollnummer in der Datenbank des LogConvert nicht vorhanden sein, wird folgende Meldung angezeigt: Keine entspr. Meldung zur angegebenen Protokoll-Nr. vorhanden! In diesem Fall wurde eventuell eine falsche Versionsnummer eingestellt. Wir empfehlen eine Überprüfung. Dallmeier electronic GmbH &Co.KG 7 / 10
3.2 Diagramm Der Button Diagramm ist nur dann aktiv, wenn eine Protokolldatei geöffnet ist. Durch einen Klick wird ein weiteres Fenster angezeigt, in dem die Einträge der aktuellen Datei grafisch dargestellt werden. Jeder Balken repräsentiert eine bestimmte Protokollnummer. Die Länge des Balkens zeigt die Häufigkeit des Protokolleintrags an. Ein Vergleich der verschiedenen Einträge erlaubt den Rückschluss auf die Verteilung der verschiedenen Vorfälle. 3.3 Suche Über Button Suchen oder das Menü Bearbeiten / Suchen kann der Dialog Suchen geöffnet werden. Dieser erlaubt eine Freitextsuche über den gesamten Klartext der Protokolldatei. Die Suche beginnt am Anfang des Textes oder ab der aktuellen Cursor-Position im Text. Bei Erfolg wird die Textstelle markiert und jeder weitere Klick auf Suchen setzt die Suche fort. Wird keine übereinstimmende Textstelle gefunden, wird eine entsprechende Meldung ausgegeben. Beim Start einer neuen Suchaktion ist zu beachten, dass der Cursor an die gewünschte Startposition platziert wird und die Suchrichtung eingestellt wird. 3.4 Filter Über den Menüpunkt Bearbeiten / Filter wird der Dialog Protokollnummern filtern aufgerufen. Er erlaubter die Filterung der Protokolldatei nach einer bestimmten Protokollnummer. Die Darstellung der Ergebnisse entspricht der im Hauptfenster. Durch einen Klick auf den Button Löschen wird die Anzeige der Filterergebnisse gelöscht. Die Daten der Protokolldatei bleiben unberührt. Es kann auch einen Filterung nach mehreren Protokollnummern erfolgen. Liegt das Ergebnis der ersten Filterung vor, dann wird (ohne zu Löschen) eine Nummer eingegeben und die Filterung mit OK Dallmeier electronic GmbH &Co.KG 8 / 10
ausgelöst. Die Ergebnisse der zweiten Filterung werden an die bereits vorliegenden Ergebnisse angehängt. 3.5 Protokollnummer Über den Menüpunkt Bearbeiten / Protokollnummer wird der Dialog Konvertierung einzelner Protokollnummern aufgerufen. Hier kann der Klartext einer einzelnen Protokollnummern ausgegeben werden. Bitte beachten sie, dass auch in diesem Dialog zunächst die richtige Versionsnummer eingestellt werden muss. Neben der Protokollnummer muss das Flag (oder beide) mit angegeben werden. Dabei muss unterschieden werden, ob es sich um einen dezimalen oder hexadezimalen Wert handelt. Entsprechend muss die Check-Box h=hexa je Flag aktiviert oder deaktiviert werden. Flags in Textform werden nicht ausgewertet. Bei Änderung der Version-Nr.: oder der Protokoll-Nr.: wird der Inhalt der Anzeige gelöscht und der Button Anzeigen ist nochmals zu betätigen. Beispiel: Zeile aus protocol.txt, mit hexadezimalen Flags: 15.12.2005 10:09:18 100060 3Ah 1Ah Beispiel: Zeile aus protocol.txt, mit Textausgabe: 15.12.2005 10:09:18 100099 30030h Group 3, Administrator 15.12.2005 10:09:18 100093 0h Link:48 Addr:127.0.0.1 App:PRemote - 1. Flag - h=hex aktivieren - 2. Flag - muss nicht eingegeben werden da es sich um einen Text handelt Dallmeier electronic GmbH &Co.KG 9 / 10
4. Anwendung Beenden LogConvert kann über den Button Beenden, über das System Menü oder über das Menü Datei / Beenden geschlossen werden. Dallmeier electronic GmbH &Co.KG 10 / 10