Track dependencies by using Delivery Plans
Azure DevOps Services | Azure DevOps Server 2022
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 several work items that have dependencies. Those cards with a green icon indicate there are no dependency issues. Those cards with a red icon indicate there are issues with one or more dependencies. Dependency issues arise when a predecessor work item is scheduled to finish after a successor work item.
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.
Tip
You can create dependencies between work items in different projects and different teams within the same organization, but not in projects in different organizations. You can open a work item and add a dependency through the links tab.
Prerequisites
Permissions:
- To view a Delivery Plan, 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, 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
- Enable a team product or portfolio backlog to select it for a plan.
- Ensure work items 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 and meet any field criteria defined for the plan appear on the plan.
- Select sprints for each team defined in the plan.
- Define start and end dates for each project iteration.
- Assign Iteration Paths or Start Date/Target Date to each work item. When defined, Start Date/Target Date overrides the sprint assigned to a work item.
- To show dependency icons and lines, link work items using Predecessor-Successor link type.
- Expand your team to view dependency icons and dependency lines.
Tip
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 top or bottom of its card. To dismiss the lines, select the top or bottom of the card again, or anywhere else within the plan.
Dependency lines that have no issues show up as black lines.
Tip
To view dependency lines across team backlogs, make sure to expand both teams.
Dependency lines that have issues, show up with red lines. The issues indicate that the successor work item is scheduled to end before the predecessor work item is completed.
To view the issue, choose the icon.
Open the dependency summary for a work item
To drill down into specific dependencies, open the Dependencies dialog for the work item. Choose the icon that indicates the work item has dependencies, either the green or red icon.
For example, here we choose the link icon for a work item with dependencies to several work items within the same project and another project.
The Dependencies dialog indicates that the work item has three predecessors and no issues.
Identify dependency issues
When conflicts arise, they are highlighted in red. These issues typically occur when a successor work item's end date is set before the predecessor work item's end date. To determine the end date, use either the Target Date for the work item or the End Date of the assigned Iteration Path.
For example, the Dependencies dialog below shows that two predecessor work items are scheduled to complete before the successor work item. A red exclamation mark and red arrows indicate an issue with this dependency.
When a dependency links to a work item in another project, the project information and other link relationships are displayed.