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

  • 项目

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

工作项可以永久保存在工作跟踪数据存储中。 永远不必将其删除。 但是，你可能希望为以下操作之一设置工作项管理流程：

操作 说明
更改状态 通过将工作项“状态”更改为“移除”或“剪切”，可将工作项从积压工作 (backlog) 和版块中移除。 可用的状态取决于分配给工作项类型的工作流。
删除 将工作项从积压工作 (backlog)、版块和查询中移除。 已删除的工作项将移到回收站。
还原 通过从回收站还原已删除的工作项可恢复这些工作项。
Destroy 永久删除工作项，包括将所有数据从工作跟踪数据存储中删除。

注意

  • 目前无法存档工作项或项目。
  • 有关 Azure Artifacts 回收站的信息，请参阅删除和恢复包。

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

先决条件

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

任务

所需的权限

将状态更改为移除或剪切

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

删除工作项和
还原工作项

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

永久删除或销毁工作项

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

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

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

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

注意

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

移除或删除多个工作项

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

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

还可以使用 REST API 批量删除和/或销毁工作项。 有关详细信息，请参阅工作项 - 删除。

注意

此功能从 Azure DevOps Server 2022.1 开始提供。

移除工作项

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

工作项窗体、将状态更改为“已移除”的屏幕截图。

若要使已移除的项不显示在查询中，必须添加一个子句，用于筛选状态字段。

注意

基本流程不支持已移除状态。 该状态仅支持敏捷、Scrum 和 CMMI 流程的工作项类型。 将项目添加到 Azure DevOps Services 或 Azure DevOps Server 2019 Update 1 时，可以使用基本流程。

删除工作项

已删除的工作项不会显示在积压工作 (backlog)、版块或查询中。 删除某个项时，该项会进入“回收站”。 如果改变想法，可以从那里还原它。 若要删除测试用例、测试计划或其他与测试相关的工作项类型，请参阅删除测试生成工件。

可以使用以下方式之一删除工作项：

  • 工作项表单
  • 从“工作项”页“更多操作”菜单
  • 从看板卡片 上下文菜单
  • 从积压工作 (backlog) 或查询结果页
  • REST API

  1. 启动删除操作：

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

    工作项窗体、“操作”菜单、选择“删除”的屏幕截图。

    积压工作多选“操作”菜单、选择“删除”的屏幕截图。

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

    看板卡片上下文菜单、选择“删除”的屏幕截图。

  2. 确定要删除该项。

    “确认删除”对话框的屏幕截图。

还原或销毁工作项

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

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

  1. 选择板>工作项>回收站。

    “版块”、“工作项”页、打开回收站的屏幕截图。

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

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

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

    还原所选项的屏幕截图。

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

  3. 确认选择。

注意

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

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

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

注意

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

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

参数

  • id：必需。 工作项的 ID。
  • destroy：可选。 永久删除此工作项。
  • org：Azure DevOps 组织 URL。 可以使用 配置默认组织 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 选取，则此参数是必需的。
  • yes：可选。 不提示确认。

示例

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

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

删除和还原流程

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

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

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

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

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

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