如何使用 Visual Studio REST API 获取任务的用户故事答案

【问题标题】：How to Get User Story for a Task Using Visual Studio REST API如何使用 Visual Studio REST API 获取任务的用户故事
【发布时间】：2016-03-27 03:06:20
【问题描述】：

我正在尝试使用 Visual Studio 的 API 将有关 Visual Studio Online 团队的工作项的信息收集到 Excel 文档中。通过使用 API 调用提取其 json 字段，我可以获取工作项的信息以及每个项是用户故事、任务还是错误。但是，我不知道如何获取任务或错误的“父”用户故事。例如。任务将在我的工作板上的用户故事部分中，但我在工作项的可能 json 键中看不到与该故事相对应的任何字段。

我可以看到的工作项的键是：

['System.AuthorizedDate',
 'System.WorkItemType',
 'System.Title',
 'System.IterationLevel1',
 'System.IterationLevel2',
 'System.History',
 'System.AreaId',
 'System.NodeName',
 'Microsoft.VSTS.Common.ActivatedDate',
 'System.IterationId',
 'System.IterationPath',
 'System.PersonId',
 'System.AssignedTo',
 'System.AuthorizedAs',
 'System.Id',
 'System.Reason',
 'System.CreatedBy',
 'Microsoft.VSTS.Common.StateChangeDate',
 'Microsoft.VSTS.Common.Priority',
 'System.Watermark',
 'Microsoft.VSTS.Common.ActivatedBy',
 'System.AreaPath',
 'System.State',
 'System.ChangedDate',
 'System.AreaLevel1',
 'System.CreatedDate',
 'System.TeamProject',
 'System.Rev',
 'System.ChangedBy',
 'System.RevisedDate']

它们的值都不对应任何与用户故事的文本匹配或为用户故事的 json 提供 url 的内容。

有谁知道如何使用 API 调用获取任务或错误的父级（用户故事）？

【问题讨论】：

标签： api rest azure-devops workitem

【解决方案1】：

在您的请求网址中添加“expand=all”或“expand=relations”将显示链接的工作项，并且“System.LinkTypes.Hierarchy-Reverse”类型指向父工作项。

例子：

https://xxxxx.visualstudio.com/defaultcollection/_apis/wit/workitems?ids=47&$expand=relations&api-version=1.0

【讨论】：

非常感谢！您不知道我为多个工作项一次扩展的 url 寻找了多长时间。 :) 你知道System.LinkTypes.Hierarchy-Reverse 和System.LinkTypes.Related 有什么区别吗？它们都出现在我的“关系”下，但它们用于不同的卡片（实际上，“相关”与原始卡片的 url 相同。我不明白为什么 VSO 有所有这些自引用循环）。
Hierarchy-Reverse 是我头顶上的 Parent（来自 Parent-Child）。相关只是相关链接类型。任何链接都显示在关系下。 VSO（和 TFS）一直有一个很长的链接类型列表，每种类型都有自己的用途，并且经常链接到特定的功能。大部分在这里解释：msdn.microsoft.com/en-us/library/dd293527.aspx