使用 REST API 获取 TFS 工作项及其链接

Get TFS work item and its links using REST API

我正在使用 TFS REST API 并尝试按标题检索工作项及其 child 项(parent 的标题是参数)。我找不到使用 TFS REST API.

检索这些链接项的方法

这是我试过的。首先,我按标题查询工作项:

URI = http://[tfspath]/_apis/wit/wiql?api-version=1.0
query = SELECT * FROM WorkItem WHERE [System.Title] = 'some title'

上面的 returns 我是一个 object WorkItems,它只有 ID/URL 个匹配的工作项。然后,我在下面的查询中使用返回的 ID(假设 ID 是 1234):

URI = http://[tfspath]/_apis/wit/workitems/1234?fields=System.Title&api-version=1.0

此 returns 项目的标题和我可能包含在字段列表中的其他字段。但是,我找不到将 child 项包含在 returns 中的方法。我试过包含 System.RelatedLinks 但这不会更改返回的字段。示例:

URI = http://[tfspath]/_apis/wit/workitems/1234?fields=System.Title,System.RelatedLinkCount,System.RelatedLinks&api-version=1.0

Returns

"fields":{"System.RelatedLinkCount":4,"System.Title":"some title"}

这意味着工作项 "some title" 有 4 个相关链接,但它们没有被返回。 我在这里错过了什么?我如何获得这些相关的 links/child 项?

&$expand=relations 附加到查询字符串以获取工作项的链接集合:

$expand enum { all, relations, none }   none    
Gets work item relationships (work item links, hyperlinks, file attachements, etc.).

要获取包含所有详细信息的工作项以及包含详细信息的链接,您需要使用专用于报告目的的 API。由于返回文档的大小可能会被剪切,它会被分块,并且会给您一个水印。您可能需要执行多个请求。