如何使用版本one api獲取項目和sprint burndown圖表？

Question

我正在嘗試使用Version One api來獲取項目和sprint burndown圖表。

我在讀this page但我只是感到困惑。

有沒有人做過類似的事情，並有任何提示如何打api得到我想要的？

Answer 1

VersionOne api不提供圖像或圖表特定數據。您可以使用查詢語言和其餘端點來生成burndown所需的數據。您需要能夠讀取/解析數據並自行生成圖表。如此說來，burndown圖表比較了多少閉合估計值與隨着時間的推移多少開放估計值和圖表。所以你需要知道三個數據：開放式估算，封閉式估算和時間。你也想把它限制在一個特定的項目中（它會讓孩子們）。

這應該讓你靠近，你需要爲一個項目燃盡的數據：

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到項目OID是你感興趣的

---

這就是我到那裏的方式。首先，我在想「好，你需要總結了一堆故事估計」，所以我想我會做故事的歷史查詢：

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

但很快就發現，你不能在你的根聚集。這也就意味着，如果我要總結的估計，我需要用別的東西像項目（範圍），以獲得數據：

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

您需要執行多個查詢才能生成burndown。首先找到了燒荒的日期範圍：

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

現在每天的日期範圍，總結待辦事項小時，因爲在歷史上這一點的：

/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中）。有一個burndown，累計流量，以及更多:)

Answer 3

現在有一個query for burndown data「配方」，與query.v1 API端點一起使用。