Structure Plugin for JIRA - Version 1.4

Index

Child pages
  • Links Synchronizer

This documentation relates to an older version 1.4 of the Structure Plugin for JIRA. View the current documentation home.

Skip to end of metadata
Go to start of metadata

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.

Links Synchronizer Parameters

Link Type

The type of the link to sync with. Links of other types will be ignored.

Exclusive Mode

The exclusive mode allows the synchronizer to add issues to the structure if they have a link of the selected type, as well as remove links
from issues that are not in the structure.

Link Direction

Defines which side of the link is the parent issue and which is sub-issue.

This synchronizer supports both Import and Export / Resync into/from Structure (more about resync). However, the incremental synchronization only works in the direction from Structure (creating links won't lead to adding / placing issues in the structure unless you Resync).

No matter how synchronizers are configured, they will only affect issues from the projects that are enabled for synchronization.

CAREFUL! Please be careful when using this synchronizer with Exclusive mode turned on, because 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.

Links Synchronizer Rules
  • When synchronizer is enabled, any changes in the structure will be reflected by creating and removing links of the selected type. Links created or removed by the user will not be automatically reflected in the structure.
  • Links created and removed by the synchronizer are not recorded in the issue history, and issue update time is not changed (due to performance reasons).
  • Use Resync (from Structure to Links) or Export to update the links between the issues currently in the structure.
    • If Exclusive Mode is turned on, all other links of the selected type will be removed (limited by projects enabled for Structure).
  • Use Resync (from Links into Structure) or Import to rearrange the issues in the structure according to the existing links.
    • If Exclusive Mode is turned on, all issues that have links of the selected type will be added to this structure. Otherwise, only issues that are already in the structure are affected.
  • Links that violate hierarchy restrictions will be ignored. The restrictions are:
    • A sub-issue may have only one parent issue.
    • There should be no sub-issue cycles.