This documentation relates to version 1.2 of Rich Filters::Time Tracking Dashboards. Documentation for previous versions is available via the documentation index.

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: 

  1. About Worklog Custom Values
  2. Adding & Editing Worklog Custom Values
  3. Using Worklog Custom Values in Rich Filter Gadgets
  4. 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:

SettingNew 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 formulaThe 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: 

  • Jira default - the time tracking values will be displayed using the time format as configured in Jira
  • Days – the values will be displayed in days
  • Hours – the values will be displayed in hours
  • Minutes – the values will be displayed in minutes
  • Seconds – the values will be displayed in seconds
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:

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.