Question

我正在尝试使用Version One api来获取项目和sprint burndown图表。

我正在阅读this page，但我感到困惑。

有没有人做过类似的事情，并且有关于如何点击api以获得我想要的东西的任何提示？

Answer 1

VersionOne api不提供图像或图表特定数据。您可以使用查询语言和其余端点来生成燃尽所需的数据。您需要能够自己读取/解析数据并生成图表。

有了这样的说法，燃尽图比较了封闭估计与开放估计的数量以及随时间变化的图表。所以你需要知道三个数据：公开估计，封闭估计和时间。您还希望将其限制为某个项目（并且它是孩子们）。

这可以让您接近项目燃尽所需的数据：

http://<host>/VersionOne/rest-1.v1/Data/Timebox?where=Schedule.ScheduledScopes='Scope:1055'&sel=Name,BeginDate,EndDate,Workitems:Story[AssetState!='Closed'].Estimate.@Sum,Workitems:Story[AssetState='Closed'].Estimate.@Sum&sort=+EndDate

请务必将范围：1055更改为您感兴趣的项目。

这就是我到达那里的方式。首先，我想“你需要总结一堆故事估计”，所以我想我会对故事进行历史查询：

http://<host>/VersionOne.Web/rest-1.v1/Hist/Story?where=Scope.ParentMeAndUp='Scope:1055'

但很快发现你无法在你的根上聚合。这意味着如果我想总结估计，我需要使用像Project（范围）这样的东西来获取数据：

http://<host>/VersionOne.Web/rest-1.v1/Hist/Scope/1055?sel=Workitems:Story[AssetState!='Closed'].Estimate.@Sum,Workitems:Story[AssetState='Closed'].Estimate.@Sum,ChangeDate

这个查询的问题在于给出了在奇怪的时间间隔内闭合与开放估计的结果。即每当项目改变时。所以它不会是一个非常漂亮的图形。

但是，正如您所知，VersionOne具有与项目关联的迭代和计划的概念，并且故事与迭代相关联。因此，我将其用作查询和汇总故事估计的根，并将数据限制为使用该计划的项目。

生成的数据更加规则（按迭代分组）并包含正确聚合的估算数据。

那剩下什么了？您必须汇总估算数据的汇总，以获得项目的总估算数。然后，您需要生成一个图形（可能是条形或线条），其中每个数据点都在迭代结束时。您将保持运行总计的封闭估计值，并将其添加到迭代的总数中以生成数据点。

Answer 2

您需要执行多个查询才能产生燃尽。首先找到燃尽的日期范围：

/Data/Timebox?sel=BeginDate,EndDate&where=Name='X'

现在每天都有日期范围，总结历史记录中的ToDo小时数：

/Hist/Timebox?asof=2013-08-09T23:59:59&where=Name='X'&sel=Workitems[Team.Name='Y';AssetState!='Dead'].ToDo.@Sum

API和文档非常好。如果您有兴趣查看某些自定义报告的代码，请查看https://github.com/timothypratley/vone/blob/master/src/vone/models/queries.clj（代码位于Clojure中）。有一个燃尽，累积的流量，以及更多：）

Answer 3

现在query for burndown data的“配方”适用于query.v1 API端点。

如何使用版本1 api获取项目和sprint burndown图表？

3 个答案: