Excerpt | ||
---|---|---|
| ||
Calculates the time spent during the configured status(es) based on the defined working calendar. |
The Time in Status (Status Timer) custom field Custom Field lets you track the amount of time spent in selected status(es). It can be configured to work against a specific working calendar.
Field The custom field simply displays the total time passed during the selected status(es) as below.
When clicked , it displays all details, below is a snapshot to clarifydemonstrate this.
Creating the Time in Status
...
Custom Field
To define Status Timer custom fieldthe Time in Status Custom Field:
- Navigate to JIRA to Jira Admin > Add-ons > Enhancer Plugin Menu > Custom Field Configuration and switch to go to the Duration fields tab.
- Click on on the Add new button and then select the Status Timer custom field link button.
- Fill in the dialog box:
- Give Create a Nameto your for your custom field.
- Select the status(es) that you want to see calculate the amount of time spent in.
- A Calendar can also be selected. Working calendars can be defined in JIRA Jira Admin > Add-ons > Enhancer Plugin Menu > Working Calendars menu Calendars menu item.
The Occurrence can be set to display only the "First" or "Last" occurrence, or an aggregated result with a "Cumulative" option.
- Configure the Time formatter display options (both for issue main view and navigator view).
- Give Create a Nameto your for your custom field.
- And click on the Add Custom Field or Update button. That's it.
Don't forget to associate link the custom field to with appropriate screens in order to see them.
Searching with the Time in Status
...
Custom Field
The Time in Status (Status Timer) custom field Custom Field comes with a powerful searcher. You can use this custom field in your JQL statements in order to filter issues by status, then assigned users.
timeSpentBy(), timeSpentInStatus() and timeSpentInStatusBy() JQL functions can be used as right-hand functions with the custom field.
Below there are some samplesexamples:
Searching against total duration including every users user within the selected status(es).
Code Block "Time in Review" >= 4d
Searching against a single user.
Code Block "Time in Open" <= timeSpentBy("5d", "agrant")
Searching against multiple users. Below function searches time spent by users (agrant, jevans and hjennings) in 'Waiting for support status' more than 5 calendar days.
Code Block "Time in Waiting for support" >= timeSpentBy("5d", "agrant", "jevans", "hjennings")
Searching by the IDs of status(es). When the custom field is defined with multiple statuses, but you want to filter by some of them with the status IDs.
Code Block "Time in Open" > timeSpentInStatus("2d", "1")
(where Where 1 is ID of status Open).
Searching by the names of the status(es). When the custom field is defined with multiple statuses, but you want to filter by some of them with the status names.
Code Block "Time in In progress" >= timeSpentInStatus("6h", "In Progress") "Time in In progress" >= timeSpentInStatus("6h", "Open", "In Progress", "In Review")
Searching by status ID and the users.
Code Block "Time in In progress" > timeSpentInStatusBy("8h", "3", "agrant")
(where Where 3 is ID of status Open and agrant is the username).Searching by status name and the users.
Code Block "Backlog time" > timeSpentInStatusBy("10h", "Open", "hjennings")
...