如何通过RESTful API获取Versionone的“完成”时间？

Question

例如：当我查找任务的所有属性时 https://<host>/VersionOne/rest-1.v1/Data/Task
我得到的信息包括“Todo”和“DetailedEstimates”，但没有任何与“完成”小时相关的信息

您是否知道是否有办法通过VersionOne的Rest API获取给定任务/测试/等的“完成”小时？

Answer 1

“完成”不是单个值，因此必须通过关系查询。表示一个小时条目的资产类型称为“实际”。通过Workitem基础的关系称为Actuals。

因此，您可以使用Story，甚至Workitem等“查询”您的查询。然后使用'sel'选择成员和值（小时）。

http://<host>/VersionOne/rest-1.v1/Data/Story?sel=Name,Actuals.Date,Actuals.Value,Actuals.Member

这可能有点压倒性数据，因此您可能希望将其限制为一个故事：

/rest-1.v1/Data/Story/1038?sel=Name,Actuals.Date,Actuals.Value,Actuals.Member

请注意，如果您在任务/测试级别而非故事级别进行跟踪，则还必须导航该关系：

/rest-1.v1/Data/Story/1031?sel=Name,Actuals.Date,Actuals.Value,Actuals.Member,Children.Actuals.Date,Children.Actuals.Value,Children.Actuals.Member

您可以采用的另一种方式来自实际资产本身。数据相同但结果可能更耗尽：

/rest-1.v1/Data/Actual?sel=Date,Value,Member.Name,Workitem.Name

Answer 2

此外，您可以为每个任务总结所有实际值

https://<host>/VersionOne/rest-1.v1/Data/Task?sel=Name,Actuals.Value.@Sum