我们正在开发Azure DevOps扩展,以将对工作项的更改推送到外部系统。
我们想在目标系统的Azure DevOps(Epic->功能-> 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
但是我们找不到对“父实体”的任何引用。
此值未公开是真的吗?
答案 0 :(得分:5)
通过将$expand=relations
添加到api字符串中,您可以获得所有工作项链接(父母,孩子等)。
例如:
https://shaykia.visualstudio.com/_apis/wit/workItems/4?$expand=relations
在结果中,您将看到“关系”部分:
"relations": [
{
"rel": "System.LinkTypes.Hierarchy-Forward",
"url": "http:/shaykia.visualstudio.com/_apis/wit/workItems/11",
"attributes": {
"isLocked": false
}
},
{
"rel": "System.LinkTypes.Hierarchy-Reverse",
"url": "http://shaykia.visualstudio.com/_apis/wit/workItems/3",
"attributes": {
"isLocked": false
}
}
],
System.LinkTypes.Hierarchy-Reverse
适用于父级(在这种情况下,标识为3的工作项他是父级),而System.LinkTypes.Hierarchy-Forward
适用于子级。