You are viewing documentation for Structure Server and Data Center version 5.5 and patch releases. For other versions, see Version Index or [Structure Cloud].
Links Synchronizer maintains issue links between parent issue and children issues.You can use this synchronizer to replicate the hierarchy in the structure with issue links, or to import a hierarchy that was previously created with links.
Links synchronizer is available only when Links are enabled and there's at least one link type.
This synchronizer supports Resync in both directions (Import and Export) (more about resync). Incremental synchronization watches both structure changes and issue link changes and applies the change to the other side (unless Reverse contradicting changes option is specified, see below).
No matter how synchronizers are configured, they will only affect issues from the projects that are enabled for synchronization.
When synchronizer adds or removes JIRA issue links, it has the same permissions as the user that installed the synchronizer.
The type of the link to sync with. Links of other types will be ignored.
Defines which side of the link is the parent issue and which is the sub-issue.
If set, these filters determine which issues and links can be affected by the synchronizer:
You can use saved filters or JQL queries.
Defines which issues are affected by the synchronizer, based on whether they are in the structure or not.
This setting also controls which issue links can be deleted during export, manual resync from structure, or incremental synchronization. For example, when you remove a sub-issue from the structure, the synchronizer will remove the corresponding link only if it could have added this sub-issue back, that is, when either Expand to sub-issues or Synchronize all issues is selected.
CAREFUL! Please be careful when using this synchronizer with Synchronize all issues option selected, because Exporting or Resyncing from Structure would delete all the existing links of the selected type between issues that are not in the corresponding positions in the structure.
Defines how the synchronizer treats a sub-issue that doesn't have a link to justify its position in the structure (for example, when a user deletes the link from its parent issue):
By default, when a synchronizer is installed and enabled, it tracks changes made by users and applies them to the "other side":
You can use the Reverse contradicting changes option to override this behavior and specify the primary place where issue relationships are stored:
Please note that this option does not apply during Export, Import or manual Resync.
There is a special case: when a list of 2 or more issues is added to the structure, links between these issues are preserved, and they form a hierarchy according to these links. Such a situation may arise, for example, when searching outside the structure and moving a bunch of issues into the structure.
This differs from the default behaviour when Reverse contradicting changes option is not selected: normally, if an issue A is added to the structure as a sub-issue B, and both of them pass the Issue Filters, Links synchronizer would establish a link between A and B and remove all other links of the corresponding type where B is on the sub-issue end of the link. When a list of issues is added, however, the synchronizer behaves as if Links primacy was selected.