Extending the custom values
- Dan Mihalache
- Praveena Manohar
- Cristian Oancea
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.
Contents:
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. For the Worklog Time Spent value, the type is always Logged Time.  |
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. |
Value display | You can choose how to display the worklog custom values. As for the time tracking values, the available options are:
|
JQL filter | Custom values can have an optional JQL Filter used to apply additional filtering when computing the value. Rich Filters::Time Tracking Dashboards allows you to include work log queries in your custom values' JQL Filters to filter both the issues and the work logs. Issues & 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
Have a look at The Rich Filter Simple Counter Gadget documentation page to see how to configure the gadgetThe rich filter smart counters gadget
Have a look at The Rich Filter Smart Counters Gadget documentation page to see how to configure the gadgetThe rich filter statistics gadget
See also: The rich filter statistics gadgetThe rich filter two dimensional statistics gadget
The rich filter results gadget
See also: The rich filter results gadget
Using Worklog Custom Values in Time Series
Worklog custom values can also be used 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, a worklog custom value can be selected as the base value in any time series based on the Worklog Date.
The value type of the time series based on worklogs is Logged Time – 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.
