使用拉取请求自动完成工作项

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

在将工作项链接到拉取请求 (PR) 时,你可以在完成 PR 时自动完成这些工作项。 或者,可以指定工作流状态,以在合并 PR 时将工作项转换为该状态。

在将工作项链接到拉取请求 (PR) 时,你可以在完成 PR 时自动完成这些工作项。

有关详细信息,请参阅创建、查看和管理拉取请求

先决条件

  • 权限

    • 若要查看、关注和编辑工作项,请在此节点中查看工作项,并在此节点权限中编辑工作项设置为“允许”。 默认情况下,参与者组具有这些权限。 有关详细信息,请参阅设置工作跟踪权限
  • 若要将标记添加到工作项,请将项目级 “创建新标记定义 ”权限设置为“ 允许”。 默认情况下,参与者组拥有此权限。

  • 访问级别:

    • 成为项目成员
    • 若要向工作项添加新标记或查看或关注拉取请求,请至少具有基本访问权限。
    • 若要查看或关注工作项,至少 具有利益干系人 访问权限。 有关详细信息,请参阅关于访问级别
    • 所有项目成员(包括 读者 组中的项目成员)都可以发送电子邮件,其中包含工作项。

    注意

    • 为希望参与讨论和评审进度的成员提供 利益干系人访问权限 。 这些成员通常不参与代码,但想要查看工作项、积压工作、面板和仪表板。
    • 默认情况下,公共项目中所有 参与者利益干系人 都可以添加新和现有标记。 在专用项目中,利益干系人只能添加现有标记。 若要控制创建新标记的能力,请在项目级别设置 创建标记定义 权限。 有关详细信息,请参阅 更改项目级权限

注意

  • 为希望参与讨论和评审进度的成员提供 利益干系人访问权限 。 这些成员通常不参与代码,但想要查看工作项、积压工作、面板和仪表板。
  • GitHub 权限: 成为 GitHub 存储库的参与者

自动完成工作项

如下图所示,选中在合并后完成链接的工作项框。 系统默认为你对将来 PR 的选择。

“完成拉取请求”对话框,在合并后完成链接的工作项

“完成拉取请求”对话框,使用 PR 完成选项自动完成工作项

在以下情况下,系统不会自动将工作项类型 (WIT) 的工作项状态更新为完成已关闭已完成类别:

  • 其 WIT 使用继承进程模型管理的工作项已处于已解决状态。 在此实例中,系统不会更新状态。 例如,如果派生自敏捷流程的 bug 处于已解决状态,则系统不会将其转换为已关闭
  • 工作项已处于已完成状态。 不需要进行进一步转换。
  • WIT 包括工作流字段规则,这些规则会阻止工作项进入下一个状态。 例如,规则可能需要在关闭工作项时定义另一个字段。
  • 对于本地部署和 Azure Boards 托管流程模型,必须修改工作流以指定在转换工作流时要执行的操作(ACTION 元素)。 有关详细信息,请参阅更改 WIT 的工作流,指定操作

有关详细信息,请参阅自定义工作跟踪体验

指定已链接工作项的工作流状态

若要将工作项转换为特定工作流状态,可以在拉取请求说明中输入信息。 在 #ID 前添加提及的工作项的有效工作流状态。

注意

此功能需要 Azure DevOps Server 2020.1 更新或更高版本。

以下示例显示已转换的用户情景 - 一个转换为已解决状态,另一个转换为评审状态。 此外,两个任务被标记为完成

拉取请求的屏幕截图,工作流状态设置为转换 #ID 工作项。

禁用自动完成关联的工作项

若要在用户完成拉取请求时禁用自动完成关联的工作项,请执行以下步骤:

  1. 转到“项目设置”>>“存储库”,选择存储库。
  2. 在“设置”选项卡中,将“提交提及工作项解决方法”开关切换为“关闭”。

不允许在提交注释中提及关闭工作项(例如“修复 #123”)。