VSTS / TFS REST API-提取工作項及其鏈接的項

Question

我正在使用VSTS / TFS Web API和以下代碼檢索一些用戶故事：

var getWorkItemsHttpRequestMessage = new HttpRequestMessage(new HttpMethod("GET"), uri + "/_apis/wit/workitems?ids=736,731&&api-version=4.1");
var getWorkItemsHttpResponse = client.SendAsync(getWorkItemsHttpRequestMessage).Result;

if (getWorkItemsHttpResponse.IsSuccessStatusCode)
{    
    var workItems = getWorkItemsHttpResponse.Content.ReadAsAsync<HttpWorkItems>().Result;
    // ...

該查詢返回工作項的所有字段（在這種情況下為用戶素材），但不返回鏈接到它們的其他項。 我想檢索與這些用戶故事相關的任務。

如何做呢 ？ 還有另一種更好的方法嗎？

Answer 1

您可以將URL中的$expand參數與值relations ：

https://dev.azure.com/{organization}/{project}/_apis/wit/workitems/4?$expand=relations&api-version=4.1

在結果中，您將在部分relations獲得工作項鏈接：

"relations":[
 {
   "rel":"System.LinkTypes.Hierarchy-Forward",
   "url":"https://dev.azure.com/shaykia/_apis/wit/workItems/5",
   "attributes":{
   "isLocked":false
}

在上面的示例中，我們檢查了API中的工作項4 ，在結果中，我們可以看到工作項5通過類型為System.LinkTypes.Hierarchy-Forward鏈接到他，而工作項4是5的父項（ 5他是孩子，在這種情況下是一項任務）。

您可以在此處閱讀有關關系類型的信息。