This article is relevant in case:
The PI Session is being prepared for a single ART
Configuring the ART Backlog Board sync requires defining what ART-level Work Items - e.g. Features, Enablers, etc. - are synched between Jira and the ART Backlog Board. For the ART Backlog Board sync you could face different scenarios
One Jira Project holds all ART-level work items e.g. Features/Enablers
Features are in multiple Jira Projects
Filtering the Jira Project/s to only sync the Features (Jira Epics etc.) that are relevant for this specific PI Event.
Scenario 1: 1x Jira Project 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 tab #5 ART Backlog Board
Add the Sticky Type of your choice, select the Jira project from the dropdown field.
Wait until all Jira issue type are loaded and select the [Jira] Issue Type you want to sync with the sticky note.
Scenario 2: Features are in multiple Jira Projects
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 #5 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