In der aktuellen TimePunch Version 1.92.1908 wird jetzt erstmals ein Kommandozeilen-Tool für TimePunch veröffentlicht!

Mit TpCommand ist es jetzt möglich die Zeiterfassung auch per DOS Shell für einen Benutzer zu starten, zu beenden und abzufragen. Dieses Feature ermöglicht es die Zeiterfassung scriptgesteuert zu starten, um z.B. bestimmte automatisierte Vorgänge zu protokollieren, oder bei bestimmten Benutzeraktionen einen Projektwechsel zu erzwingen.

Der Aufruf von TpCommand ist denkbar einfach. Bei der Installation von TimePunch wird der Systempfad so erweitert, dass TpCommand direkt aus der Shell aufgerufen werden kann. Ohne Parameter (oder mit /?) gestartet, wird die Hilfe ausgegeben.

Allgemeine Aufrufe:

Folgender Aufruf startet z.B. die Zeiterfassung für das Projekt “Office”.
TpCommand /start /project=Office /desc=Schreibarbeit

Mit dem State Kommando kann der aktuelle Status des Zeiteintrags abgefragt werden.
TpCommand /state

Benutzerwechsel:

Auch die Erfassung für einen anderen Benutzer wird damit vereinfacht. Wie immer muss jedoch zwischen dem Principal (also dem Rechteinhaber) und der Identity (also demjenigen für den die Zeiten aufgezeichnet werden sollen) unterschieden werden. Wird nichts angegeben so sind Principal und Identity identisch. Der Unterschied wird im Post “TimePunch mit fremden Profil starten” noch näher erläutert.

Hier ein Beispiel:

Starten der Zeiterfassung für Benutzer Witzigmann (unabhängig vom aktuellen Windows-Logon)
TpCommand /start /project=Office /principal=Witzigmann /pwd=joke

oder

Starten der Zeiterfassung für Benutzer Witzigmann, aber nur wenn man selbst Administrator ist. Der Vorteil: Es wird kein Passwort für den Benutzer Witzigmann benötigt.
TpCommand /start /project=Office /identity=Witzigmann

Kombinieren von Befehlen:

Befehle können auch kombiniert werden. Wenn TpCommand mit mehreren Kommandos aufgerufen wird, dann werden diese der Reihe nach abgearbeitet.

TpCommand /state /start /project=Office /state /break

Diese Kommandofolge würde erst den aktuellen Status ausgeben, dann die Aufzeichnung für das Projekt Office starten, dann nochmals den aktuellen Status ausgeben und sofort in den Pausemodus übergehen.

Tipp:

Eine angefangene Pause kann mit dem Befehl /commit abgeschlossen werden. In diesem Fall wird die Zeiterfassung dann mit dem vorherigen Projekt fortgeführt.

TpCommand /commit

Abschluss:

Das war erstmal die Kurzeinführung für das neue Feature TpCommand. Für Fragen und Anregungen bin ich wie immer dankbar.

Viel Spaß mit TimePunch
- Gerhard Stephan