| -rw-r--r-- | bin/kdepim/timetrackerhowto.txt | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/bin/kdepim/timetrackerhowto.txt b/bin/kdepim/timetrackerhowto.txt new file mode 100644 index 0000000..69fe1ea --- a/dev/null +++ b/bin/kdepim/timetrackerhowto.txt | |||
| @@ -0,0 +1,68 @@ | |||
| 1 | |||
| 2 | KO/Pi timetracker HowTo | ||
| 3 | |||
| 4 | In KO/Pi you can set a todo in a "running" state to track your working time on that todo. | ||
| 5 | This Howto is about to use that timetracking feature. | ||
| 6 | |||
| 7 | CONTENT: | ||
| 8 | |||
| 9 | 0) Tracking time - setting a todo to started and stopped | ||
| 10 | 1) Getting the time information | ||
| 11 | 2) Overview and analysis of the timetracking data | ||
| 12 | |||
| 13 | ******************************************** | ||
| 14 | 0) Tracking time - setting a todo to started | ||
| 15 | ******************************************** | ||
| 16 | |||
| 17 | To track time open the todo view in KO/Pi. | ||
| 18 | There you can set a todo to the "running" state. | ||
| 19 | You can do this by choosing "Start/Stop todo.." from the context menu for that todo or by double clicking on the start time or start date column of that todo. | ||
| 20 | A started todo is displayed green and the start time and date values in the todo list are displaying the start time. | ||
| 21 | If a parent todo with a running sub todo is displayed closed in the todo view that parent todo is displayed green as well. | ||
| 22 | If a todo is running the running information is stored every five minutes (not configureable). | ||
| 23 | (Nothing is changed in the todo itself: If the todo has a start datetime set only the display changes for the time this todo is set to running.) | ||
| 24 | You can edit a running todo as usual. | ||
| 25 | If you delete a running todo its running information is saved automatically | ||
| 26 | You can set the todo to "stopped" in the same way. | ||
| 27 | If a todo is set to "stopped" within 30 seconds after the start, nothing is stored. | ||
| 28 | If a todo is set to stopped, its running information is stored in the directory | ||
| 29 | <yourhome>/kdepim/apps/timetrackerdir/ | ||
| 30 | If you close the application all running todos are set to stopped and the running information is stored automatically. | ||
| 31 | That does mean: If you start KO/Pi there will be no todo in the "running" state. | ||
| 32 | |||
| 33 | ******************************************** | ||
| 34 | 1) Getting the time information | ||
| 35 | ******************************************** | ||
| 36 | |||
| 37 | All data is stored in the dir | ||
| 38 | <yourhome>/kdepim/apps/timetrackerdir/ | ||
| 39 | |||
| 40 | There are two kind of files: | ||
| 41 | E.g. | ||
| 42 | 20050417-090628-libkcal-1503885238.271.ics | ||
| 43 | and | ||
| 44 | libkcal-1387036159.309.ics | ||
| 45 | |||
| 46 | The filenames with the datetime at the beginning contains the actual tracking data: | ||
| 47 | The datetime part of the filename is the start datetime of this run of that todo. | ||
| 48 | The same value you can find in the file as "DTSTART" value. | ||
| 49 | The end datetime of the tracking you can find in the file as the "DUE" value. | ||
| 50 | |||
| 51 | A file without a datetime at the beginning | ||
| 52 | (libkcal-1387036159.309.ics in our example) | ||
| 53 | contains no timetracking information and contains only information about a parent todo of a todo with timetracking information. | ||
| 54 | This file is needed to display the parent-child relationchip you can see in the KO/Pi todo view in the timetracking overview application: | ||
| 55 | |||
| 56 | ******************************************** | ||
| 57 | 2) Overview and analysis of the timetracking data | ||
| 58 | ******************************************** | ||
| 59 | |||
| 60 | Because every timetracking run is stored in a single file it is easy to merge the data from several computers of the same person or from several persons by copying all the files into the same directory. | ||
| 61 | There is an application which reads the content of that directory and displays the running information of each todo in a so called timetable "Gantt" view. | ||
| 62 | It makes it possible to create and print reports for specific time frames. | ||
| 63 | The default display is exactly like the parent-child relationchip displayed in the KO/Pi todo view, but it is possible to sort items by categories and by attendees. | ||
| 64 | This program will only be available for the desktop (Windows and Linux). | ||
| 65 | This program is not free open source software. | ||
| 66 | There are no decisions about the distribution model (licence model and price) yet. | ||
| 67 | You can find more information about that program after the beginning of June 2005 at www.pi-sync.net. | ||
| 68 | \ No newline at end of file | ||