Extending the custom values

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.

Open

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

Setting	New options – description
Base value	The user can select Worklog Time Spent as a base for the custom value. Open
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:  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 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 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
  
  

  
  See also: The rich filter statistics gadget
  
  

• The rich filter two dimensional statistics gadget
  
  

  
  See also: The 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.