Using ScriptRunner Enhanced Search with Custom Charts for Jira (Cloud)

Open

 

• 1 What is Scriptrunner Enhanced Search?
• 2 Steps to Build out Enhanced Search Filters in Scriptrunner
• 3 Use Enhanced Search filter in Custom Charts gadgets
  • 3.1 Source Dropdown
  • 3.2 Chart By/Group By settings
  • 3.3 Simple Search Fields
  • 3.4 Issue List Quick Filters

Due to the infrastructure of Jira Cloud, ScriptRunner functions cannot be accessed in Jira Query Language (JQL) queries in Issue Search and Jira Dashboards directly. To use ScriptRunner functions in queries, users must use ScriptRunner’s Enhanced Search feature.

Here, users create a filter with the ScriptRunner function included, then save it, allowing it to be used across Jira in projects, reports, and Dashboards. You can use your filters in any Custom Charts for Jira gadgets, including Simple Search and Issue List.

1. In the Jira header, click Apps-->ScriptRunner Enhanced Search

   Open

   

2. In Enhanced Search, begin typing in your JQL query in the search bar. You can use ScriptRunner functions in the query

   1. If you click the + in the search bar, you can access a list of available ScriptRunner functions for your query

3. Once you’ve written your JQL query, click Save as Filter

   1. In the dialog box that appears:

      1. Name the filter

      2. Turn the Sync Filter toggle on

      3. Optional: If you want any user to be able to pull the filter into boards and Dashboards, turn the Share with all toggle on

      4. Optional: If you want to restrict filter access to specific projects and/or Jira groups, select them in the Choose Projects and/or the Choose Groups drop downs

   2. Click Save. The Enhanced Search filter will now appear in the Filters dropdown in the Jira navigation header, and will be accessible in all gadgets on Dashboards

• Using Enhanced Search fields in Simple Search

• Using Enhanced Search fields in Issue List

Source Dropdown

1. On the right side of the gadget, click the Source dropdown and select Saved filters

    

2. Click into the filter search bar, and begin typing in the name of your filter. Once it appears on the list, select it. This sets the Enhanced Search Filter as the gadget’s Source.

    

1. On the right side of the gadget in the Chart by or Group by dropdown, select Saved filters

    

2. Navigate to the Chart By tab or Group By tab on the right side of the gadget

    

3. Click into the box that says “Search for saved filters…” and select your filter. This sets the Enhanced Search Filter as the Chart by or Group by value.

    

1. In the right side of Simple Search, navigate to the Simple Search Fields section, then click + Add saved filter toggle

2. Click into the saved filter dropdown and select the Enhanced Search filter from the list. This sets the Enhanced Search Filter as a Simple Search field.

    

1. In the right side of Issue List, navigate to the Quick Filters section, then click + Add saved filter toggle

2. Click into the saved filter dropdown and select the Enhanced Search filter from the list. This sets the Enhanced Search Filter as a Quick Filter.