删除、删除或还原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. 可以从工作项窗体内删除工作项,也可以通过从积压工作或查询结果页中选择工作项。

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

    工作项窗体的屏幕截图,“操作”菜单,“删除”选项,TFS 2018 版本。

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

    工作项列表、操作菜单、删除、TFS 2018 版本的屏幕截图。

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

    看板的屏幕截图,“删除工作项”,TFS 2018 版本。

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

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

    确认删除对话框 TFS 2018 版本。

    注意

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

还原或销毁工作项

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

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

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

    “板,工作项”页的屏幕截图,“打开回收站”。

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

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

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

    还原所选项的屏幕截图。

    (可选)可以选择永久删除项。

  4. 确认选择。

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

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

    打开回收站(TFS 2018 版本)的屏幕截图。

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

  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 资源之一: