For Jira Administrators

Owned by Dan Mihalache
Last updated: Jun 03, 2024 by Praveena Manohar
2 min read

Rich Filters::Service Management Dashboards is an extension of the Rich Filters for Jira Dashboards app. This extension adds functionality specific to Jira Service Management to the existing rich filters. Please check the Rich Filters for Jira Dashboards documentation before you proceed.

This page contains information that is more relevant for Jira administrators. The Rich Filters::Service Management Dashboards app adds a special custom field and a JQL function to build the different statistics on SLA fields. Below, we provide more details about these items.

rfSlaIndex custom field

rfSlaIndex is a custom field automatically added by the Rich Filters::Service Management Dashboards app. The field cannot be edited directly or displayed in issues, navigators, or dashboards – its only purpose is to index some of the SLA-related data in a form that allows us to build the different SLA statistics very efficiently.

For this reason, it is very important to reindex your Jira instance (or at least all the Service Management projects) when the Rich Filters::Service Management Dashboards app is installed or upgraded. Otherwise, some of the statistics based on SLA fields might not return correct results.

rfSlaCompleted JQL function

rfSlaCompleted is a JQL function added by the Rich Filters::Service Management Dashboards app. The function allows us to filter the issues having the last SLA cycle completed during, before, or after a particular moment in time. For example: 

rfSlaIndex >= rfSlaCompleted("Time to first response", "2018-02-01 00:00") 

This query returns all issues with the 'Time to first response' SLA completed after February 1, 2018. Note that the function is used in conjunction with the rfSlaIndex custom field and that it takes into account only the last cycle of the SLA. 

This function is useful when filtering the issues that contribute to computing SLA-related values in time series or date bar charts based on the SLA's completion date. More precisely, when computing values such as SLA Met, Breached, %Met, %Breached, or Average during different time periods, only the issues with the SLA completed during each particular time period are considered. This function allows us to provide meaningful links that point to the correct JQL behind each number displayed in the gadgets.