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 to JIRA,
- synchronize only from JIRA to TFS,
- synchronize in both direction.
- TFS 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 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 work item to a parent work item, or unlink a TFS 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 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 Work Item.
- JIRA Subtask has been created by user.
- After synchronization the JIRA Subtask is synchronized to new TFS Task, and a parent/child link is established in TFS.
New child Task has been created in TFS
- Let's assume that we have a TFS Work Item that is synchronized to a JIRA Task.
- A Task with parent/child relationship has been created by user in TFS.
- 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 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
- JIRA Subtask is correctly synchronized to child TFS Task.
- The parent/child link has been removed in TFS.
- Due to technical limitations JIRA Subtask corresponding to child TFS Task is not changed to a regular Task after synchronization.
A parent/child link has been created in TFS
- We have two distinct JIRA Tasks that are correctly synchronized to two TFS Tasks.
- New child/parent relationship has been added by user in TFS.
- Due to technical limitations JIRA Task corresponding to child TFS Task is not changed to Subtask after synchronization.