通过REST API获取工作项的父项

Question

我们正在开发Azure DevOps扩展，以将对工作项的更改推送到外部系统。

我们想在目标系统的Azure DevOps（Epic-> Feature-> PBI / Bug）中维护/保留层次结构，因此我们需要弄清楚工作项具有哪个父项。

从API中提取工作项实体时，它看起来像这样（略）

{
    "id": 5202,
    "rev": 2,
    "fields": {
        "System.WorkItemType": "Task",
        "System.State": "To Do",
        "System.Reason": "New task",
        "System.CreatedDate": "2017-10-30T10:18:06.233Z",
        "System.CreatedBy": "Jesper Lund Stocholm",
        "Microsoft.VSTS.Common.Priority": 2,
        "Microsoft.VSTS.Scheduling.RemainingWork": 23.0,
        "Microsoft.VSTS.Common.StateChangeDate": "2017-10-30T10:18:06.233Z",
    },
    "_links": {
            "self": {
            "href": "https://{myorg}.visualstudio.com/_apis/wit/workItems/5202"
        },
        "workItemUpdates": {
            "href": "https://{myorg}.visualstudio.com/_apis/wit/workItems/5202/updates"
        },
        "workItemRevisions": {
            "href": "https://{myorg}.visualstudio.com/_apis/wit/workItems/5202/revisions"
        },
        "workItemHistory": {
            "href": "https://{myorg}.visualstudio.com/_apis/wit/workItems/5202/history"
        },
        "html": {
            "href": "https://{myorg}.visualstudio.com/web/wi.aspx?pcguid=e5d991b2-9879-497c-85fb-c618f144a9c5&id=5202"
        },
        "workItemType": {
            "href": "https://{myorg}.visualstudio.com/6847ebed-cbca-4510-8baa-228c7c55ba8d/_apis/wit/workItemTypes/Task"
        },
        "fields": {
            "href": "https://{myorg}.visualstudio.com/_apis/wit/fields"
        }
    },
    "url": "https://{myorg}.visualstudio.com/_apis/wit/workItems/5202"
}

显而易见的地方是这里https：// {myorg} .visualstudio.com / _apis / wit / fields

但是我们找不到对“父实体”的引用的任何痕迹。

可以不公开此值吗？

Answer 1

您可以通过$expand=relations在api字符串中添加来获取所有工作项链接（父母，孩子等）。

例如：

https://shaykia.visualstudio.com/_apis/wit/workItems/4?$expand=relations

结果中，您将看到“关系”部分：

https://shaykia.visualstudio.com/_apis/wit/workItems/4?$expand=relations

System.LinkTypes.Hierarchy-Reverse适用于父级（在这种情况下，标识为3的工作项他是父级），并且System.LinkTypes.Hierarchy-Forward适用于子级。