...
...
...
...
...
...
...
...
...
...
...
...
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-user-guide/requirements/jira-requirements-sync.html |
| Column | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Description
|
| Table of Contents | ||||
|---|---|---|---|---|
|
JIRA Requirements Synchronization
| Info |
|---|
If the same JQL is used in multiple releases of the same project, the requirement(s) and requirement tree auto changes will only get reflected to the latest release of a project. Any JIRA sync that has the same JQL from any (different) releases of same project that is migrated from 6.1.2 over to 6.2 will need to have their JIRA sync re-created to utilize features from 6.2, so that it is able to maintain the same requirement(s) in the multiple requirement tree.Duplicate folders inside a parent requirement tree are not allowed. If an auto Jira Sync operation occurs, multiple folders with same namename are created and they need to be deleted manually before a JIRA sync can be re-saved. |
1. Click on the 
button next to the release folder on the left-hand side.
2. Click on "Jira Sync Config".
3. Enter a JQL string or filter to filter the requirements that you want to search and sync.
...
| Note |
|---|
The older JQL search data remains as it is in the search result even if you change the JQL string for Jira Sync Config and even if it does |
...
not satisfy the current JQL. |
4. Click "Search" to view the list of requirements.
5. Enter a name for the "Top-Level Folder Name" text box.
Top-Level Folder Name - A name given to the folder where these requirements will be synced to.
6. Choose if you want to further categorize your requirements into folders by selecting a category for field 1 and field 2.
If you make a selection for field 1 and 2, the requirements synced will be categorized first by field 1 folder and then categorized by field 2 folders under field 1.
When choosing fields 1 and 2, users have the option to select Sprint or Epic Link and if users are selecting these fields to structure their requirements, the folder structure for the requirements will include both the Sprint ID and Name as well as the Epic ID and Name.
Whatever changes in Jira to the Sprint will immediately be reflected to in the folder structure as well as the requirement. The folder structure will be updated in Zephyr if there were are changes made to the sprint for the requirement. The requirement in Zephyr will include any reflected changes made when the fields are updated in Jira.
| Warning |
|---|
Users have to re-sync their requirements if they were already using an existing query to setup their requirements via Epics and Sprints to properly display their epic and sprint folder structures. |
...
...
7. Click on the "Save" button after you've finalized your folder name, and folder field filters, and you are satisfied with the requirements that you want to sync.
...
2. Click on the "Top-Level Folder" and navigate through the following folders if you selected a category for field fields 1 and 2 when syncing.
Disable Jira Sync
Users can Disable the Jira Sync Requirement when they are done with the release to avoid unnecessary callback from Jira.
This will help the System performance as Zephyr Enterprise will not check for those releases whose Jira sync is disabled.
This feature is only available when a new webhook integration is done.
| Info |
|---|
Zephyr Recommends disabling the Jira sync If the Release is done. |
Click on the
button next to the Release on the left-hand side.Click on "Disable Jira Sync".
...
Manual Jira Sync Update
Users can Sync the Jira Sync Requirement Manually by using the Manual Jira Update this can be useful when a webhook call back has not brought the latest changes
On doing Manual Jira Update on Jira Sync Folder
It will bring the requirement that satisfies the JQL or Filter
It will remove the requirement if any requirement does not satisfy the JQL or Filter
It will Update the requirement if any changes are made on the Requirement.
Click on the
button next to the Jira sync folder on the left-hand side.Click on "Manual Jira Update".
You will get the pop-up to sync.
...
On Click on sync, it will bring the Job Progress.
...