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

Question

我正在使用 TFS REST API 并尝试按标题检索工作项及其子项(父项的标题是参数)。我找不到使用 TFS REST API 检索这些链接项的方法。

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

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

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

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

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

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

返回

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

这意味着有 4 个相关链接指向工作项“some title”，但它们没有被返回。我在这里错过了什么？我如何获得这些相关链接/子项？

Answer 1

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

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

• 参见:https://www.visualstudio.com/en-us/docs/integrate/api/wit/work-items#with-links-and-attachments

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

• 参见:https://www.visualstudio.com/en-us/docs/integrate/api/wit/reporting-work-item-links