删除、删除或还原Azure Boards中的工作项

  • 项目

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

工作项可以永远生活在工作跟踪数据存储中。 你永远不必删除它们。 但是，你可能想要为下列操作之一设置工作项管理过程：

  • 更改状态：通过将工作项 状态 更改为 “删除 ”或 “剪切”，从积压工作和板上显示工作项。 可用的状态基于分配给工作项类型的工作流。
  • 删除：从积压工作、板和查询中删除工作项。 已删除的工作项将移动到 回收站。
  • 还原：通过从 回收站还原已删除的工作项来恢复它们。
  • 销毁：永久删除工作项，这会从工作跟踪数据存储中删除所有数据。

注意

目前不支持存档工作项或项目的功能。

若要将工作项从一个项目移到另一个项目，或更改工作项类型，请参阅 “移动工作项”，更改工作项类型。

注意

有关Azure Artifacts回收站的信息，请参阅“删除和恢复包”。

先决条件

通常， 参与者 组的成员可以删除、删除和还原工作项。 若要永久删除工作项，你必须是Project管理员组的成员，或被授予所需的权限。 具有 利益干系人 访问权限的用户可以查看 回收站的内容，但无论他们授予的权限如何，都无法还原或永久删除垃圾箱中的项目。

任务

所需的权限 (s)

将状态更改为“删除”或“剪切”

  • 将区域路径权限设置为“允许：编辑此节点中的工作项”
  • 默认情况下， 参与者 组的成员具有此权限。

删除工作项 和
还原工作项

  • 将项目级权限设置为“允许：删除和还原工作项”
  • 具有 基本 访问权限或更高版本。
  • 默认情况下， 参与者 组的成员具有此权限。

从命令行永久删除或销毁工作项

成为Project管理员组的成员。

永久删除或销毁工作项

  • 将项目级权限设置为“允许：永久删除工作项”
  • 默认情况下，Project管理员组的成员具有此权限。

从命令行中删除或销毁工作项

  • 将项目级权限设置为“允许：永久删除工作项”
  • 默认情况下，Project管理员组的成员具有此权限。

有关分配给内置组的权限的简化视图，请参阅 “权限和访问权限”。

注意

具有 公共项目利益干系人 访问权限的用户可以完全访问所有工作跟踪功能，就像具有 基本 访问权限的用户一样。 有关详细信息，请参阅 利益干系人访问快速参考。

删除或删除多个工作项

可以处理单个工作项，也可以批量修改多个工作项。

在 Web 门户中，可以从积压工作或查询结果页中多选多个工作项。 还可以使用关联的功能进行批量更新。 若要同时删除或还原多个工作项，请参阅 批量修改工作项。

删除工作项

通过将工作项 的状态 更改为 “已删除”，可以有效地将其从积压工作或板视图中删除， (产品、项目组合和冲刺积压工作、看板和任务板) 。 “已删除”状态对应于“已删除”工作流类别状态。 如果 定义自定义工作流状态，则映射到 “已删除 ”工作流类别状态的任何状态都将采用类似的方式。

Screenshot of work item form, Change State to Removed.

若要导致删除的项未显示在查询中，必须添加一个在 State 字段中筛选的子句。

注意

基本进程不支持 “已删除 ”状态。 它仅受敏捷、Scrum 和 CMMI 处理工作项类型支持。 将项目添加到 Azure DevOps Services 或 Azure DevOps Server 2019 Update 1 时，基本过程可用。

删除工作项

已删除的工作项不会显示在积压工作、板或查询中。 已删除的项目将移动到 回收站 ，如果需要，可以从中恢复它们。 若要删除测试用例、测试计划或其他与测试相关的工作项类型，请参阅 “删除测试项目”。

可通过以下方式之一删除工作项：

  • 在工作项窗体中
  • 从 “工作项 ”页 “更多操作 ”菜单
  • 从看板卡 上下文菜单
  • 从积压工作或查询结果页。

  1. 启动删除操作：

    在工作项窗体中，打开工作项，选择 “操作”，然后选择“ 删除”。

    Screenshot of work item form, Actions menu, choose Delete.

    若要删除多个工作项，请 从积压工作或查询结果列表中选择多个工作项，选择 上下文菜单，然后选择“ 删除”。

    Screenshot of backlog multi-select Actions menu, choose Delete.

    若要从看板或任务板中删除工作项，请选择 卡片的上下文菜单，然后选择“ 删除”。

    Screenshot of Kanban board card context menu, choose Delete.

  2. 确认要实际删除项 () 。

    Confirm delete dialog.

  1. 可以从工作项窗体内删除工作项，也可以通过从积压工作或查询结果页中选择工作项。

    若要删除单个工作项，请打开工作项，选择 “操作”，然后选择“ 删除”。

    Screenshot of work item form, Actions menu, Delete option, TFS 2018 version.

    若要删除多个工作项，请 从积压工作或查询结果列表中选择它们。 然后，选择 操作图标，然后选择“ 删除”。

    Screenshot of List of work items, actions menu, Delete, TFS 2018 version.

    还可以从看板或任务板中删除工作项。

    Screenshot of Kanban board, Delete work item, TFS 2018 version.

    或者，可以将它们拖到 回收站。 只能从工作中心访问回收站。

  2. 确认要实际删除项 () 。

    Confirm delete dialog, TFS 2018 version.

    注意

    本地Azure DevOps的“删除工作项确认”对话框可能指示 (禁用) 存在自动删除设置。 没有可以启用或禁用的设置。 只有一个后台进程可永久删除已设置为删除的工作项。

还原或销毁工作项

无法打开已移动到 回收站的工作项。 此外，仅当永久删除工作项项目级权限设置为“允许”时，才会看到“永久删除”选项。

还原已删除的工作项或从 Web 门户 回收站永久删除它们。

  1. 选择Boards>“工作项”，然后选择回收站。

    Screenshot of Boards, Work Items page, Open Recycle bin.

    如果未看到 “回收站 ”选项，请选择 “更多命令...” ，并从选项菜单中选择它。

  2. 此时会打开一个新的浏览器选项卡，其中包含列出添加到 回收站的工作项的查询。

  3. 选择要还原的项，然后选择 “还原”。

    Screenshot of Restore selected items.

    （可选）可以选择永久删除项。

  4. 确认选择。

从 Web 门户 回收站还原已删除的工作项。

  1. 选择 “工作>积压工作” 或 “工作>查询 ”，然后选择 回收站。

    Screenshot to Open Recycle bin, TFS 2018 version.

    此时会打开一个新的浏览器选项卡，其中包含列出添加到 回收站的工作项的查询。

  2. 选择要还原的项，然后选择 “还原”。

    ![还原所选项（TFS 2018 版本）的屏幕截图。

    （可选）可以选择永久删除项。

  3. 确认选择。

注意

已删除的测试项目不会显示在 回收站 中，无法还原。 删除测试项目会删除所选测试项目及其所有关联的子项，例如子测试套件、所有配置中的测试点、测试人员 (基础测试用例工作项不会删除) 、测试结果历史记录和其他关联历史记录。

从命令行中删除或销毁工作项

可以使用 az boards work-item delete 命令删除或销毁工作项。 若要开始使用，请参阅 Azure DevOps CLI 开始。

注意

可以还原 删除的工作项，但无法还原选择 销毁的工作项。

az boards work-item delete --id
                           [--destroy]
                           [--org]
                           [--project]
                           [--yes]

参数

  • id：必需。 工作项的 ID。
  • 销毁：可选。 永久删除此工作项。
  • 组织：Azure DevOps组织 URL。 You can configure the default organization using az devops configure -d organization=ORG_URL. 如果未配置为默认或使用 git config选取，则为必需。 示例：--org https://dev.azure.com/MyOrganizationName/。
  • 项目：项目的名称或 ID。 You can configure the default project using az devops configure -d project=NAME_OR_ID. 如果未配置为默认或使用 git config选取，则为必需。
  • 是：可选。 不要提示确认。

示例

以下命令永久删除 ID 为 864 的 bug，不会提示你进行确认。

az boards work-item delete --id 864 --destroy --yes

从命令行销毁工作项

witadmin destroywi使用命令从数据存储中永久删除工作项。 永久删除意味着删除工作跟踪数据存储中的所有信息，并且无法还原或重新激活。

注意

TFS 2018.2 及更高版本弃用从witadmin命令行中删除工作项，不支持Azure Boards云服务。

打开命令提示符窗口，其中安装了最新版本的Visual Studio，并将目录更改为已安装该工具的位置witadmin.exe。

例如，将更改为 TFS 2018 的以下目录。 (对于其他版本，请参阅 “永久删除工作项” (witadmin destroywi) ) 。

%programfiles(x86)%\Microsoft Visual Studio\2018\Professional\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

在 32 位版本的 Windows 上，将 %programfiles(x86)% 替换为 %programfiles%。

witadmin命令行工具随任何版本的Visual Studio或团队资源管理器一起安装。 可以通过安装免费版本的 Visual Studio Community来访问此工具。

  • 若要删除多个工作项，请输入集合的服务器名称和目录路径。 例如：

      witadmin destroywi /collection:http://TFSServerName:8080/tfs/DefaultCollection /id:12,15,23

  • 若要删除单个工作项，请输入如下所示的 ID：

      witadmin destroywi /collection:http://TFSServerName:8080/tfs/DefaultCollection /id:2003

删除和还原进程

删除工作项时，将执行以下操作：

  • 生成工作项的新修订
  • 更新 更改日期/更改日期 字段以支持可跟踪性
  • 完全保留工作项，包括所有字段分配、附件、标记和链接
  • 使工作项变得不可查询，因此不会出现在任何工作跟踪体验、查询结果或报表中
  • 正确更新图表。 将更新CFC、速度、烧毁和轻型图表以删除已删除的工作项
  • 删除工作跟踪扩展
  • 保留趋势数据，但最新值除外
  • 从数据仓库/多维数据集中删除工作项，就像永久删除一样。

还原工作项时，将执行以下操作：

  • 导致对工作项进行新的修订
  • 更新 更改日期/更改日期 字段以支持可跟踪性
  • 变为可查询
  • 所有字段保持不变
  • 历史记录包含两个新修订，一个用于删除，一个用于还原
  • 重新附加工作跟踪扩展
  • 正确更新图表。 将更新CFC、速度、烧毁和轻型图表，以包括还原的工作项
  • 还原趋势数据
  • 将工作项重新添加到数据仓库/多维数据集
  • 如果删除了以前的区域路径或迭代路径，则将区域或迭代路径字段设置为根节点。

使用 REST API 删除、还原和销毁工作项

若要以编程方式删除、还原和销毁工作项，请参阅以下 REST API 资源之一：