gerwitim-log benutzerhandbuch desktop versionen demo, free und personal edition programmversion handbuchversion 2.0

Transkript

1 desktop versionen demo, free und personal edition programmversion handbuchversion 2.0

2 Copyright Dieses Handbuch sowie die darin beschriebenen Programme und Module sind urheberrechtlich geschützt. Das Copyright besitzt die gerwitim UG und deren Lizenzgeber. Ohne schriftliche Einwilligung der gerwitim UG dürfen dieses Handbuch oder Teile daraus sowie die darin beschriebenen Programme weder kopiert noch weiterverarbeitet werden. Zuwiderhandlungen werden zivil- und strafrechtlich verfolgt. Die Anfertigung einer persönlichen Sicherheitskopie bleibt davon unberührt. Die kostenlose Demoversion darf beliebig kopiert und weitergegeben werden, sofern diese nicht verändert wurde, keine Anpassungen (wie z.b. eine persönliche Konfigurationsdatei, Aufgabenliste oder Logdatei) enthält und dieses Handbuch einschließlich dieses Copyright Vermerks enthält. Die Nennung von Namen erfolgt in diesem Handbuch ohne Erwähnung bestehender Patente, Warenzeichen oder Gebrauchsmuster. Das Fehlen eines solchen Vermerks begründet nicht die Annahme, die Namen seien frei benutzbar. Warenzeichen werden ausnahmslos anerkannt. gerwitim UG (haftungsbeschränkt) Frankenweg Brigachtal Zuletzt geändert am 7. Juni 2013 Seite 2

3 Inhaltsverzeichnistsverzeichnis 1 Einführung Download und Installation Systemvoraussetzungen Download Installation Lizenzierung Anpassen der Startkommandos Einrichten des automatischen Programmstarts Konfiguration Eintragen eines Lizenz-Codes Erstellen der Aufgabenliste Tasklist Editor im Konfigurator Manuelle Erstellung der Aufgabenliste Konfiguration der Applikation Anpassen der Sprache Anpassen der Funktionalität Einstellen des Datenservers Bedienung Kommandozeile GUI Menü Programm Programm Beenden Aufgabenliste Laden Konfiguration Log Editor Datenübertragung Auswertung Datum von-bis Aktueller Monat Heute Menü Sonstiges Unterbrechung Zuletzt geändert am 7. Juni 2013 Seite 3

4 Anmerkung Manuelle Zeit Menü Aufgaben Aktivität Pause Aktivität Feierabend Loggen einer Aktivität REP Report für den aktuellen Monat Report Von-bis Datum Report für den aktuellen Tag LST ADD Allgemeine Hinweise Zeitreisen Technischer Support Konfigurationsparameter Konfiguration der Dateinamen Benutzeroberfläche Hauptmenü Fenster Anmerkung Fenster Manuelle Eingabe der Uhrzeit Fenster GUI Reporter Fenster Konfiguration Fenster Log Editor LogEdit Find Manual Add Report Generator Zuletzt geändert am 7. Juni 2013 Seite 4

5 1 Einführung gerwitim-log Um die Kosten komplexer und personalintensiver Projekte unter Kontrolle zu halten und um die angefallenen Personalkosten Verursacher gerecht verteilen und abrechnen zu können, müssen Daten erfasst werden, welche die einzelnen Tätigkeiten der Mitarbeiter möglichst exakt widerspiegeln. Die Qualität der Verrechnung hängt wesentlich davon ab wie detailliert diese Erfassung erfolgt. Einer hinreichend detaillierten Datenerfassung sind aber ohne Einsatz geeigneter Werkzeuge gewisse Grenzen gesetzt da ohne diese insbesondere bei Mitarbeitern die für mehrere Projekte oder sogar für verschiedene Kunden parallel arbeiten der Aufwand der Zeiterfassung bei zunehmendem Feinheitsgrad signifikant ansteigt. Dennoch steigt auch die Tendenz bei Kunden und Projektleitern, diese Daten von den Mitarbeitern möglichst exakt erfasst zu fordern. Um dem Problem des Aufwands für die Zeiterfassung entgegen zu wirken wird dabei nicht selten die für die Zeiterfassung selbst benötigte Zeit nicht als Projektzeit anerkannt. Diese Abwälzung des Aufwands wird jedoch von vielen Projektmitarbeitern nicht akzeptiert was zu einer sinkenden Motivation und damit wiederum zu einer wenig aufwändigen, dafür aber auch ungenauen Zeiterfassung durch den Mitarbeiter führt. Zur Zeiterfassung werden meist manuelle Verfahren eingesetzt, von der einfachen Papierliste die mit dem Stift in der Hand ausgefüllt wird bis hin zu ausgefeilten MS-Excel Arbeitsblättern, die automatische Reports generieren können. Diesen Systemen gemein ist aber, dass die Daten durch den User (nach)erfasst werden, im günstigsten Fall täglich, im ungüntigsten Fall werden diese Zahlen zum Ende des Berichtszeitraums so gut dies noch geht geschätzt. Eine Lösung dieses Problems ist das Tool gerwitim-log, ein Werkzeug, das eine kostengünstige und effiziente Zeiterfassung am PC ermöglicht. Es schließt bereits in der kostenlosen Version einen Reportgenerator zum Auswerten der Daten ein. Gerwitim-log wurde in der weitgehend Plattform unabhängigen Programmiersprache Java entwickelt und ist damit auf unterschiedlichsten Systemen (wie z.b. Unix, Windows, MAC OS usw.) lauffähig. Dieses Handbuch orientiert sich bei den meisten Beispielen oder Bildschirm-Fotos am Microsoft Windows Vista Betriebssystem. gerwitim log sieht auf allen unterstützten Plattformen ähnlich aus. Die MS Windows basierten Beispiele können auch für die anderen Plattformen als Referenz genutzt werden. Wurden alternative Betriebssysteme oder Komponenten verwendet ist dies im Einzelfall entsprechend gekennzeichnet. Des Weiteren basieren diese Beispiele auf den deutschsprachigen Beispieldateien der Installationsdateien. Individuell angepasste oder übersetzte Umgebungen können ggf. Unterschiede aufweisen. Zuletzt geändert am 7. Juni 2013 Seite 5

6 2 Download und Installation 2.1 Systemvoraussetzungen Für das Programm gerwitim-log wird eine funktionsfähig installierte Java Laufzeitumgebung (JRE) in der Version 1.6 oder aktueller vorausgesetzt. Die Anforderungen an Hard- und Software für gerwitim-log entsprechen dabei denen der JRE. Benutzer der Enterprise Version benötigen darüber hinaus einen funktionsfähigen Internet Anschluss um die Funktionen zur Datenübertragung nutzen zu können. Diese Anleitung bezieht sich nicht auf die gerwitim-log Version für Mobiltelefone. Die hier beschriebene gerwitim-log Version ist auf Mobiltelefonen nicht lauffähig. 2.2 Download Das Programm gerwitim-log kann vom gerwitim Internet Server unter geladen werden. Der dort bereitgestellte Code läuft mit der enthaltenen Lizenz im Demo Modus. Eine Umstellung auf die Free-, Personal- oder Professional Edition ist durch eine Änderung des Lizenzschlüssels in der Konfigurationsdatei ohne Neuinstallation des Programms möglich. 2.3 Installation Die im Flogenden dargestellte Installationsmethode funktioniert auf allen Plattformen, auch unter Windows. Für Windows Benutzer (alle Versionen) befindet sich im Downloadbereich aber auch eine komfortablere Version die den Benutzer durch die Installation führt, manuelle Anpassungen sind damit nicht notwendig. Eine separate Anleitung für die Windows installation befindet sich ebenfalls im Downloadbereich. Zur Installation des Programms wird das heruntergeladene ZIP Archiv in einen Ordner entpackt. Ein dedizierter Ordner ist für gerwitim-log nicht unbedingt notwendig, wird aber empfohlen. Bei Microsoft Windows basierten Systemen empfehlen wir, die Dateien in das Verzeichnis C:\Programme\gerwitim\timelogger 1 zu installieren. Da hierfür jedoch auf vielen Systemen Berechtigungen des Administrators notwendig sind, können die Dateien grundsätzlich auch in jeden beliebigen anderen Ordner installiert werden sofern die nötige Berechtigung zum Schreiben im gewählten Ordner vorhanden ist. Auch die Installation in ein Verzeichnis im Netzwerk ist prinzipiell möglich, wird jedoch nicht empfohlen, da Das Programm nur funktioniert, wenn der Pfad zur Log Datei existiert; bei kurzzeitiger Unterbrechung der Netzwerkverbindung können u.u. keine Einträge in die Logdatei geschrieben werden. Das Programm dann u.u. von mehreren Benutzern gestartet werden kann. Dies kann in bestimmten Fällen dazu führen, dass verschiedene Benutzer die selbe Logdatei verwenden was letztendlich zu falschen Reports führen kann. In vielen Unternehmen wird das Benutzer-Verzeichnis ( Home Share ) über Server im Netzwerk 1 Der Pfad C:\Programme kann abhängig von der Windows Version und Sprache abweichen, bei einigen Systemen kann der Installationspfad auch C:\Program Files lauten. Zuletzt geändert am 7. Juni 2013 Seite 6

7 bereitgestellt. In solchen Umgebungen ist i. d. R. sichergestellt, dass jeder Benutzer ein eigenes Verzeichnis bekommt und dass lokale Kopien dieser Daten mit dem Server synchronisiert werden, d. h. die oben geschilderten Nachteile treten in solchen Umgebungen normalerweise nicht auf. Fragen Sie Ihren Netzwerk-Administrator ggf. um Rat. Als Basis für individuelle Anpassungen sollte eine der jeweils mitgelieferten Beispielkonfigurationen verwendet werden. Dazu werden die entsprechenden Konfigurationsdateien kopiert, z.b. durch die Eingabe der Kommandos in einer CMD.EXE Kommandozeile 2. Benutzer die sich bei der Eingabe von Kommandozeilen unsicher fühlen sollten ggf. ihren Systemadministrator um Rat fragen. copy gerwitim_log.properties_de gerwitim_log.properties copy tasks.txt.de tasks.txt Bild 1: Kopieren der Konfigurationsdateien auf einem Windows System 2.4 Lizenzierung Die Lizenzen von gerwitim-log werden mit Ausnahme der Demo-Lizenz grundsätzlich per Mail an die registrierte Adresse versendet. Der Lizenzcode muss aus dieser in die Konfigurationsdatei übertragen werden. Hierzu können die Standardfunktionen des Editors (Kopieren, Einfügen) verwendet werden. 2.5 Anpassen der Startkommandos Da gerwitim-log plattformunabhängig ist und keinerlei Betriebssystem spezifische Einstellungen benötigt, kann das Programm in nahezu jeden Dateiordner eines Systems installiert werden. Dies erfordert jedoch, dass die beigefügten Windows CMD Startdateien entsprechend angepasst werden müssen. Beispielhaft sei dies für die Datei timelog.cmd beschrieben, die Anpassungen für addline.cmd, timelist.cmd und timerep.cmd sind entsprechend durchzuführen OFF cd "c:\programme\gerwitim\timelogger" java -jar gerwitim_log.jar GUI Bild 2: Anpassung der Startdatei auf einem Windows System In dieser Datei ist lediglich in der zweiten Zeile der absolute Pfad durch den Installationspfad zu ersetzen. Im Zweifelsfall hilft der gerwitim Kundensupport gerne bei der Anpassung der Dateien weiter. 2 bei Linux oder Unix basierten Systemen lautet dieses Kommando cp gerwitim_log.properties.de gerwitim_log.properties (analog für die Datei tasks.txt) und wird in einem Terminal Fenster wie z.b. xterm ausgeführt. 3 Linux und Unix Benutzer orientieren sich an den Shell Scripten mit der Endung.sh. Zuletzt geändert am 7. Juni 2013 Seite 7

8 2.6 Einrichten des automatischen Programmstarts Eine professionelle Zeitdatenerfassung mit gerwitim-log ist nur dann sinnvoll möglich, wenn das Programm immer verfügbar ist. Dazu wird empfohlen, es mit jeder Benutzeranmeldung automatisch zu starten. Dazu kann das Programm bei Windows Systemen in die Autostart Gruppe kopiert werden, Unix Benutzer werden das Programm z.b. in ihre.profile Datei eintragen. Zuletzt geändert am 7. Juni 2013 Seite 8

9 3 Konfiguration 3.1 Eintragen eines Lizenz-Codes Im bereitgestellten Paket befindet sich eine Demo Lizenz mit der die kostenlose Version voll funktionsfähig ist. Benutzer der Demoversion können diese mit einem entspechenden Lizenzschlüssel zur Free Edition umstellen wobei der einzige Unterschied dieser beiden Versionen darin besteht, dass im Reporter der Hinweis auf die Demo entfällt und stattdessen der registrierte Benutzer angegeben wird. Damit werden diese Reports hinsichtlich der Vorlage bei Kunden oder Agenturen aufgewertet. Um den Lizenzschlüssel zu aktivieren muss die Datei gerwitim_log.properties mit einem Unicode fähigen Texteditor (z.b. notepad.exe bei einem Windows System)angepasst werden. Die Lizenz besteht in der Desktop-Version aus drei Werten der Datei gerwitim_log.properties, die exakt eingegeben werden müssen. Die entsprechenden alten Werte müssen ersetzt oder auskommentiert werden.!--- JTL LICENSE SECTION --- LicUsername=demo LicCode=1B7B F5D1C5C1D5F12660B E5A A5E0359 LicLevel=2! Bild 3: Lizenzcode in der Konfigrationsdatei LicUsername enthält den Benutzernamen, normalerweise die Adresse des registrierten Benutzers. Dieser Wert wird auch auf dem gerwitim-log Report ausgegeben. LicCode enthält einen verschlüsselten Fingerprint der aus verschiedenen Werten errechnet wird. LicLevel ist ein numerischer wert mit dem Funktionen des Programms ein- bzw. ausgeschaltet werden, abhängig vom Funktionsumfang der Lizenz. Die Datei gerwitim_log.properties muss im Unicode Format gespeichert werden, da sonst Sonderzeichen oder Bezeichnungen in Sprachen die auf anderen Zeichensätzen basieren nicht korrekt angezeigt werden können. Der folgende Ausschnitt zeigt einen Teil des Dialogs Speichern Unter in notepad.exe. Bild 4: Auswahl der Kodierung in Notepad.exe Zuletzt geändert am 7. Juni 2013 Seite 9

10 3.2 Erstellen der Aufgabenliste Tasklist Editor im Konfigurator In den Versionen Personal, Professional und Enterprise, nicht aber in den beiden kostenlosen Versionen Demo und Free steht ein grafischer, baumorientierter Editor für die Erstellung und Pflege der Aufgabendatei zur Verfügung. Dieser wird über das Menu Programm -> Konfiguration gestartet. Eine Anleitung zum Starten von gerwitim-log befindet sich im Kapitel 4 Bedienung ab Seite 17. Bild 5: Menu für Konfigurator Um die Aufgabenliste zu editieren wird im Konfigurationsmodul der Reiter Aufgabenliste gewählt. In der Baumansicht können neue Aufgaben angelegt und existierende Aufgaben geändert oder gelöscht werden. Bild 6: Erstellung der Datei tasks.txt mit den grafischen Editor Zuletzt geändert am 7. Juni 2013 Seite 10

11 Um eine Änderung an der Aufgabenliste durchzuführen wird die entsprechende Aufgabe mit der rechten Maustaste ausgewählt (um eine neue Aufgabe hinzuzufügen wird der übergeordnete Ordner bzw. die übergeordnete Aufgabe gewählt - eine Übergeordnete Aufgabe wird dabei automatisch zum Ordner). Bild 7: Ändern der Aufgabenliste Maßgeblich für die zu ändernde Aufgabe ist grundsätzlich die Position des Mauszeigers, das ist auch dann der Fall, wenn eine andere Aufgabe/Ordner durch einen Mausklick bereits selektiert ist. Im Beispiel oben wird eine neue Aufgabe zum Ordner timelogger hinzugefügt, die Selektion des Ordners Kunde Migosirca bleibt unberücksichtigt. Zuletzt geändert am 7. Juni 2013 Seite 11

12 Wird als Änderung Hinzufügen oder Ändern gewählt, so erscheint der gewählte (bzw. der neu hinzugefügte) Menüeintrag als editierbares Feld innerhalb der Baumansicht. Bild 8: Hinzufügen eines Menüeintrags Der Standardtext? kann an dieser Stelle sofort oder später über die Ändern Funktion angepasst werden. Dabei ist darauf zu achten, dass eine Änderung des Textes immer mit der Enterbzw. Return-Taste abgeschlossen werden muss. Ist dies nicht der Fall und wird z. B. ein anderer Eintrag des Baumes selektiert oder der Editor mit Speichern + Ende geschlossen so wird die Änderung nicht übernommen und die neue Aufgabe mit dem Namen? abgespeichert. Zuletzt geändert am 7. Juni 2013 Seite 12

13 Bild 9: Änderung eines Menüeintrags Um die Änderungen zu übernehmen müssen diese noch mit der Speichern oder der Speich. + Ende Schaltfläche in die Datei tasks.txt übernommen werden. Mit der Schaltfläche Neu Laden im Konfigurationsfenster wird der zuletzt gespeicherte Zustand wieder hergestellt, d.h. alle seit dem letzten Speichern gemachten Änderungen werden rückgängig gemacht. Änderungen an der Aufgabenliste, insbesondere Löschen oder Ändern haben keine Auswirkung auf bereits erfasste Einträge in der Kog-Datei. Durch die Auswahl des Menüeintrags Programm -> Aufgabenliste Laden oder über einen Neustart des Programms werden die Änderungen in den Arbeitsspeicher übernommen und sind damit verfügbar. Bild 10: Geänderte Aufgabenliste neu laden Zuletzt geändert am 7. Juni 2013 Seite 13

14 3.2.2 Manuelle Erstellung der Aufgabenliste Der grafische Editor für die Aufgabenliste existiert nicht in den kostenlosen Versionen. Daher muss in diesen die Aufgabenliste manuell mit Hilfe eines Texteditors erstellt bzw. gewartet werden. Der Name dieser Datei kann in der Konfigurationsdatei angepasst werden, der Standardwert ist tasks.txt im aktuellen Verzeichnis. In dieser Datei werden die Aufgaben hierarchisch d.h. von oben nach unten dargestellt wobei bei untergeordnete Einträge immer alle übergeordneten Elemente enthalten müssen (d. h. eine neue Aufgabe enthält immer auch den kompletten Pfad des Ordners). Dabei ist auf eine einheitliche Groß- / Kleinschreibung zu achten. Dieses Verfahren kann in allen Programmversionen verwendet werden, also auch dann, wenn ein grafischer Editor vorhanden ist. Manuell durchgeführte Änderungen werden vom grafischen Editor berücksichtigt, ggf. muss dieser dazu jedoch neu geöffnet werden. Wie die Datei gerwitim_log.properties ist auch die Aufgabenliste im Unicode Format gespeichert. Beim Anpassen dieser Datei in einem manuellen Texteditor ist darauf zu achten, dass das Unicode Speicherformat nicht geändert wird, auch dann, wenn diese Datei keine Unicode Zeichen enthält. In die Aufgabendatei können keine Kommentare aufgenommen werden. Beispiel: Eine tasks.txt wie unten abgebildet würde zum gleichen Ergebnis führen wie die in Bild 6 gezeigte Konfiguration. No Project Kunde Migosirca Kunde Migosirca\Vertrieb Kunde Migosirca\Vertrieb\Werbekampagne Blueballs Kunde Migosirca\EDV Kunde Migosirca\EDV\Projekt VoIP Schnoflach GmbH Schnoflach GmbH\Serverbetrieb Telkom gerwitim gerwitim\timelogger gerwitim\timelogger\development gerwitim\timelogger\documentation Bild 11: Manuelle Erstellung der Datei tasks.txt 3.3 Konfiguration der Applikation Zuletzt geändert am 7. Juni 2013 Seite 14

15 Die Konfiguration von gerwitim-log erfolgt über die Konfigurationsdatei gerwitim_log.properties. Zeilen die in dieser Datei mit dem Wert! beginnen sind Kommentare und dienen der besseren Lesbarkeit. Alle anderen Werte in der Konfigurationsdatei sind im Format parameter=wert gespeichert und werden als Konfigurationsparameter interpretiert Anpassen der Sprache Gerwitim-log ist in allen Versionen nahezu vollständig konfigurierbar. Dazu gehören auch die Menüs der Applikation und Eigenschaften wie Überschriften in Report oder Parameter für den Datenexport in CSV Dateien 4. Das Installationspaket enthält Beispieldateien für deutsche und englische sowie in einigen Versionen auch russische Konfigurationen. Die Konfiguration in Russisch veranschaulicht die Verwendung von unterschiedlichen Zeichensätzen. Um andere Sprachvarianten zu erzeugen kann die Datei gerwitim_log.properties mit einem beliebigen Texteditor der das Unicode Format unterstützt beliebig individuell angepasst werden. Die übersetzbaren Texte der Benutzeroberfläche werden im Kapitel 7 Konfigurationsparameter ab Seite 30 aufgelistet Anpassen der Funktionalität Neben der Konfiguration der Benutzeroberfläche enthält die Datei gerwitim_log.properties auch Parameter zur Steuerung des Programms. Hier kann beispielsweise die Position des Programms auf der Benutzeroberfläche oder die Dateinamen von Aufgabenliste und Logdatei festgelegt werden. Eine detaillierte Auflistung der einstellbaren Parameter befindet sich im Kapitel 7 Konfigurationsparameter ab Seite 30. Die in den Beispieldateien eingestellte Grundkonfiguration sollte den meisten Anwendern genügen. 4 CSV, also Kommaseparierte Dateien können nicht mit den kostenlosen Versionen von gerwitim-log erstellt werden. Zuletzt geändert am 7. Juni 2013 Seite 15

16 3.3.3 Einstellen des Datenservers Der Datenserver kann nur in den Versionen Professional und Enterprise eingestellt werden. Der Server wird nur dann benötigt, wenn gerwitim-log auf mehreren Rechnern oder in Kombination mit gerwitim-mobile z.b. auf Mobiltelefonen eingesetzt wird und für einen Report die Ergebnisse zusammengeführt werden müssen. In den Versionen Demo, Free und Personal sind die Funktionen zur Datenübertragung und die Konfigurationdieser Funktionen abgeschaltet. Bild 12: Konfiguration der Datenübertragung Zuletzt geändert am 7. Juni 2013 Seite 16

17 4 Bedienung gerwitim-log Die Bedienung des Programms gerwitim-log basiert auf dem Prinzip, dass die Zeiten für jede Tätigkeit einschließlich aller Pausen und sonstigen arbeitsfreien Zeiten protokolliert werden. Werden alle Tätigkeiten einer Kategorie zusammengefasst, ergibt sich in der Summe die für eine Aufgabe oder ein Projekt aufgewendete Zeit. Wird ein gerwitim-enterprise Server oder die Professionelle Version im Team auf dem öffentlichen Server eingesetzt, so können z. B. Projektleiter Reports mir den kumulierten Zeiten aller Mitarbeiter ihrer Teams oder Gruppen erstellen und erhalten damit Daten für eine sehr detaillierte und genaue Planungs-, Fortschritts- und Kostenkontrolle. 4.1 Kommandozeile Nahezu alle Funktionen des Programms gerwitim-log können über Kommandozeilenparameter gesteuert werden, diese Optionen gelten für alle Versionen des Programms. 4.2 GUI Um die Grafische Benutzeroberfläche zu starten wird das Programm gerwitim-log mit der Option GUI in der Kommandozeile gestartet. Beispiel: java -jar gerwitim_log.jar GUI Bild 13: Kommandozeile zum Start der Benutzeroberfläche. Die Benutzeroberfläche präsentiert sich minimalisiert und erscheint im Normalzustand nur als Menüzeile. Bild 14: Minimale Benutzeroberfläche Erscheint dieses Menü auf dem Desktop zu gross kann es durch Anpassung der Übersetzung in der Date gerwitim_log.properties angepasst werden, z.b. durch Überschriften wie P / S / A. Zuletzt geändert am 7. Juni 2013 Seite 17

18 4.2.1 Menü Programm gerwitim-log Das Menü Programm dient der Steuerung von gerwitim-log. Hier finden sich sämtliche Einträge ohne direkten Zusammenhang mit der eigentlichen Zeiterfassung Programm Beenden Damit wird das Programm beendet. Da die Projektzeiterfassung eine kontinuierliche Aufgabe ist und ein entsprechendes Tool daher immer einsatzbereit sein sollte, wird dieser Menüpunkt nur benötigt um das Programm komplett neu zu initialisieren (d.h. unmittelbar nach Programmende erneut zu starten) oder um auch noch die letzte verfügbare Ecke des Hauptspeichers für eine Applikation mit sehr großem Bedarf an Arbeitsspeicher freizugeben. Wird das Programm beendet und anschließend wieder gestartet, so gehen alle nicht persistenten Daten (das sind alle Einstellungen die im Menü Sonstiges gemacht wurden) verloren. Die Aufgabenliste sowie alle erfassten Zeitdaten bleiben erhalten Aufgabenliste Laden Wird die Aufgabenliste geändert während das gerwitim-log GUI Programm läuft (das ist beispielsweise immer dann der Fall wenn dazu das Konfigurationsmodul verwendet wird) so muss die Aufgabenliste neu in den Arbeitsspeicher geladen werden. Ein automatisches Laden findet auch im GUI basierten Konfigurationsmodul bewusst nicht statt, da Konfigurationsänderungen typischerweise mit geringer Priorität durchgeführt werden und durch nahezu jedes Ereignis unterbrochen werden kann. gerwitim-log sollte in einem solchen Fall sofort und wie gewohnt bereit stehen. Eine halbfertige Veränderung der Aufgabenliste könnte hier kurzzeitig zu Verwirrung führen und den Arbeitsablauf kurz aber empfindlich stören Konfiguration Die wesentlichen Einstellungen und Funktionen des Konfigurators wurden bereits im Kapitel 3 Konfiguration ab Seite 9 beschrieben. Im Konfigurationsmodul ist zu beachten, dass Änderungen erst mit drücken der Schaltflächen Speichern oder Speich. + Ende dauerhaft gespeichert werden. Zuletzt geändert am 7. Juni 2013 Seite 18

19 Log Editor gerwitim-log Der Log Editor bietet die Möglichkeit, die bisher protokollierten Ereignisse unverschlüsselt zu sehen und (eingeschränkt) nachträglich zu verändern. Während der Editor geöffnet wird ist das gerwitim-log Hauptmenü nicht sichtbar um Log Einträge zu verhindern während der Log Editor geöffnet ist. Es gibt unter Suchen eine einfache Suchfunktion um nach einem bestimmten Text oder Textausschnitt in den gespeicherten Aufgaben und Anmerkungen zu suchen. Bild 15: Log Editor mit Suche Die Suchfunktion unterscheidet zwischen Groß- / Kleinschreibung, d. h. der Suchbegriff oder der Teil daraus muss exakt eingegeben werden. Platzhalter wie * sind nicht möglich. Wird ein Eintrag mit der Maus per Doppelklick ausgewählt so wird dieser markiert und ist editierbar. Um die Änderungen dauerhaft zu speichern muss eine der Speichern Funktionen im Menü Logdatei gewählt werden. Dies kann bei großen Logdateien abhängig von der Rechnerleistung einige Sekunden dauern. In einem protokollierten Ereignis kann der Text, nicht jedoch der Zeitstempel geändert werden. Um ein Ereignis nachträglich zeitlich zu verschieben (wenn beispielsweise kurz vor Monatsabschluss die letzten Stunden geschätzt und daher manuell eingegeben wurden) muss ggf. zuerst ein neuer nachträglicher Eintrag (über den Menüpunkt Manuelle Zeit ) erstellt und anschließend der Text des ursprünglichen Eintrags geändert werden. Änderungen werden erst dann dauerhaft abgespeichert, wenn im Log Editor der Menüpunkt Speichern oder Speichern + Ende ausgewählt wurden 5. 5 Der Log Editor erscheint auf den ersten Blick sehr spartanisch und unkomfortabel - und soll auch so sein. Nachträgliche Änderungen an der Logdatei sollen zwar grundsätzlich möglich sein, aber nicht komfortabel genug, dass solche Nacherfassungen aus Bequemlichkeit zum Normalfall werden, da diese die Datenqualität reduzieren würden. Zuletzt geändert am 7. Juni 2013 Seite 19

20 gerwitim-log Die Funktion Log Editor ist in den kostenlosen Versionen von gerwitim-log nicht enthalten. Ein ähnliches Ergebnis lässt sich jedoch mit etwas manuellem Aufwand über eine Kombination aus den Funktionen LST und ADD erzielen. Die Funktion Sortieren und Speichern dient der Abspeicherung der Logdatei nach Zeitstempel sortiert. Sie sollte nur verwendet werden, wenn eine Logdatei tatsächlich auch neu sortiert werden muss, da sie in der Ausführung signifikant langsamer ist als die normale Speichern Funktion. Im Normalfall ist die Liste im Logeditor nach Zeitstempel sortiert Datenübertragung Die Funktion Datenübertragung ist nur in den Versionen Professional und Enterprise verfügbar Auswertung Um die gespeicherten Ereignisse auch auswerten zu können enthält das Programm gerwitimlog ein Auswertungsmodul. Dieses kann in allen Versionen über eine Kommandozeile aufgerufen werden (vgl. 4.3 REP, Seite 24). Ab der Version Personal ist diese Funktion auch als Option im Menü der Benutzeroberfläche verfügbar. Dieses Modul kann über die Konfigurationsdatei gerwitim_log.properties gesteuert werden. Durch entsprechende Einträge können beispielsweise Überschriften konfiguriert werden oder das Erstellen eines html basierten Reports ein- oder ausgeschaltet werden. Eine detaillierte Auflistung der Konfigurationsmöglichkeiten für die Auswertung befindet sich im Kapitel 7 Konfigurationsparameter ab Seite 30. Aus der Benutzeroberfläche aufgerufen öffnet sich zuerst ein Fenster zur Eingabe der Parameter für die Auswertung. Hier kann das Zeitfenster für die Auswertung definiert werden. Beim Menü in der Abbildung handelt es sich um das gerwitim-log Hauptprogramm, dass zu diesem Zeitpunkt weiter genutzt werden kann. Alle Einträge bis zum Start der Auswertung mittels Erstellen Schaltfläche werden in der Auswertung berücksichtigt sofern diese im entsprechenden Zeitfenster des Reports eingegeben wurden Datum von-bis Bei der Eingabe eines Start- und Endedatum ist darauf zu achten, dass beide eingegebenen Tage im Report berücksichtigt werden. Im Beispiel (Bild 16: GUI Auswertung...) würde eine Auswertung vom 19. September, 0:00 Uhr bis zum 19. Oktober, 23:59 Uhr erstellt. Bild 16: GUI Auswertung - Parametereingabe Zuletzt geändert am 7. Juni 2013 Seite 20

21 Aktueller Monat gerwitim-log Die Auswahl Aktueller Monat bewirkt eine Auswertung des von der Systemzeit abhängigen Kalendermonats. Eine solche Auswahl z.b. am Ersten November 2009 würde zu einem Report im Zeitraum vom ersten November 2009 bis zum 30. November 2009 führen, auch dann, wenn der überwiegende Teil des Auswertungszeitraums in der Zukunft liegt. Diese Einstellung auch während eines laufenden Monats zeigt sich in der Praxis als ein nützliches Werkzeug für eine Abschätzung der Gesamtstundenzahl zum Monatsende um ggf. durch geeignete Massnahmen Budgets optimal ausnutzen zu können Heute Die Auswahl Heute bewirkt eine Auswertung für den aktuellen Kalendertag von 0 Uhr bis 23:59. Ein Report für den aktuellen Kalendertag kann beispielsweise genutzt werden um kurzfristig nach Zeitfressern zu suchen. Bild 17: GUI Auswertung Menü Sonstiges Das Menü Sonstiges enthält Funktionen die nicht die direkte Steuerung des Programms betreffen, andererseits aber auch nicht direkt zu Einträgen in die Log Datei führen. Die Einträge führen vielmehr zu Veränderungen des jeweils nächsten Log Eintrags. Eine Einstellung die im Menü Sonstiges gemacht wird, wird mit dem darauf folgenden Log-Eintrag wieder zurückgesetzt. Zuletzt geändert am 7. Juni 2013 Seite 21

22 Bild 18: Menü Sonstiges Unterbrechung Bei der Unterbrechung handelt es sich nicht um eine Unterbrechung der Arbeit insgesamt (vgl. Pause auf Seite 24) sondern um eine Unterbrechung der aktuellen Aufgabe durch eine andere Tätigkeit. Die Menüauswahl Unterbrechung führt zu einem Zwischenspeichern der Uhrzeit. Das darauffolgende Ereignis wird mit dieser Uhrzeit in die Log Datei geschrieben. Das Klassische Beispiel einer Unterbrechung ist ein Telefonanruf, bei dem der Angerufene anfangs nicht weiss um welche Art der Tätigkeit es sich handelt. Dies kann oft, ggf. nach etwas Smalltalk erst sehr viel später festgestellt werden. Ist durch eine Unterbrechung ein Zeitstempel zwischen gespeichert, so wird dieser in einem sog. Tooltip angezeigt, wenn der Mauszeiger auf den Menüeintrag Unterbrechung positioniert wrid. Ein erneuter Mausklick bei bereits aktivierter Unterbrechung bewirkt, dass der bereits gemerkte Zeitstempel wieder gelöscht, und die Markierung des Menüs zurückgesetzt wird Anmerkung Gelegentlich reicht die Struktur der Aufgabenliste nicht aus um eine Tätigkeit vollständig zu beschreiben. Bei einmalig notwendigen erweiterten Beschreibungen ist aber auch eine Erweiterung der Aufgabenliste nicht sinnvoll. Eine eingegebene Anmerkung wird an den nächsten Log-Eintrag angefügt. Um die Anmerkung zu erkennen wird dieser das Zeichen # vorangestellt. Eine automatische Anmerkung wird erreicht, wenn in der Aufgabenliste eine Aufgabe mit dem # Zeichen endet. Dies ist dann sinnvoll, wenn zu einem Standardvorgang beispielsweise eine Vorgangsnummer (wie etwa die Nummer eines Service-Tickets) oder eine andere Kennung (wie etwa kostenpflichtig / kostenlos ) eingegeben werden muss. Der Eingabedialog der Anmerkung wird in diesem Fall automatisch geöffnet. Die Funktion Anmerkung einschliesslich der automatischen Anmerkung ist in den kostenlosen Versionen nicht enthalten. Hier können solche Anmerkungen über die Funktion ADD realisiert werden Manuelle Zeit Über die Eingabe einer manuellen Zeit können Log Einträge auch dann erfolgen, wenn das Ereignis nicht zum aktuellen Zeitpunkt stattfindet sondern in der Vergangenheit oder sogar in der Zukunft liegt. Zuletzt geändert am 7. Juni 2013 Seite 22

23 Bild 19: Manuelle Eingabe des Zeitstempels. Ein manuell eingegebener Zeitstempel wird beim nächsten Ereignis-Log abgespeichert, die Sekunden werden bei manuell eingegebenen Zeitstempeln mit dem Wert 00 gespeichert. Ein manuell eingegebener Wert ist nur kurzfristig, d. h. für einen unmittelbar danach erfolgten Log-Eintrag, gültig; nach etwa 5 Minuten nach Eingabe des manuellen Wertes geht das Programm davon aus, dass die manuelle Zeiteingabe irrtümlich vorgenommen wurde oder bereits überholt ist und speichert den folgenden Log-Eintrag mit der aktuellen Systemzeit. Im Zweifelsfall wird empfohlen, manuelle Einträge mit Hilfe des log-editors zu verifizieren. Diese Funktion ist in den kostenlosen Versionen nicht verfügbar, entsprechende nachträgliche oder vorgezogene Log-Einträge können mit der ADD Funktion realisiert werden. Wird nach einer gewählten Unterbrechung die Zeit manuell eingegeben so hat diese Manuelle Eintragung vor der Zeit der Unterbrechung Priorität, d. h. die für die Unterbrechung markierte Zeit wird verworfen. Mit dieser Funktion lassen sich - wie auch mit der ADD Funktion - auch Zeitstempel in der Zukunft eingeben. Dabei ist allerdings darauf zu achten, dass bis zu einem in der Zukunft liegenden Zeitstempel über die Benutzerschnittstelle keine Aufgaben gelogged werden dürfen, da dies u. U. zu einer nicht chronologischen Reihenfolge der Einträge in der Log Datei führen kann. Einträge in der Zukunft müssen daher sehr sorgfältig geplant und bei weiteren Logs entsprechend berücksichtigt werden. Um eine fehlerhafte Logdatei neu nach Zeitstempel zu sortieren kann der Logeditor verwendet werden Menü Aufgaben Das Menü Aufgaben dient dem Loggen von Aktivitäten. Die Struktur wird aus der Aufgabenliste erstellt. Zusätzlich zur Struktur der Aufgabenliste enthält das Aufgabenmenü zwei Einträge für arbeitsfreie Zeiten. Das Hauptmenü Aufgaben dient zusätzlich der Anzeige der zuletzt gespeicherten Aktivität in einem Tooltip 6. 6 Diese Tooltips funktionieren nicht in den kostenlosen Versionen. Ein Tooltip wird angezeigt, wenn gerwitim-log die Aktive Anwendung ist. Die Tooltips zeigen evtl. einen falschen Wert an, wenn der letzte Logeintrag nicht durch normales loggen entsatnden ist sondern Beispielsweise wuch einen manuellen Eintrag. Im zweifelsfall kann der hier angezeigte Wert mit Hilfe des Log Editors verifiziert werden. Die Tooltips sind über einen entsprechenden Eintrag in der Konfigurationsdatei abschaltbar. Zuletzt geändert am 7. Juni 2013 Seite 23

24 Aktivität Pause gerwitim-log Die Aktivität Pause wird für kurze arbeitsfreie Zeiten genutzt. Die Pause darf nicht mit der Unterbrechung verwechselt werden, da bei der Unterbrechung davon ausgegangen wird, dass die der Unterbrechung unmittelbar folgende Zeit Projekt- oder zumindest Arbeitszeit darstellt während die als Pause markierte Zeit i. d. R. als Freizeit bewertet wird Aktivität Feierabend Neben der Pause gibt es als arbeitsfreie Zeit auch den Feierabend, d. h. die Arbeit wird für den Tag beendet. Mit Hilfe der Unterscheidung von Pause und Feierabend Aktivität ist es beispielsweise möglich An- und Abwesenheiten nachzuvollziehen Loggen einer Aktivität Zum Loggen einer Aktivität wird - nachdem ggf. die Zeit manuell eingegeben, eine Unterbrechung gewählt und/oder eine Anmerkung eingegeben wurde - ein Untermenu in der Aufgaben- Hierarchie per Mausklick ausgewählt. Es können nur Elemente der untersten Ebene ausgewählt werden, d. h. Menüeinträge für die In der Aufgabenliste weitere Teilaufgaben definiert sind können nicht direkt gelogged werden. 4.3 REP Die REP Option in der gerwitim-log Kommandozeile dient der Erstellung einer Auswertung (=Report) in Scripten oder wenn die Benutzeroberfläche dazu nicht gewünscht wird. In den Kostenlosen Versionen ist diese Option die einzige Möglichkeit, Auswertungen zu erstellen. In Scripten können die ausgegebenen Daten ggf. angezeigt, weiterverarbeitet, konvertiert und/oder ausgedruckt werden. Zusätzlich zur REP Option akzeptiert das gerwitim-log Programm noch weitere optionale Kommandozeilenparameter Report für den aktuellen Monat Wird kein weiterer Parameter angegeben, so erstellt gerwitim-log eine Auswertung für den aktuellen laufenden Monat. Diese Funktion entspricht der Auswahl aktueller Monat in der GUI basierten Auswertung. Wird ein einzelner Parameter eingegeben so wird dieser als Monat des aktuellen Jahres interpretiert, die Werte erstrecken sich von 1 (Januar) bis 12 (Dezember). Die Eingabe eines Monats in der Zukunft führt zur Erstellung eines Berichtes ohne Daten (sofern nicht beispielsweise mit der ADD Funktion Daten in der Zukunft gelogged werden). Beispiele Für die folgenden Beispiele wird angenommen, dass der Report am 15. Juli 2010 angefordert wird. In diesen Beispielen wird die Langform der Kommandos verwendet. Für einige Plattformen liegen der Installation Scripte wie z.b. timerep.cmd bei. Bei der Verwendung dieser Scripte ist der Anfang der jeweiligen Kommandozeilen durch das Script zu ersetzen; eine Eingabe von timerep.cmd 5 wäre demnach gleichbedeutend mit java -jar gerwitim_log.jar REP 5. Zuletzt geändert am 7. Juni 2013 Seite 24

25 java -jar gerwitim_log.jar REP erstellt eine Auswertung für den laufenden Monat. java -jar gerwitim_log.jar REP 5 erstellt eine Auswertung für den Monat Mai java -jar gerwitim_log.jar REP 12 java -jar gerwitim_log.jar REP 13 erstellt eine leere Auswertung da der Monat Dezember in der Zukunft liegt. erzeugt einen Fehler Report Von-bis Datum Wie in der GUI Auswertung ist es auch mit der kommandozeilenbasierten Auswertung möglich, das Intervall für diese Auswertung festzulegen. Dabei werden wie in der GUI Version beide angegebenen Daten in der Auswertung berücksichtigt. Das Datumsformat der Kommandozeile ist JJJJMMTT (vier Ziffern für die Jahreszahl, zwei Ziffern für den Monat und zwei Ziffern für den Tag). Beispiele java -jar gerwitim_log.jar REP java -jar gerwitim_log.jar REP Java -jar gerwitim_log.jar REP java -jar gerwitim_log.jar REP java -jar gerwitim_log.jar REP erstellt eine Auswertung für den Zeitraum vom 26. April 2008 bis zum 25. Mai erstellt eine Auswertung für das erste Quartal (Januar bis März) erzeugt einen Report für den 31. Oktober 2009 erzeugt einen Fehler da der Parameter als Monatszahl interpretiert wird. erzeugt einen Fehler Report für den aktuellen Tag Um einen Report für den aktuellen Tag zu erstellen wird die Option Von Bis gewählt. Da Startund Endedatum im Report enthalten sind muss für eine Auswertung für Nur Heute das aktuelle Tagesdatum doppelt eingegeben werden. Das Format ist wie im Kapitel Report von bis Datum auf Seite 25 beschrieben einzugeben. Zuletzt geändert am 7. Juni 2013 Seite 25

26 4.4 LST gerwitim-log Die LST Funktion erstellt eine unverschlüsselte Auflistung der bisher protokollierten Ereignisse. Die Liste erscheint auf der Standard-Ausgabe, sie kann aber über die Umleitungsfunktion des Betriebssystems in eine Datei gespeichert werden. Diese Datei kann dann mit einem Unicode fähigen Texteditor (z. B. notepad.exe auf Windows basierten Systemen) betrachtet werden. Eine solche Umleitung ist insbesondere dann sinnvoll, wenn das Kommandozeilenprogramm Unicode nicht fehlerfrei darstellen kann. Beispiel Im folgenden Beispiel wurde auf einem Windows System eine Auflistung erstellt und in eine Datei Liste.txt umgeleitet. Die Eingabe hat keinerlei Ausgabe auf dem Bildschirm bewirkt. Bild 20: Erstellen einer Auflistung in eine Datei 4.5 ADD Ähnlich der Eingabe einer manuellen Zeit in der Benutzeroberfläche können mit der ADD Funktion Ereignisse nachträglich protokolliert werden, z.b. wenn ein Ereignis aus einer Situation entsteht in welcher der gerwitim - log Computer nicht in Reichweite ist oder wenn der ursprüngliche Eintrag aus anderen Gründen nicht möglich war. Zuletzt geändert am 7. Juni 2013 Seite 26

27 Bei nachträglichen Eingaben mit Hilfe der ADD Funktion müssen die Zeitangaben an die Einstellung der Systemzeit / Zeitzone angepasst eingegeben werden, da gerwitim-log intern alle Zeiten in UTC (GMT) umrechnet. Befindet sich beispielsweise ein Benutzer mit einem für Deutschland konfigurierten System (GMT + 1) in Moskau (GMT + 3) und will einen Eintrag für 14:00 (Moskau Zeit) nachträglich erfassen, so muss bei der Eingabe die für Deutshland entsprechende Uhrzeit (also 12:00) eingetragen werden. Würde der selbe Rechner vor der Eingabe auf die Zeitzone in Moskau eingestellt so wäre keine Anpassung durch den Benutzer notwendig und die lokale Zeit (also 14:00) einzugeben. Die Daten werden nicht wie bei normalen Logs einfach hinten angehängt sondern chronologisch einsortiert um die Integrität der Logdateien zu gewährleisten. Daher kann es bei der kommandozeilenbasierten Erfassung eines Ereignisses ggf. zu kurzen Wartezeiten kommen. Zur Erfassung eines Ereignisses mittels der ADD Funktion sind zwei Parameter anzugeben: Zeit: die Zeit wird im Format YYYYMMDDhhmmss eingegeben, wobei YYYY das Jahr vierstellig, MM der zweistellig einzugebende Monat und DD der Tag (auch zweistellig) ist. hh bezeichnet die Stunden (zweistellig im 24h Format, in der lokalen Zeitzone des Rechners), mm die Minuten (zweistellig) sowie ss die Sekunden (auch diese zweistellig). Aufgabe: Text der Logzeile. Dieser Text kann frei gewählt werden, wobei zu beachten ist, dass dieser im Report separat aufgeführt wird wenn er nicht exakt den in der Datei tasks.txt definierten Aufgaben entspricht. Wenn der log-text Leerzeichen enthält muss der Parameter in Anführungszeichen eingegeben werden. Warnung: Wird diese Funktion genutzt während das Modul Log Editor der GUI geöffnet ist werden die hinzugefügten Daten in bestimmten Situationen nicht persistent gespeichert. Da das kommandozeilenbasierte Modul vom Log Editor (der als Teil der Benutzeroberfläche läuft) entkoppelt läuft, kann eine parallele Nutzung beider Funktionen technisch nicht ohne weiteres verhindert werden. Mit der ADD Funktion sollten in der Zukunft liegende Ereignisse nur mit grösser Vorsicht eingetragen werden, da dies bei späterem Gebrauch der GUI zu einer falschen Sortierung der Log Datei führen kann. Falsch sortierte Dateien können mit den Hilfsmitteln der kostenlosen Version nicht repariert werden. Der in den Versionen Personal, Professional und Enterprise enthaltene Log Editor kann jedoch solche Dateien automatisch reparieren. Für Dateien die durch falsche Handhabung zerstört wurden kann keine Haftung übernommen werden. Der gerwitim Kundensupport hilft in solchen Fällen gerne weiter 7. Beispiel java -jar gerwitim_log.jar ADD "Party vorbereiten" Fügt einen Eintrag party vorbereiten mit Zeitstempel 31. Dezember 2008, 15:00:00 (Systemzeit) in die Log Datei ein. 7 Dieser Service ist kostenpflichtig. Bitte rufen Sie uns im Bedarfsfall an. Zuletzt geändert am 7. Juni 2013 Seite 27

28 5 Allgemeine Hinweise 5.1 Zeitreisen gerwitim-log Beim Reisen durch verschiedene Zeitzonen ist darauf zu achten, dass die Systemzeit nicht geändert werden darf da dies u.u. zu verfälschten Ergebnissen führen kann. Bei kurzfristigem Aufenthalt in anderen Zeitzonen kann das System unverändert bleiben, da gerwitim-log sämtliche Zeiten in UTC (oft auch als GMT oder Zulu bezeichnet), also in der Zeitzone 0 speichert. Bei längerfristigen Aufenthalten empfehlen wir grundsätzlich nur die Einstellung für die Zeitzone im System zu ändern, nicht aber die Systemuhr umzustellen. Eine Umstellung der Systemzeit kann neben gerwitim-log auch andere Progamme durcheinander bringen. Zuletzt geändert am 7. Juni 2013 Seite 28

29 6 Technischer Support gerwitim-log Das Programm gerwitim-log wurde in verschiedenen Test- und Pilotphasen sorgfältig getestet. Dennoch kann nicht ausgeschlossen werden, dass es in manchen Situationen zu ungewollten Ergebnissen kommen kann. Die Firma Gerwitim und deren Mitarbeiter haften nicht für Schäden jeglicher Art, die durch die Benutzung des Programms gerwitim-log entstehen. Dieser Haftungsausschluss ist Bestandteil der Lizenzvereinbarung und wird von den Benutzern mit der Installation von gerwitim-log akzeptiert. Sollte es trotz ausführlicher Tests zu Problemen mit oder zu Fragen zum Programm gerwitimlog kommen, hilft der gerwitim Kundensupport gerne weiter. Auf unserer Website stehen die aktuelle Programmversion und Dokumentation sowie ggf. Updates zum Download bereit. Dort finden sich auch allgemeine Tipps zum Umgang mit gerwitim-log sowie die Antworten auf häufig gestellte Fragen (FAQ). Fragen zur Bedienung und Konfiguration des Programms senden Sie am besten in einer an: Bitte verwenden Sie für Ihre Anfragen die deutsche oder englische Sprache und fügen Sie Ihrer auch die Konfigurationsdatei gerwitim_log.properties und Ihre Aufgabendatei (normalerweise tasks.txt). Der Standardsupport ist in er Regel kostenlos. Darüber hinaus bieten wir gegen Entgelt auch weitergehende Hilfe, konfigurieren gerwitimlog nach Ihren Anforderungen oder beraten Sie in allgemeinen Fragen zu Zeitmanagement und helfen Ihnen bei der Bewältigung Ihrer IT Probleme. In dringenden Fällen (z.b. bei einem Fehler kurz vor der Monatsabrechnung) können Sie uns auch telefonisch erreichen. Die Kontaktdaten dazu finden Sie auf unser Website. Bitte beachten Sie jedoch, dass wir Benutzern der kostenlosen Versionen keinen kostenlosen Telefonsupport bieten können. Zuletzt geändert am 7. Juni 2013 Seite 29

30 7 Konfigurationsparameter Die folgenden Tabellen geben einen Überblick über die möglichen Konfigurationsparameter des Programs gerwitim-log. Die Konfiguration erfolgt durch Anpassungen in der Konfigurationsdatei gerwitim_log.properties. Darüber hinaus finden sich auch Kommentare und Erklärungen in der Konfigurationsdatei selbst. Sämtliche Texte in der Benutzeroberfläche und im Reportgenerator können in beliebigen Sprachen eingegeben werden, sofern diese vom Unicode Zeichensatz unterstützt werden. Wird die Konfigurationstatei gerwitim_log.properties editiert, so ist darauf zu achten, dass diese im Unicode Format abgespeichert werden muss da bei anderen Formaten das Programm gerwitim-log evtl. nicht mehr funktioniert. Die unter Voreinstellung genannten Werte werden verwendet, wenn ein Parameter in der Datei nicht konfiguriert ist oder beim Auslesen dieses Wertes ein Fehler auftritt. In den folgenden Tabellen werden alle möglichen Parameter beschrieben. Sind Funktionen in der verwendeten Version nicht enthalten (z.b. Log Editor in der kostenlosen Version), so bleiben die in der Konfiguration eingestellten Werte unberücksichtigt. Einige Funktionen können mit Hilfe der Konfigurationsparameter ein oder ausgeschaltet werden (z.b. die Ausgabe eines Reports in eine kommaseparierte Datei). Ist die Funktion mit der gewählten Lizenz nicht verfügbar, so bleiben die entsprechenden Schalter wirkungslos. 7.1 Konfiguration der Dateien Parameter Voreinstallellung Beschreibung DBtasksFile DBtimeLogFile DBMaxLenLogLine 192 tasks.txt timelog.log Name der Aufgabendatei. Wird kein Pfad mit angegeben so gilt das zum Zeitpunkt des Programmstarts eingestellte Verzeichnis. Wird bei Windows Systemen ein Pfad angegeben so müssen jeweils zwei Trennzeichen ( Backslash ) eingegeben werden, also z.b. c:\\programme\\gerwitim\\tasks.txt In dieser Datei werden die Aufgaben protokolliert. Wird der name dieser Datei während einer Abrechnungsperiode geändert so muss vorher die bereits vorhandene Datei entsprechend kopiert werden, da andernfalls die in der alten Datei gespeicherten Daten beim Report und im Log-Editor nicht berücksichtigt werden. Die Erläuterungen bei der Aufgabendatei zu Pfadnamen gelten auch für diese datei. Maximale Länge eines kompletten Datensatzes in der Logdatei. In diesem Wert enthalten sind 16 Steuerzeichen. Längere Datensätze werden gekürzt. Bedingt durch das eingesetzte Verschlüsselungsverfahren beträgt der Speicherplatzbedarf jedes Datensatzes etwa das Vierfache des hier eingestellten Wertes (in Bytes). Damit hat dieser Wert unmittelbar Einfluss auf die Grösse der abgespeicherten Datei und sollte nur dann verändert werden, wenn sehr tiefe Hierarchien in der Aufgabendatei eingesetzt werden. Zuletzt geändert am 7. Juni 2013 Seite 30

31 7.2 Benutzeroberfläche Hauptmenü gerwitim-log Parameter Voreinstallellung Beschreibung UItxtGrpFile File Bezeichnung für das Programm Menü. UItxtGrpMISC MISC Bezeichnung für das Menü Sonstiges UItxtGrpTasks Tasks Bezeichnung für das Menü Aufgaben UItxtExit Exit Menüeintrag zum Benden des Programms. UItxtStartConfigurator Configurator Menüeintrag Konfigurator starten UItxtStartLogEditor Log Editor Menüeintrag Log Editor starten. UItxtTransmitToServer Transmit Data Menüeintrag Datenübertragung starten UItxtReloadTaskList Reload TaskList Menüeintrag um die Aufgabenliste nach einer Änderung neu zu laden. UItxtStartReporterServer Start Reporter Menüeintrag GUI Auswertung Starten UItxtAnnotate Annotate Menüeintrag Anmerkung UItxtSetTime Set Time Menüeintrag Manuelle Zeit UItxtInterrupt Interrupt Menüeintrag Unterbrechung UItxtBreak Break Menüeintrag Pause UItxtGoHome Go Home Menüeintrag Feierabend UIWindowTitle gerwitim-log Überschrift dehauptfensters. Diese Wird im Fenster selbst nicht angezeigt. UIvalWinPosX 0 Horizontale Position des Menüs auf dem Bildschirm in Pixel. Der Wert 0 steht für den linken Rand des Bildschirms. UIvalWinPosY 0 Vertikale Position des Menüs auf dem Bildschirm in Pixel. Der Wert 0 steht für den oberen Rand des Bildschirms. UIvalSizeCorrection 0 Korrekturwert für die Breite des Menüs. Bei ungünstiger Wahl der Texte für die drei Hauptgruppen im Menü kann das Menü je nach eingesetztem Font zu breit (graue ungenutzte Fläche) oder zu schmal (Text wird nicht vollständig angezeigt) ausfallen. Mit ganzzahligen Werten kann die Breite entsprechend angepasst werden. Positive Werte stehen dabei für breiter, negative Werte stehen für schmaler. Zuletzt geändert am 7. Juni 2013 Seite 31

32 UIshowLastItemTooltip 1 Mit dieser Einstellung können sog. Tooltips für den letzten Eintrag in der Logdatein ein- oder ausgeschaltet werden (nicht in den kostenlosen Versionen). 1=Tooltips einschalten 0=Tooltips ausschalten UIshowInterruptTooltip 1 Mit dieser Einstellung können die Tooltips des menüeintrags Unterbrechung ein oder ausgeschaltet werden (nicht in den kostenlosen Versionen). 1=Tooltips einschalten 0=Tooltips ausschalten Fenster Anmerkung Parameter Voreinstallellung Beschreibung AnnWinTitle Add Annotation Überschrift des Fensters AnnWinLBAnnotation Annotation Text Beschreibung des Eingabefeldes AnnWinLBOK OK Text auf der OK Schaltfläche AnnWinLBCancel Clear/Cancel Text auf der Schaltfläche Abbrechen Fenster Manuelle Eingabe der Uhrzeit Parameter Voreinstallellung Beschreibung ManualTimeWinHeader ManualTimeHeader ManualTimeDate ManualTimeHour ManualTimeMinute ManualTimeBtnOK Set Manual Time Manual Time Date Hour Minute OK ManualTimeBtnCancel Cancel Titel des Fensters Manuelle Zeiteingabe Überschrift im Fenster Manuelle Zeiteingabe Überschrift der Felder für das Datum. Überschrift für die Stunden. Überschrift für die Minuten. Beschriftung der OK Schaltfläche. Beschriftung der Abbrechen Schaltfläche Fenster GUI Reporter Parameter Voreinstallellung Beschreibung StartReporterTitle gerwitim-log Fensterüberschrift Zuletzt geändert am 7. Juni 2013 Seite 32