Jaa


Manage issues or impediments in Azure Boards

TFS 2018

If you have known issues you want to track, you can do so by defining an impediment (Scrum) or issue (Agile or CMMI). Impediments and issues represent unplanned activities. Resolving them requires more work beyond what's tracked for actual requirements. Use the impediment work item type to help you track and manage these issues until you can resolve and close them.

Don't confuse impediments with bugs. You track impediments that may cause problems with delivering one or more requirements. For example, you may have to fix feature ambiguity, personnel or resource issues, problems with environments, or other risks that influence scope, quality, or schedule. Other issues that deserve tracking are decisions that require several stakeholders or product teams to weigh in on.

Important

Issues and Impediments discussed in this article are defined for projects created with the Agile, Scrum, or CMMI process. By default, these work item types don't appear on the product backlog or taskboard.

In this article you'll learn:

  • When to use issues versus tasks
  • How to capture issues or impediments as a work item

Prerequisites

  • You must be added to a project.
  • To view or modify work items, you must have your View work items in this node and Edit work items in this node permissions set to Allow. By default, the Contributors group has this permission set. For more information, see Set permissions and access for work tracking.
  • To add new tags to add to work items, you must have Basic access or higher and have the project-level Create new tag definition permissions set to Allow. By default, the Contributors group has this permission set. Even if the permission is explicitly set for a Stakeholder, they don't have permission to add new tags, as they're prohibited through their access level. For more information, see Stakeholder access quick reference.
  • All project members, even members in the Readers group, can send emails containing work items.

Note

The images you see from your web portal may differ from the images you see in this article. These differences result from updates made to your web app, options that you or your admin have enabled, and which process was chosen when creating your project—Agile, Basic, Scrum, or CMMI. The Basic process is available with Azure DevOps Server 2019 Update 1 and later versions.

Define a task

You use issues or impediments to track items that may block work from getting done. In general, you link these items to user stories or other work items using a Related link type.

Define tasks when you want to create a checklist of tasks. You can also define tasks if you use Scrum methods and track work using the Remaining Work field. By linking requirement work item types to tasks using the Parent-Child link type, the tasks appear on the taskboard for each linked user story.

Add an issue or impediment

From Work, choose Impediment from the New Work Item list of options. Choose the pin icon to have it show up within Work drop down menu.

Screenshot to add an Impediment from the New Work Item list, TFS 2018.

Customize issue tracking

For most work item types, you can add fields, change the workflow, add custom rules, and add custom pages to the work item form. You can also add custom work item types. For more information, see Customize the On-premises XML process model.

Impediments and issues don't appear on your backlog. Instead, you track them using queries. If you want them to appear on your backlog, or you want to track other work item types on your backlog, see Add a work item type to a backlog and board.

Add issues or impediments to your product backlog

If you want to track issues or impediments along with your requirements or a portfolio backlog, you can track them by adding them to your On-premise XML process. For more information, see Process configuration XML element reference).