This article describes the integration points and possible use cases of JQL Search Extensions with Advanced Roadmaps.

Integration points

Scope definition

JQL Search Extensions helps to define a precise scope of an Advanced Roadmaps plan. You can source issues with additional JQL aliases keywords and Extended searchSearch filters.

It’s possible, for example, to have a plan with a subset of initiatives or epics and their children. You will typically create the Extended searchSearch filter for the board and reuse it in the plan.

...

The process of creating the filter from scratch looks like this:

1. Create a filter in Extended

...

1. Search.

2. Use the filter in the plan configuration: Configure → Issue sources

Make sure to check out the examples in the use cases section on this page.

External use

It’s a common requirement to access the contents of a plan outside of Advanced Roadmaps, for example, to create a report in a 3rd party app or tool.

...

• dashboard gadgets

• boards

• Jira search - simply use this syntax filter="Your filter name"

• 3rd party apps that accept filters and JQL

Examples of use cases

Source a subset of epics with their full hierarchy

You don’t need to add a whole Jira project to the scope of a plan.

...

If you have a list of specific epic keys that should be in scope, create the following Extended searchSearch filter and use it as a scope:

...

The above query could be limited to one project or it can source the issues from multiple projects.

Source a subset of initiatives with their full hierarchy

This use case is similar to the previous use case with epics. You can create a plan with selected initiatives and all their children.

...

(type=Initiative and labels='myVision') OR issue in childrenOfIssuesInQueryRecursive("type=Initiative and labels='myVision'")

Source issues linked to your project

You may want to create a plan with issues from your project and external issues that are linked to your project.

...

If you only want to include the issues linked with the particular link type, you can create an Extended searchSearch filter:

project=MYPROJ OR issue in linkedIssuesOfQuery("project=MYPROJ", "is blocked by")

You can also get a full hierarchy of the linked issues by creating a nested filter:

1. Create an Extended

...

1. Search filter:
   issue in linkedIssuesOfQuery("project=MYPROJ", "is blocked by")
   and call it “Blockers”

2. Create another filter that nests the first filter:
   project=MYPROJ OR filter="Blockers" OR issue in childrenOfIssuesInQueryRecursive("filter='Blockers'")

3. Use the filter as your scope in the plan configuration