How to work with time tracking features
To add, remove, (de)activate an activity or choose the default one, go to Administration » Categories » Activities (spent time).
In the activity detail, you can select projects for which the activity is or is not active and select color scheme.
You can set when users should select an activity in Project settings » Activities (spent time). You got two options there:
- Activity is pre-selected when creating a task - This option makes the user choose the activity when creating a new task directly.
- Select activity when logging time for a task - This second option allows users to create a task without selecting the activity (users will choose the activity when logging time).
Moreover, this is a second place where you can select which activities are active on that particular project.
Logging time is the most common function in Easy Redmine. There are several ways to log time.
Log time from a task list
To log time, this way right click on a particular task and choose log time. In a table that shows up, you fill in the date, hours you've spent on this task, comment, and type of activity.
Log time directly from a task
When you are updating a task, apart from changing attributes like status and such, you can log in the time you've spent on it.
When deleting a parent task with logged spent time entries either on the task itself or its subtasks, you will be asked to select another task these spent time entries will be transferred to.
Spent time calendar module
This module can be added on a user's homepage by clicking on "Personalize this page" button. When added, just click on the "Log time" icon for a selected day on the calendar and you will get on the logging page. Here you can see options to choose a specific project, task etc. on the right side is a gauge that shows you how many hours you´ve spent that day. On the farther right, you will see the last projects you've opened. So you can click on them and you don't have to look for them in the Project option.
In the More menu, you have "Personal statement" tab with "Log time" option when hovering the mouse cursor over it. If you don't see that option or want to hide it from the menu, go to Administration » Settings » Display » Show Log time in the menu (select enabled/disabled).
"Start working" button
This is another way to log time from a task itself. When you open a task and you are ready to start working, click on the respective button in the right sidebar. The status of the task will change and the assignee will be automatically changed to the current user. You can then choose to pause, in which case the timer will stop. When you get to this task again, just click on the "Continue" button. When you finish working on the task, click on the "Finish" button. The time logging page will be automatically pre-filled according to how long you had the timer on. All you have to do is fill in the desired attributes and click "Save".
The task timer can be configured in Administration » Task timer settings. You can set here to what status your task will change when you execute the timer and to whom it will be assigned to. When the timer is stopped, you can set to which status it changes, to whom it will be assigned to and you can choose the time to be rounded up.
Spent time global settings
Most settings related to spent time can be configured in Administration » Settings » Spent time. You can edit these settings globally or per user role (via "EDIT SETTINGS PER ROLE" button in the top right corner). If both configurations are set, the user role settings will prevail over global settings for all users having that particular role(s).
- Enable approvals of time entries - check if time entries need to be approved by user's supervisor
- Show 'Billable?' choice - check if you need to distinguish billable time entries from other time entries
- Allow creating entries (logging) XX days to past - how many days into past can time entries be created (to disable the limit, leave blank)
- Allow editing entries XX days to past - how many days into past can time entries be edited (to disable the limit, leave blank)
- Allow creating entries (logging) XX days to future - how many days into future can time entries be created (to disable the limit, leave blank)
- Allow editing entries XX days to future - how many days into future can time entries be edited (to disable the limit, leave blank)
- Daily entry limit (total) XX hours - how many hours of spent time can be logged per day (to disable the limit, leave blank)
- Use an editor for comments on time logging? - check if you need rich text formatting for comments on time logging
- Enter date when logging time by task update? - check if you need to manually select date on time logging; otherwise, the current day will be used
- Allow logging time on closed tasks - check if you need to log time on closed tasks
- When logging time, task must be selected - check if you need to disable time logging without a task selected
- Show from/to range as select - if a user logs spent time by from-to range (can be set on user profile » Logging time by), this setting defines the format of the range - a drop-down menu (checked) or simple digit selection (unchecked)
- When logging time, comment must be filled - check if you need to disable time logging without a comment filled
When you have multiple roles on a project, a time entry always shows all the roles you have on the particular project regardless of which role you selected when logging time. The principle of selecting role when logging time is only to show correct activity options, not to link the time entry with the particular role.
Reporting logged spent time
Spent time entries may be reported and/or checked using several ways:
Page module Spent time
This module shows your spent time entries per week or month as a list or chart. Go to page edit mode, add a new module (Spent time) and configure the time period and output format (list or chart). Please note that when using output Chart and setting a filter for current time periods (such as this week/month/year), it will only show totals up to today. For example, it is Thursday the 5th and the filter is set to this month. The gauge will show spent time from Monday (2nd) to Thursday (5th) and the 100 % mark in gauge will be 32 hours (8x4 working days).
Page module Spent time calendar
This module shows your spent time entries in the calendar form. Go to page edit mode, add a new module (Spent time calendar) and configure the time period of the calendar (weekly or monthly).
Page module Spent time from filter
This module is fully customizable and shows spent time entries for any user at any time period in any output format. Go to page edit mode, add a new module (Spent time from filter) and configure the filter (select an existing one or set your custom conditions), output format (list, tiles, chart, report), columns to show, number of results, etc.
For managers who need to see and/or export the full list of spent time entries grouped by days, weeks, months, years or some other non-time entity, we recommend navigating to More » Personal statement » Details (or /time_entries) and using the option "Group results by" under the Options button at the top right. Here you can select an exact time interval for grouping the time entries (such as Week, Month...). In addition to that, grouping by "Date" entity is also possible. In this case, time entries are grouped as per the current view (daily, weekly, monthly...), which can be changed using the icons just above the list of time entries. If you prefer to group by weeks, we recommend using "Group by weeks" instead of "Group by date" along with weekly view because the first option counts weeks by their standard number in calendars, while the latter option counts weeks depending on the user-defined option "Start calendars on", which can be found in More » Administration » Settings » Display.
- On the Details tab, you can find a list of spent time entries as per the applied filter.
- On the Report tab, you can find a list of spent time totals as per the time interval, applied filter and selected entity, such as Activities, Milestones, Projects or Tasks.
- On the Timesheet tab, you can find your weekly and monthly timesheets.
When is the first calendar week
The ISO 8601 definition for week 01 is the week with the Gregorian year's first Thursday in it. The following definitions based on properties of this week are mutually equivalent since the ISO week starts with Monday:
- It is the first week with a majority (4 or more) of its days in January.
- Its first day is the Monday nearest to 1 January.
- It has 4 January in it. Hence the earliest possible first week extends from Monday 29 December (previous Gregorian year) to Sunday 4 January, the latest possible first week extends from Monday 4 January to Sunday 10 January.
- It has the year's first working day in it if Saturdays, Sundays and 1 January are not working days.
If 1 January is on a Monday, Tuesday, Wednesday or Thursday, it is in week 01. If 1 January is on a Friday, it is part of week 53 of the previous year. If it is on a Saturday, it is part of the last week of the previous year which is numbered 52 in a common year and 53 in a leap year. If it is on a Sunday, it is part of week 52 of the previous year.
Our first calendar week is the first week with the first working day according to the calendar (simplified version). For example, the year 2019 has a leap week. If Monday is your first working day, according to the ISO 8601 norm it starts on 31. 12. 2018 but our start is 7. 1. 2019.
- Deactivating an activity in administration >> categories will cause the activity to be disabled on all projects. As a consequence, this may leave your holiday activity disabled so you will not be able to log/approve absences. In such case, please make sure to manually activate the activity in the project, where time is logged for absences (more info about this in Attendance documentation)
- When the option "When logging time, task must be selected" is checked, then you always have to select some task, even when there is no task created on a project. Naturally, this will cause an inability to log time on this project.
- If any item on the list of time entries has "Billable" attribute set to "No", then you are not able to set "Billed" for entire list in bulk. You can overcome this by filter the list to show only those items which have "Billable" attribute set to "Yes" or none, check all items on the list and set "Billed" in bulk.
- When logging time from More: Administration: Personal statement, only projects not marked as "planned" can be selected from the drop-down menu. To log time on a planned project, do it directly from the Spent time module of the particular project.
- When you go to "Administration > Settings > Spent time" and tick the checkbox "When logging time, comment must be filled", please note this setting does not apply to Timesheets. When logging time using Timesheets, there's no field you can enter your comment in, so the mandatory comment is automatically pre-filled with a dash. When you need to add/change a comment for any task, you have to do so via standard task edit button and the comment will also be visible in timesheets.
- If you edit spent time entries of another user, possible spent time limits (if defined in Administration > Settings > Spent time) are considered as per his user role, not yours.
- [With Time sheets plugin] By logging spent time to a period for which a timesheet has been previously created, this logged time is not added to the existing timesheet. However, if spent time is logged first and a timesheet is created afterward, the logged time is added to the newly created timesheet.
- By checking the option "Convert large numbers in charts and trends to a friendly text representation (3.000 -> 3K, 3.000.000 -> 3M)" in Administration » Settings » Display, please note that not only big numbers will be shortened but also very small decimal numbers (such as 0,0005 -> 500µ).