This page relates to an older version 1.3 of Rich Filters::Time Tracking Dashboards. See the documentation index for other versions.
Extending the Custom Values
Rich Filters::Time Tracking Dashboards is an extension of the Rich Filters for Jira Dashboards app. If you are not already familiar with the rich filters, you should first have a look at the Rich Filters for Jira Dashboards documentation.
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.
On this page:
- About Worklog Custom Values
- Adding & Editing Worklog Custom Values
- Using Worklog Custom Values in Rich Filter Gadgets
- Using Worklog Custom Values in Time Series
1. About Worklog Custom Values
Rich Filters::Time Tracking Dashboards allows you to define custom values based on work logs (which can be called worklog custom values). More precisely, you can define custom values using Worklog Time Spent as base value. You can also use WQL queries to further refine the scope of the custom values. If you're not sure how the filtering and grouping based on work log attributes works, you should first understand our Key Concepts.
Once defined, the worklog custom values can be used in any gadget that accepts custom values. Find below an example of a Rich Filter Results gadget that shows, for each issue, the time spent by period of time.
2. Adding & 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 not already familiar with these operations, have a 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 chose from:
| Setting | New options – description |
|---|---|
| Base value | The user can select Worklog Time Spent as 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 sum. |
| Value display | You can chose 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 which is 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 taken into account when computing the value.
See our Advanced Work Log Searching section to learn how to define custom work log queries. |
3. 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 gadget - The Rich Filter Smart Counters gadget
Have a look at The Rich Filter Smart Counters Gadget documentation page to see how to configure the gadget - The Rich Filter Statistics gadget
Have a look at The Rich Filter Statistics Gadget documentation page to see how to configure the gadget - The Rich Filter Two Dimensional Statistics gadget
Have a look at The Rich Filter Two Dimensional Statistics Gadget documentation page to see how to configure the gadget - The Rich Filter Results gadget
Have a look at The Rich Filter Results Gadget documentation page to see how to configure the gadget
4. Using Worklog Custom Values in Time Series
Worklog custom values can also be used in Time Series – if you are not sure how Rich Filters::Time Tracking Dashboards allows you to define time series based on worklogs, you should have a look at our Extending the Time Series section.
Once defined, a worklog custom value can be selected as 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.
