Time Tracking Settings
- Nisha Shantilal
The add-on comes with an inbuilt Time Entry interface - a single page to enter time against all the issues the user is working on.
To enable time tracking in the app, click on Administration → Time Tracking Settings → Time Tracking and click on the ‘Enable “Report and Timesheets Time Tracking”’ button on the top right (highlighted in screenshot below)
Once time tracking is enabled, additional settings become available for the Jira admin to define the details that show up on the My Timesheet page (the app’s time entry interface) and control the behavior of the page.
This article explains the different settings available to the Jira admin for customizing time tracking. The settings allowed are grouped under General, Timesheet Approval, Worklog Attributes and Non-project tasks
General Time Tracking Settings
To access the general settings for time tracking, click on Administration → Time Tracking settings → Time Tracking to land on the page shown below
To use the Appfire time entry dialog on the Jira issue details page, navigate to Jira Settings > Issues > Time tracking > Time tracking provider and select Reports and Timesheets (Applies to cloud).
The following settings can be defined here
Maximum number of hours/day: The number set here will control the validation of sum of hours entered per day in My Timesheet. If the total number exceeds the maximum, an error will be thrown as shown below
Disable time entry for past month: This setting allows the admin to lock timesheets for past month after a certain number of days. It’s like having a due date for users to finish their timesheets as they will get locked after say 5 days after the end of the month. Below is a screenshot showing locked timesheet for January (greyed out)
Disable time entry for issues in status: Allows the admin to lock issues that are in certain status. For example, as an organization, the admin can define that time cannot be logged against issues in To Do and Done status. A lock icon appears next to the issues on the timesheet page
Disable time entry for issues with date: Allows the admin to lock issues based on certain dates. For example, as an organization, the admin can define that time cannot be logged against issues that have start date in the future (10 days from the current date)
Show ‘Description’ field for time entry: Defines if the description field should be shown in the time entry dialog box. If entered the value will be stored as worklog description in Jira
Make ‘Description’ mandatory for time entry: Defines if description should be necessarily entered or not. This is active only if the above setting is checked
Show ‘Remaining Estimate’ field for time entry: Defines if the remaining estimate field should be shown in the time entry dialog box. This is an auto-calculated field
Show ‘Start Time’ field for time entry: Defines if the start time field should be shown in the time entry dialog box. If entered the value will be stored
Display these issues on every user’s timesheet: Allows the admin to show certain issues on every user’s timesheet. This can be helpful when there are certain common issues that everyone in the organization should log time against. Click the ‘Add’ button to open the search dialog box shown below
Timesheet Approval Settings
The add-on allows Jira admin to setup approval workflow for timesheets. Please click here for details on the settings available for timesheet approval
Worklog Attributes Settings
The add-on allows Jira admin to create custom attributes at worklog level. Worklog attributes can be extra information that is required for the worklogs entered.
For details about creating, editing and deleting worklog attributes, please refer to Custom Attributes for Time Entry.
Non-Project Tasks Settings
Non-Project tasks are tasks which are not related to the project being tracked in Jira, but still need to be tracked in the timesheet for the users.
For more information on managing non-project tasks, please refer to Non-Project Tasks