链接到其他对象的工作项

  • 项目

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

通过链接到其他对象（例如生成、提交、拉取请求等）的工作项，支持团队维护相关工作的审核线索。 所有用户都可以向其工作项添加链接。

可以从以下区域输入 #ID ，以链接到工作项：

  • 工作项讨论或任何富文本字段
  • Git 提交注释和拉取请求说明
  • TFVC 更改集或货架集注释
  • Wiki 页面
  • 工作项讨论
  • Git 提交注释和拉取请求说明
  • TFVC 更改集或货架集注释

提示

可以设置自动链接和其他设置，将工作项链接到 Git 提交、拉取请求、生成等。 若要了解如何操作，请参阅以下资源：

用于将工作项链接到 devops 对象的链接类型（如下图所示）是生成、在生成中找到、在生成中集成、用于生成和发布管道的集成版本;Git 存储库的分支、提交、拉取请求和标记，以及适用于 Team Foundation 版本控制 (TFVC) 存储库的变更集、货架集和 VersionedItem。 这些都指定为外部链接类型。

Conceptual image of link types used to link work items to devops objects.

在工作项窗体中，“ 链接 ”选项卡可以查看 链接到工作项的所有对象 ，如本文稍后所述。 但是，无法创建工作项查询来列出这些链接。 工作项查询仅返回链接到其他工作项的工作项。 但是，可以创建一个查询来列出包含外部链接的工作项。 若要了解如何操作，请参阅 按链接或附件计数进行查询。

注意

还可以链接到来自GitHub提交、拉取请求和问题的工作项。 这需要将Azure DevOps项目连接到GitHub存储库。 有关详细信息，请参阅 Azure Boards-GitHub集成。

  1. 输入 # 以在拉取请求提交、提交注释、更改集注释、搁置集注释、说明等中触发 #ID 工作项选取器。 你会看到最近修改或分配给你的 50 个工作项的列表。

    Screenshot of work item list produced when entering # in PR description.

  2. 通过输入与工作项类型、ID 或标题匹配的关键字来缩小建议的工作项列表范围。

    Screenshot of entering keyword after # and resulting work item in search

    若要进一步筛选列表，请继续输入关键字，直到找到匹配项。 最多可以输入五个关键字。

在拉取请求中设置工作项状态

创建拉取请求时，可以在说明中设置链接工作项 的状态 值。 遵循语法： {state value}: #ID。 合并拉取请求时，系统会读取说明并更新工作项状态。 在以下示例中，我们将工作项 #300 和 #301 设置为“已解决”，并将 #323 和 #324 设置为“已关闭”。

Screenshot of setting work item state within a PR.

注意

此功能需要安装 Azure DevOps Server 2020.1 更新。 若要了解详细信息，请参阅 Azure DevOps Server 2020 Update 1 RC1 发行说明，Boards。

工作原理

在尝试设置#mentioned工作项的状态时，系统会按以下三种不同的条件 () ：

  • 状态
  • 状态类别
  • 关键字 (keyword)

条件逻辑

下表描述了逻辑。

条件 操作
如果 值与状态匹配， 然后将其 设置为该状态。
否则，如果 值与状态类别匹配， 然后将 工作项设置为该类别中的第一个状态。 请参阅以下 说明。
否则，如果 值与关键字匹配， 然后将 工作项设置为匹配关键字状态。 请参阅 下表。
Else 忽略它，不执行任何操作。

关键字逻辑

关键字逻辑有助于进行意向匹配。 例如，可以输入“解析”，但实际上意味着“已解决”。

关键字 操作
建议、建议、建议 设置为“建议”类别中的第一个状态。
正在进行 设置为“正在进行”类别中的第一个状态。
已完成、完成、完成 设置为“已完成”类别中的第一个状态。
已解决、解析、解决 设置为“已解析”类别中的第一个状态。
修复、修复、修复 关闭工作项。 Bug 除外，该 Bug 设置为“已解决”。

注意

使用托管 XML 进程的项目不支持类别匹配。 类别匹配仅适用于使用继承过程的项目。

可以从 “添加链接 ”对话框将工作项链接到现有生成。 这些生成可以位于项目内或组织或集合中的其他项目。

注意

此功能需要安装 Azure DevOps Server 2020.1 更新。 若要了解详细信息，请参阅 Azure DevOps Server 2020 Update 1 RC1 发行说明，Boards。

  1. 在工作项的“ 链接 ”选项卡中，选择 “添加 linkExisting>”项。

  2. 在“添加链接”对话框中，选择生成链接类型之一（生成、在生成中找到、生成中集成）并指定内部版本号。

    如果不知道生成号（管道和生成名称的组合），可以通过选择 图标来搜索它。

    Add link dialog with Build link type selected.

  3. 从 “链接生成 ”对话框中，选择要筛选生成搜索的参数。

    如果链接到其他项目中的生成，请先选择要链接到其生成Project。

    例如，可以指定生成编号、选择生成管道、生成结果，例如“ 全部”、“ 成功”、“ 部分成功”、“ 失败”或 “已取消”。 或者，选择 “所有 结果 ”后，选择 “查找 ”列出要链接到的可用版本。

    Find builds dialog with project selected and builds listed.

  4. 从要链接到的列表中选择生成，然后选择 “确定”。

  5. 在 “添加链接 ”对话框中，选择“ 确定 ”以完成操作。

    Add link dialog with Build number filled in.

可以从 “添加链接 ”对话框将工作项链接到现有生成。

  1. 从工作项的“ 链接 ”选项卡中，选择 “添加 linkExisting> 项”。

  2. 在 “添加链接 ”对话框中，选择生成链接类型之一（“生成”、“ 在生成中找到”、“ 在生成中集成”）并指定内部版本号。

    如果不知道生成号（管道和生成名称的组合），可以通过选择 图标来搜索它。

    Add link dialog with Build link type selected.

  3. 从 “链接生成 ”对话框中，选择要筛选生成搜索的参数。

    例如，可以指定生成编号、选择生成管道、生成结果，例如“ 全部”、“ 成功”、“ 部分成功”、“ 失败”或 “已取消”。 或者，选择 “所有 结果 ”后，选择 “查找 ”列出要链接到的可用版本。

    Find builds dialog, link to a build within your project.

  4. 从要链接到的列表中选择生成，然后选择 “确定”。

  5. 在 “添加链接 ”对话框中，选择“ 确定 ”以完成操作。

    Add link dialog with Build number filled in.

从 Wiki 页面链接到工作项

输入 # 以从 Wiki 页面中触发 #ID 工作项选取器。

有关内置 Wiki 的详细信息，请参阅 添加 & 编辑 Wiki 页面 和 Wiki Markdown 指南。

还可以将查询结果表链接到 Wiki。 这支持快速访问查询中的每个链接工作项。 有关详细信息，请参阅 Wiki Markdown 指南。

查看链接对象列表

若要查看链接到工作项的所有对象的列表，请打开工作项并选择“ 链接 ”选项卡。“链接”选项卡指示所有链接对象的计数。

Screenshot of Links tab with count of linked objects.

链接对象按其链接类型进行分组，每个组内的计数。 你可以展开或折叠每个组，并通过选择相应的列标题按 状态、 最新更新或 批注 对每个组进行排序。

例如，以下 “链接 ”选项卡显示工作项的 64 个链接对象的一部分。

Screenshot of Links tab with many linked objects.

前面带有 红色感叹号的链接指示已删除生成、发布或其他对象。 这通常是由于保留策略在某个时间段过后自动删除这些对象。

Azure Repos、Git