WorkTime Export

Copyright 2002-2008 Jens Kunze

Web: http://www.jk-online.net
E-Mail: software@jk-online.net

Inhalt:

• Einführung
• export.ini
• Ordnerstrukur
• Dateien und Variablen

Einführung

Mit dem neuen, vorlagen basierenden, Exportsystem kann Worktime in viele Textbasierende Formate exportieren. Das einzige was sie als Nutzer tun müssen, ist die Vorlagen nach Ihrem Geschmack anzupassen. Dazu soll dieses Dokument eine kleine Hilfe sein.

export.ini

Ein wichtiger Teil des Exportsystems ist die export.ini im Programmunterverzeichnis "export". In ihr werden die Parameter eingestellt, die dafür sorgen, dass im Export-Dialog alles richtig angezeigt wird.

<export.ini Beispiel>

[HTML]
 Filter=htm;html
 Description=HTML File
 Type=HTML
 Profiles=1
 StdProf=Standard

[CSV]
 Filter=csv
 Description=CSV File
 Type=CSV
 Separator=1
 Emptyfields=1
 SepChars=Komma,,|Semikolon,;|Tabulator,#9
 Path=csv

<Beispiel Ende>

Dabei die einzelnen Einträge bedeuten folgendes:

• [Sektionstitel]:
  Ein beliebiger Bezeichner, der jedoch als Standard für Type und Path benutzt wird, falls diese nicht gesetzt wurden.
• Filter:
  Die einzelnen Endungen, unter der die Datei gespeichert werden kann. Falls es mehrere sind, müssen diese durch ein Semikolon getrennt werden.
• Description:
  Die Beschreibung des Dateiformates, so wie sie im Exportieren-Datei-Dialog erscheien soll.
• Type:
  Die Überschrift, die der Exportdialg tragen soll. Dieser Überschrift wird allerdings noch ein " Export" angehängt.
• Separator:
  1, falls Trennzeichen genutzt werden sollen
  0, falls sie nicht genutzt werden sollen
• SepChars:
  Die Bezeichnung des Trennzeichen gefolgt vom Trennzeichen. Beides ist durch ein Komma getrennt.
  Handelt es sich um ein Zeichen, dass man nicht ohne weiteres über die Tastatur eingeben kann, so benutzt man die Raute "#" gefolgt von dem Code für das Zeichen.
  Eine Raute ohne Code stellt die Raute dar.
• Profiles:
  1, falls Profile genutzt werden sollen
  0, falls sie nicht genutzt werden sollen
• StdProf:
  Der Name des Profiles, das als Standard ausgewählt werden soll.
• Path:
  Der Ordner in dem sich die Vorlagen befinden.
• Emptyfields:
  TextText

Ordnerstrukur

Die einzelnen Dateien werden in Ordnern unterhalb des "export"-Ordners abgelegt.
Benutzt ein Dateiformat Profile, so enthält der Ordner weitere Unterordner mit dem Namen des Profiles

Beispielstruktur

   + export           <- Export Ordner mit der export.ini
   |- csv             <- CVS - Vorlagen
   |-+ html
     |- Standard      <- HTML Vorlagen für das Profil Standard

Beispielstruktur Ende

Dateien und Variablen

Eine Vorlage besteht aus folgenden Dateien und Variablen:

Dateien:
header.txt, footer.txt, prjheader.txt, prjfooter.txt, item.txt, separator.txt, field.txt, fieldseparator.txt, itemfield.txt, itemfieldseparator.txt

Variablen:
$filename$, $fullfilename$, $separator$,$Subject$, $Comment$, $StartTime$, $EndTime$, $Hours$, $Minutes$, $Seconds$, $fieldname$, $field$

Beschreibung der Dateien:

Die Funktionsweise der einzelnen Dateien, lässt sich am besten durch eine Beispielstruktur beschreiben:

<Beispielstruktur>

 header.txt           <- Dokumentanfang
  prjheader.txt       <- Projektanfang
   item.txt           <- Eintrag
   separator.txt      <- Trenner
   item.txt
  prjfooter.txt       <- Projektende
  prjheader.txt
   item.txt
   separator.txt
   item.txt
   separator.txt
   item.txt
   separator.txt
   item.txt
  prjfooter.txt
 footer.txt           <- Dokumentende

Beispielstruktur Ende

Beschreibung der Variablen:

Die Variablen lassen sich auch recht einfach beschreiben:

• $filename$:
  Dateiname Bsp: "file.wtf"
• $fullfilename$:
  voller Dateiname Bsp: "C:\ordner\file.wtf"
• $separator$:
  Falls Trennzeichen genutzt werden, wird diese Variable durch das Trennzeichen ersetzt. Andernfalls wird die Variable einfach entfernt.
• $Subject$:
  • item.txt:
    Betrefffeld des Eintrages
  • prjheader.txt,
    prjfooter.txt:
    Name des Projekts
• $Comment$:
  Kommentarfeld des Eintrags
• $StartTime$:
  Startzeit des Eintrages
• $EndTime$:
  Endzeit des Eintrages
• $Hours$:
  • item.txt:
    Stundenanteil für Dauer des Eintrags
  • prjheader.txt,
    prjfooter.txt:
    Stundenanteil für Dauer des gesamten Projektes
  • header.txt,
    footer.txt:
    Stundenanteil für Dauer aller Prjekte.
• $Minutes$:
  siehe $Hours$ nur mit Minuten
• $Seconds$:
  siehe $Hours$ nur mit Sekunden