Extending the custom values
Rich Filters::Time Tracking Dashboards is an extension of the Rich Filters for Jira Dashboards app.
This page extends the Configuring Custom Values page from the Rich Filters for Jira Dashboards documentation. If you're not sure how the custom values work, you should check that page first.
About worklog custom values
Rich Filters::Time Tracking Dashboards allows you to define custom values based on work logs (called worklog custom values). You can define custom values using Worklog Time Spent as the base value. You can also use WQL queries to further refine the scope of the custom values. Check the key concepts page to learn how the filtering and grouping based on work log attributes work.
Once defined, the worklog custom values can be used in any gadget that accepts custom values. Below is an example of a Rich Filter Results gadget that shows the time spent on each issue by a period of time.
Adding and editing worklog custom values
Custom values based on work logs can be created, edited, deleted, or reordered like any other custom values. If you are unfamiliar with these operations, look at the Configuring Custom Values page from the Rich Filters for Jira Dashboards documentation. The difference is that now you have new options you can choose from:
Setting | New options – description |
|---|---|
Base value | The user can select Worklog Time Spent as a base for the custom value. |
Value type | The value type is automatically computed based on the Base value you have chosen. |
Total formula | The total formula is used when displaying totals for the custom values. For worklog custom values, the only available option is a Sum total. |
Value display | You can choose how to display the worklog custom values. As for the time tracking values, the available options are:
|
JQL | Custom values can have an optional JQL used to apply additional filtering when computing the value. Rich Filters::Time Tracking Dashboards lets you include work log queries in your custom values' JQL Filters to filter both the issues and the work logs. Issues and work logs that do not satisfy the filter are not considered when computing the value.
See our Advanced Work Log Searching section to learn how to define custom work log queries. |
Using worklog custom values in rich filter gadgets
Once defined, the worklog custom values can be used in any rich filter gadget that displays custom values:
The Rich Filter Simple Counter gadget
See also: The Rich Filter Simple Counter Gadget documentation page to see how to configure the gadget
The Rich Filter Smart Counters gadget
See also: The Rich Filter Smart Counters Gadget documentation page to see how to configure the gadget
The Rich Filter statistics gadget
See also: The rich filter statistics gadget
The Rich Filter Two Dimensional Statistics gadget
The Rich Filter Results gadget
See also: The rich filter results gadget
Use worklog custom values in Time series
You can also use Worklog custom values in Time series – if you are unsure how Rich Filters::Time Tracking Dashboards allows you to define time series based on worklogs, you should check our extending the time series section.
Once defined, you can select a worklog Custom value as the Base value in any time series based on the Worklog Date Series.
The value type of the time series based on worklogs is automatically inherited from the custom value.
Time series based on worklog custom values can be displayed, like any other time series, as tables with the Rich Filter Statistics gadget or as line charts with the Rich Filter Time Series Chart gadget.