使用 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。由于返回文档的大小可能会被剪切,它会被分块,并且会给您一个水印。您可能需要执行多个请求。
我正在使用 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。由于返回文档的大小可能会被剪切,它会被分块,并且会给您一个水印。您可能需要执行多个请求。