Contents:
Overview
Using Jira Query Language (JQL) you can further drive what you want to visualize on your story map from a Jira project. You have the possibility to import only those issues from Jira to StoriesOnBoard that match to your query. This is very useful when you have a large Jira project but you only want to focus on certain set of issues.
There are two cases when you can use JQL import:
Create a new story map which has no cards and use JQL to import issues from Jira
You have an existing story map and you want to use JQL to import issues from Jira
How to import issues using Jira Query Language (JQL)
Case 1 - Create a new story map which has no cards and use JQL to import issues from Jira
create a new story map
setup Jira integration for the story map
once you have an active integration, visit "Settings"
open "Integration settings"
select the "Import" tab
choose "Import via JQL query"
enter the JQL command
click "Save"
hit "Import"
Case 2 - You have an existing story map and you want to use JQL to import issues from Jira
open your story map
open "Settings"
select "Integration settings"
select the "Import" tab
choose "Import via JQL query"
enter the JQL command
click "Save"
hit "Import"
⚠️ IMPORTANT ⚠️
Please note if you have an existing story map and you enter a JQL query to import additional issues from Jira to your story map, we will unlink all cards on the story map that is not matching to your JQL query.
Step-by-step guide to import issues using Jira Query Language (JQL)
If you created a new story map you need to setup the Jira integration first.
💡 Tip - Learn more about How to setup Jira integration for your story map
If you have an active Jira integration for your story map then follow the steps below.
Open your story map and visit "Settings", then select "Integration settings".
Then select the "Import" tab to access import settings and choose "Import via JQL query".
Enter your JQL query to define which issues should be imported from Jira. Then click "Save changes".
Please note that you can also test your JQL expression in Jira as displayed below.
To import all issues that matches your JQL query to your story map from Jira, click the "Import" icon. Then all issues that matches to your query will be imported to the story map and stay in sync.
⚠️ IMPORTANT ⚠️
Please note if you have an existing story map and you enter a JQL query to import additional issues from Jira to your story map, we will unlink all cards on the story map that is not matching to your JQL query.
