To use the ScriptRunner Enhanced Search feature:
- Navigate to the page from the Jira Administration menu by selecting Apps→ScriptRunner Enhanced Search.
- Enter your JQL query into the JQL Search bar and click the Search button.
- Alternatively, you can click the Insert Function button '+'. This helps users who are unfamiliar with JQL queries by giving them access to pre-generated queries.
- Select the function from the Available Functions list on the left-hand-side. Depending on the function chosen, you may be required to enter or select subquery details to generate valid JQL for that function. For example, a subquery
"project = EXAMPLE"tells the
linkedIssuesOffunction that it should find issues linked to the results of that subquery.
- Click the Add to query button and click Search. You are returned to the JQL Search page with a list of results displayed for the function.
- Check your query has returned the desired results before continuing. To customize the Results table view, click Choose Columns, and check the columns you wish to display.
- Click the Save as filter button to save this filter and reuse at a later stage.
Name the filter and enable the Sync Filter toggle so you can use it in dashboards and Jira Software Boards.
Navigate to the Settings page, via Apps→ScriptRunner for Jira→Settings, where you can specify how often ScriptRunner synchronizes your filters. The default interval is five minutes. The maximum allowed interval is an hour. We recommend you to use the default value, unless you notice that filter synchronizing makes too many requests to your Jira instance and causes a performance problem.
Once created, new filters are not synchronized by default. All new filters are synchronized after the default interval of 5 minutes when the Sync Filter option is selected in the Filter Creation Screen. If the Sync Filter option is disabled, the filter does not automatically sync and must be manually synced from the Search screen using the Sync Filter button.
Every X minute, ScriptRunner will check if something has changed in your Jira issues or someone has changed the ScriptRunner add-on settings recently. If that check is positive, then filters are synced with the changes made to the issues in your Jira instance.
Filters are always run with the same set of permissions as the user who created the filter.
You must make sure that the ScriptRunner Add-On User has the Global Permission to Browse Users in order for this feature to work.
If you want to update or delete these Enhanced Search filters, use the ScriptRunner Enhanced Search page instead of the Jira filters user interface.
Chose who to share the filter with from the three options: share with all, share with a project, or a user group:
Checking Share With All shares the filter with all users logged into the Jira Cloud instance.
- Selecting one or more projects under Choose Projects makes the saved filter available within the selected project(s).
- Selecting one or more groups under Choose Groups shares the filter with all members of the selected group(s).
Click Save. To see all saved filters, navigate to Filters→View All Filters.