The Timepiece (formerly Time in Status) Report gadget allows you to display Timepiece reports as tables or charts on Jira dashboards.

.

Add Gadget

To add the Timepiece (formerly Time in Status) Report gadget:

1. Go to your dashboard and press the Add gadget button on the top right.
2. Find the gadget named Timepiece (formerly Time in Status) Report on the list and press the Add gadget button next to it.
3. You should now see the gadget on your dashboard. 

Configuration

In order to get reports via the gadget, you must first configure and save the gadget settings.

Select Issues

Define how the issues to be included in the report will be selected. Click here for details.

Report Type

Define the column structure of the report. Click here for details.

Select whether you want to see your report as an issue list or Average/Sum/Median/Standard Deviation of report values. Click here for details.

Select whether you want to see Data or Charts when the gadget is first displayed.

Statuses

Select the statuses that you want to see in the report.

If you don't select any statuses, Timepiece will show all statuses it encounters in issue histories.

You can define consolidated statuses as well. Click here for details.

Assignees

Select the assignees that you want to see in the report. (For assignee-based reports)

If you don't select any assignees, Timepiece will show all assignees it encounters in issue histories. Click here for details...

DBS Metrics

Define the metrics that will be used for the Duration Between Statuses report type. Click here for details.

Multi Visit Behavior

Select if you want to see the First, Last, Total, or Average duration of status visits for Status Duration reports. Click here for details.

Field

Select issue fields to include in your reports as columns. Click here for details.

Sort

For supported report types, select the column of the report that you want to sort by and select the sort direction. Click here for details.

Filter

For supported report types, define the filter that will be used to filter report data based on report values. Click here for details.

Calendar

Define the calendar and day length which times will be calculated based on. Click here for details.

Dates

Define the date range that the reports contain issues from. 

The maximum range is 365 days by default. This limit can be changed by Jira admins. See: Configuration File

View

Define the format in which durations will be displayed. Click here for details.

Select how many issues will be shown per page.

Enable / Disable Data Bars for the gadget.

Enable / Disable Visit Counts for the gadget.

Set a maximum height for the gadget in pixels. If left empty, the gadget will expand on the page as much as needed. If a max height is set, the gadget will expand only to the given max height and then scroll its content vertically.

If you want to change the gadget settings later, click the three dots on the top right of the gadget and select Edit from the menu. You can also maximize, minimize, rename, delete the gadget, and change its color through here.

Gadget Functions

Report Parameters

The Report Parameters tab allows users to view the parameters of the report in the gadget without the need to edit the gadget.

The user does not need edit permissions on the dashboard to access this information. All users with view permissions can see report parameters here.

Charts and Status History Expanded Report 

For selected report types, the gadgets will display Chart and Status History Expanded buttons which will display the selection within the gadget.

The buttons appear when you hover over the List report row with your mouse pointer.

Drill Down

While working with Aggregate Reports (Average, Sum, Median, Standard Deviation), you can use the drill-down function on each report row to see the issues that made up that aggregate row.

The drill-down button will become visible on each Aggregated report row when you hover over the row with your mouse pointer.

Filter & Sort

Gadget user can Sort and Filter directly on the screen without having to edit the gadget settings

Filter and Sort options are also available when you drill down to the details of an aggregate report.

View Format

You can change the View Format (days, hours, minutes, etc.), enable/disable Data Bars, and show/hide Visit/Value Counts (for supported report types).