Track dependencies by using Delivery Plans
Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
With Delivery Plans, you can track dependencies that have been added to work items. Dependency tracking supports the Predecessor/Successor link type between work items. The following image shows dependency lines between a work item and several of its predecessor work items.
To view dependencies, you must first define the Delivery Plan and dependencies between work items. To learn how, see Add or edit a Delivery Plans and Link user stories, issues, bugs, and other work items.
You can create dependencies between work items in different projects within the same organization, but not in projects in different organizations.
- To view a Delivery Plan, you must be a member of the Project Collection Valid Users group. Users granted Stakeholder access for a private project can view plans. Users granted Stakeholder access for a public project can add and view plans.
- To open or modify a work item or add work items, you must have the Edit work items in this node set to Allow for the Area Paths assigned to the work item.
For work items and dependency lines to appear on the plan
- Work items must belong to a team's product backlog or portfolio backlog. Only work items belonging to a category selected for viewing on a team's backlog appear on the plan.
- Team product or portfolio backlog must be enabled.
- Sprints must be selected for each team defined in the plan.
- Start and end dates must be defined for each iteration.
- Iteration paths must be assigned to each work item.
- For dependency icons and lines to show, work items must be linked using Predecessor-Successor link type or other custom dependency link type (remote link types not supported). You can only add custom link types for on-premises environments.
If you edit a plan and don't see the changes you made appear in the plan, refresh your browser. A browser refresh is needed some times to trigger the updates.
Show dependency lines for a work item
Open the delivery plan from Boards>Delivery Plans.
To view dependency lines for a work item, select the bottom of its card. To dismiss the lines, select the bottom of the card again, or anywhere else within the plan.
Dependency lines that have no issues show up as black lines.
Dependency lines show between work items that exist on the same backlog for a team, but not for work items that exist in different projects and team backlogs.
Dependency lines that have issues, show up with red lines. The issues indicate that the successor work item is scheduled to end later than the predecessor work item.
Open the dependency summary for a work item
To drill down into specific dependencies, open the Dependencies dialog for the work item. Hover over the card and then choose the link icon.
For example, here we choose the link icon for a work item with dependencies to several work items within the same project.
The Dependencies dialog indicates that the work item has four predecessors and no issues.
Identify dependency issues
When issues exist, they're highlighted in red. The issue always has to do with an end date for a successor work item occurring before the end date of the predecessor work item. Determine the end date by using either the Target Date for the work item or the End Date of the work item's assigned Iteration Path.
For example, the following Dependencies dialog indicates that two predecessor work items are scheduled to complete before the successor work item is scheduled to complete. A red exclamation mark and red colored arrows indicate there's an issue with the dependency.
When the dependency is to a work item in another project, the project information is shown as are other link relationships.