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

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

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

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

注意

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

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

注意

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

先决条件

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

任务

所需的权限 (s)

---

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

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

删除工作项 和
还原工作项

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

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

成为 项目管理员 组的成员。

永久删除或销毁工作项

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

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

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

---

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

注意

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

删除或删除多个工作项

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

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

删除工作项

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

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

注意

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

删除工作项

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

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

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

1. 启动删除操作：

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

   

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

   

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

   

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

   

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

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

   

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

   

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

   

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

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

   

   注意

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

还原或销毁工作项

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

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

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

   

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

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

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

   

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

4. 确认选择。

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

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

   

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

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

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

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

3. 确认选择。

注意

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

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

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

注意

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

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

参数

• id：必需。 工作项的 ID。
• destroy：可选。 永久删除此工作项。
• 组织：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。 可以使用 .. 配置默认项目 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
  

删除和还原进程

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

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

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

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

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

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

• 回收站 REST API 参考
• 工作项 - 删除 REST API 参考

相关文章

• 用于添加、更新和链接工作项的最佳工具
• 使用“工作项”页查看和添加工作项
• 删除测试项目
• 设置工作跟踪的权限和访问权限
• 更改项目级权限
• 利益干系人访问快速参考