Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#FFBDAD

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

Panel

For Zephyr, To learn how to sync your requirements via the JIRA Requirements Sync feature within Zephyr system, please view the steps below.

Terminology

Expand
titleClick to view more information on terminology regarding this page


TermDescriptio
JIRA Requirements SyncThe ability to sync/import your requirements from JIRA utilizing a unique way of filtering via JQL and organizing your synced/imported requirements in folders dependent on fields.
Top-Level Folder NameThe name of the folder that houses the synced/imported from the JIRA Requirements Sync feature.
Field 1 & 2Individual fields that help organize the requirements synced/imported into folders. For example, field 1 could be "version" which would organize the requirements into folders depending on the version of the requirement.


...

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. 

Duplicate folders inside a parent requirement tree are not allowed. If an auto Jira Sync operation occurs, multiple folders with same name  name 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.

...

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. 
The data gets removed if there is any update on the requirement via webhook call back.

4. Click "Search" to view the list of requirements.

...

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 fields 1 and 2 when syncing.

...

.

Image Added


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.

  1. Click on the image-20240320-115615.pngImage Added button next to the Release on the left-hand side.

  2. 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.

  1. Click on the image-20240320-120135.pngImage Added button next to the Jira sync folder on the left-hand side.

  2. Click on "Manual Jira Update".

e3b25bbd-9f25-4312-a3b6-e756bf41818d.pngImage Added

You will get the pop-up to sync.

...

On Click on sync, it will bring the Job Progress.

...