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

Question

我正在尝试使用sprint应用程序接口来获取项目和Version One燃尽表。

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

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

Answer 1

VersionOne应用编程接口不提供特定于图像或图表的数据。您可以使用查询语言和rest端点来生成烧毁所需的数据。您需要能够读取/解析数据并自己生成图形。

如上所述，一个燃尽图比较了多少封闭估计和多少开放估计，并绘制了随着时间的推移。因此，您需要知道三个数据:开放估计、关闭估计和时间。您还会希望将其限制为某个项目(以及它的子项)。

这将使您接近项目崩溃所需的数据：

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

确保将Scope:1055更改为您感兴趣的项目oid。

这就是我到那里的原因。首先，我在想“好吧，你需要总结一堆故事估计”，所以我想我应该对故事进行一个历史查询：

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

但是很快就发现你不能在你的根上聚合。这意味着如果我想总结估计，我需要使用其他东西，如Project (scope)来获取数据：

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.v1应用编程接口端点一起使用的query for burndown data的“配方”。