RedmineTimeTracking » History » Version 14
Mohit Sindhwani, 2012-07-26 18:10
1 | 1 | Jean-Philippe Lang | h1. Time tracking |
---|---|---|---|
2 | 1 | Jean-Philippe Lang | |
3 | 9 | Mischa The Evil | {{>toc}} |
4 | 5 | James Rowe | |
5 | 5 | James Rowe | h2. Introduction |
6 | 5 | James Rowe | |
7 | 6 | James Rowe | Time tracking allows users to track how many hours of work are logged to a specific issue or project. Each time entry of "spent time" can be categorized by activity, and further explained with comments. By filling time estimates, project managers are able to produce better suited project planning as well as follow individual users progress. |
8 | 6 | James Rowe | |
9 | 7 | James Rowe | Time tracking is always related to a user, thus it can be used to track how many billable hours this user has accomplished. See the [[RedmineTimelogDetails|spent-time details]] or [[RedmineTimelogReport|spent-time report]] pages for more information. |
10 | 5 | James Rowe | |
11 | 5 | James Rowe | h2. Installing/Configuration |
12 | 5 | James Rowe | |
13 | 9 | Mischa The Evil | Time tracking is a standard module of Redmine and can be enabled/disabled for each project in the *Modules* section of the new project form, or the *Settings* tab of an existing project. |
14 | 1 | Jean-Philippe Lang | |
15 | 2 | Jean-Philippe Lang | h2. Logging time on an issue |
16 | 2 | Jean-Philippe Lang | |
17 | 2 | Jean-Philippe Lang | You can log time on an issue by clicking !/images/time_add.png! *Log time* from the issue details view. |
18 | 1 | Jean-Philippe Lang | |
19 | 9 | Mischa The Evil | p=. !log_time.png! |
20 | 1 | Jean-Philippe Lang | |
21 | 1 | Jean-Philippe Lang | You can also log time when updating an issue. |
22 | 1 | Jean-Philippe Lang | |
23 | 9 | Mischa The Evil | p=. !Update_LogTime.png! |
24 | 1 | Jean-Philippe Lang | |
25 | 1 | Jean-Philippe Lang | h2. Logging time at project level |
26 | 1 | Jean-Philippe Lang | |
27 | 1 | Jean-Philippe Lang | You can log hours at project level by leaving the issue field empty. |
28 | 9 | Mischa The Evil | |
29 | 9 | Mischa The Evil | h2. Accepted time formats |
30 | 9 | Mischa The Evil | |
31 | 9 | Mischa The Evil | Estimated and spent hours can be entered using the following formats: |
32 | 9 | Mischa The Evil | * Hours and minutes using standard time format: @1h@, @1 h@, @1 hour@, @2 hours@, @30m@, @30min@, @1h30@, @1h30m@, @1:30@ |
33 | 9 | Mischa The Evil | * Hours and minutes using decimal time format: @1.5@, @1,5@ (equals to @1h30@) |
34 | 9 | Mischa The Evil | |
35 | 9 | Mischa The Evil | h3. Decimal time format |
36 | 9 | Mischa The Evil | |
37 | 9 | Mischa The Evil | When entering estimated- and spent-time values in Redmine using "decimal time format":http://en.wikipedia.org/wiki/Decimal_time you have to be aware of the following situation: |
38 | 9 | Mischa The Evil | |
39 | 9 | Mischa The Evil | * _Example_: you have 4 issues with the following spent time values: 1.00, 0.10, 0.15, & 0.40. Now in the Spent-Time reports (Project overview -> Spent time -> [Details | Report]) you see a total of 1.65 hours instead of 2.05 hours...??? |
40 | 9 | Mischa The Evil | |
41 | 9 | Mischa The Evil | * _Explanation_: this "behaviour" is normal and intended since you enter those four spent-time values using decimal time format. This means that: |
42 | 9 | Mischa The Evil | ** 1.00 decimal equals 60 minutes (1 hour) |
43 | 9 | Mischa The Evil | ** 0.10 decimal equals 6 minutes |
44 | 9 | Mischa The Evil | ** 0.15 decimal equals 9 minutes |
45 | 9 | Mischa The Evil | ** 0.40 decimal equals 24 minutes |
46 | 9 | Mischa The Evil | ** 1.65 decimal equals 99 minutes |
47 | 9 | Mischa The Evil | ** 2.05 hours (125 minutes) equals 2.0833333333333335 (est.) in decimal notation |
48 | 9 | Mischa The Evil | |
49 | 10 | James Rowe | Of course there can possibly be a very tiny difference (as you can see) due to the rounding to two decimals done by Redmine. |
50 | 9 | Mischa The Evil | |
51 | 9 | Mischa The Evil | Some references: |
52 | 9 | Mischa The Evil | * http://en.wikipedia.org/wiki/Decimal_time |
53 | 9 | Mischa The Evil | * http://www.springfrog.com/converter/decimal-time.htm |
54 | 11 | Jean-Philippe Lang | |
55 | 11 | Jean-Philippe Lang | h2. Logging time via commit messages |
56 | 11 | Jean-Philippe Lang | |
57 | 13 | Mischa The Evil | With the *Enable time logging* option turned on (see _Application settings -> Repositories_), developers can log time against an issue via their commit messages using the following syntax (hours must be preceded with an issue id): |
58 | 11 | Jean-Philippe Lang | |
59 | 11 | Jean-Philippe Lang | Fixed something, #435 @1h30 |
60 | 11 | Jean-Philippe Lang | |
61 | 11 | Jean-Philippe Lang | This commit message will log 1h30 on issue !#435. |
62 | 14 | Mohit Sindhwani | |
63 | 14 | Mohit Sindhwani | If you encounter a problem with this, ensure that under _Application settings -> Repositories_, make sure that *Activity for logged time* is set to something other than 'Default' and use a format similar to the below in your commit message. |
64 | 14 | Mohit Sindhwani | |
65 | 14 | Mohit Sindhwani | refs #435 @1h30 |