This article is relevant in case:
A single ART is added on step #2 Teams
The PI Session is being prepared for just a single ART
Configuring the Jira Backlog Board Sync you define what ART level work items (e.g. Features, Enablers, etc.) are synched between Jira and the ART Backlog Board. For the Backlog Board Sync you could face two different scenarios
One project in Jira which holds all Features
Features are in multiple projects in Jira
Scenario 1: One project in Jira which holds all Features
If you have all your SAFe Features in one Jira project, the configuration is very easy:
Create or edit a PI Planning session
Go to the step "ART Backlog Board"
For the Sticky Type of your choice, select the "Jira project"
Wait until all "Jira Issue Types" are loaded and select the Issue Type you want to sync
Scenario 2: Features are in multiple Projects in Jira
In the case you have your SAFe Features in multiple Jira projects, you have to create multiple Sticky Type to display them all in the app:
Create or edit a PI session
Go to the step "ART Backlog Board"
For each Jira project, create a new Sticky Type:
Select the Jira project
Select the Jira Issue Type
Filter by Jira Fields
You may not want to have all the Jira issues of a project on the ART Backlog Board. In that case, you can choose to only sync issues that have a specific value for a given field. For example, you could give the issues a label (eg. “PI6”) or Fix Version (eg. “1.12”).
The following field types may be used to filter session backlog items:
Labels
Versions
Components
Single-select (customfield)
Multi-select (customfield)
In the example above, only Jira Issues with the Label "PI24.1" AND Fix Version “24.4” will be synchronized on the ART Backlog Board.
An example of Jira Fields available on the Jira Project that can be used to filter the ART Backlog Board for the specific PI Session.
If you specify multiple Jira Fields, OR multiple values in a field (comma-separated), they will be added together using an AND statement. For example, using the Labels PI6, PI7 will only display Epics which have the Labels PI6 AND PI7 set in Jira.
Keep in mind
Jira Labels do NOT have whitespace characters. Labels containing "/" cannot be used in the Jira Labels field as a filter.
Ranking
The sticky notes on the ART Backlog Board are ranked by the value on the bottom right of the Sticky from top left to bottom right.
You can rank them by any numeric field, which is available on the Jira Issue Screen of your synced Issue Type.
Team field synchronization
Sync the team field
You may want to make sure that a Features is pulled on the ART Backlog Board with a predefined team in case you already assigned a Team to that Feature before PI Planning.
To do so, please refer to the Jira Backlog Board - Team Field Sync article