如何关联ADO看板上的PBI与对应部署开发？相关查询及API方法

针对你的需求，这里有几种在Azure DevOps中获取PBI关联的部署、开发内容的可行方式：

一、用WIQL（工作项查询语言）直接查询 #

WIQL是ADO原生的查询语言，能快速筛选关联数据：

• 查询关联的开发工作项：
  如果你要找PBI下的子任务、Bug这类开发内容，用下面的查询：

  SELECT [System.Id], [System.Title], [System.WorkItemType]
  FROM WorkItemLinks
  WHERE (Source.[System.Id] = {你的PBI ID})
  AND ([System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward')
  ORDER BY [System.Id]
  

  把{你的PBI ID}换成目标PBI的ID即可，返回结果就是该PBI的层级子工作项。
• 查询关联的部署记录：
  如果你的部署是通过“关联”链接绑定到PBI的，用这个查询筛选关联的发布/部署工作项：

  SELECT [System.Id], [System.Title], [System.WorkItemType]
  FROM WorkItemLinks
  WHERE (Source.[System.Id] = {你的PBI ID})
  AND ([System.Links.LinkType] = 'System.LinkTypes.Related')
  AND Target.[System.WorkItemType] IN ('Release', 'Deployment')
  ORDER BY [System.Id]
  

二、调用Azure DevOps REST API获取数据 #

1. 获取关联的开发工作项 #

调用Work Item Tracking API，带上$expand=relations参数，就能拿到PBI的所有关联工作项：

GET https://dev.azure.com/{组织名}/{项目名}/_apis/wit/workitems/{PBI ID}?$expand=relations&api-version=7.1-preview.3

返回结果里的relations字段中，rel值为System.LinkTypes.Hierarchy-Forward的就是子开发工作项，rel为System.LinkTypes.Related的是其他关联内容。

2. 获取关联的部署信息 #

如果用ADO Release Management管理部署，可通过以下API筛选：

• 查询关联的发布记录：

  GET https://vsrm.dev.azure.com/{组织名}/{项目名}/_apis/release/releases?searchText={PBI ID}&api-version=7.1-preview.8
  

• 查询关联的部署实例：

  GET https://vsrm.dev.azure.com/{组织名}/{项目名}/_apis/release/deployments?queryOrder=descending&searchText={PBI ID}&api-version=7.1-preview.1
  

三、注意点 #

• 必须确保你的ADO项目里已经配置了PBI和部署/开发工作项的关联（比如发布时手动或自动链接工作项），否则查不到对应数据。
• 如果用了自定义链接类型关联PBI和部署，要在WIQL或API查询里替换成对应的链接类型标识。

内容的提问来源于stack exchange，提问作者Chris