Subtasks synchronization can be enabled on Subtask Mapping screen (during new profile creation via wizard) or on Field Mappings on profile edit screen. The following settings are available:
- Synchronization direction:
- synchronization disabled,
- synchronize only from TFS / VSTS to JIRA,
- synchronize only from JIRA to TFS / VSTS,
- synchronize in both direction.
- TFS / VSTS link type that maps to JIRA subtasks (Default: Parent->Child).
- Subtasks Mappings - JIRA allows to define many various issue types of subtasks (Please see JIRA documentation for details). You can define here how they will be mapped to TFS / VSTS work item types.
Due to technical limitations JIRA does not support changing issues to subtasks and subtasks to issues.
This means that if you link a "standalone" TFS / VSTS work item to a parent work item, or unlink a TFS / VSTS task from its parent work item, a corresponding JIRA issue will not be changed to/from subtask.
Case study
The following examples show how subtasks synchronization works in practice with default JIRA and TFS /VSTS workflows and default settings of synchronization profile.
New Subtask has been created in JIRA
- Let's assume that we have a JIRA Task that is synchronized to a TFS / VSTS Work Item.
- JIRA Subtask has been created by user.
- After synchronization the JIRA Subtask is synchronized to new TFS / VSTS Task, and a parent/child link is established in TFS / VSTS.
New child Task has been created in TFS / VSTS
- Let's assume that we have a TFS / VSTS Work Item that is synchronized to a JIRA Task.
- A Task with parent/child relationship has been created by user in TFS / VSTS.
- After synchronization a new Subtask is created in JIRA.
JIRA Subtask has been promoted to a regular Task
- JIRA Subtask is correctly synchronized to child TFS / VSTS Task.
- JIRA Subtask has been promoted by user to a regular JIRA Task.
- After synchronization the parent/child link is removed in TFS.
The parent/child link has been removed in TFS / VSTS
- JIRA Subtask is correctly synchronized to child TFS / VSTS Task.
- The parent/child link has been removed in TFS / VSTS.
- Due to technical limitations JIRA Subtask corresponding to child TFS / VSTS Task is not changed to a regular Task after synchronization.
A parent/child link has been created in TFS / VSTS
- We have two distinct JIRA Tasks that are correctly synchronized to two TFS / VSTS Tasks.
- New child/parent relationship has been added by user in TFS / VSTS.
- Due to technical limitations JIRA Task corresponding to child TFS / VSTS Task is not changed to Subtask after synchronization.