api - バージョン 1 API を使用してプロジェクトとスプリントのバーンダウン チャートを取得するにはどうすればよいですか?

Question

バージョン 1 API を使用して、プロジェクトとスプリントのバーンダウン チャートを取得しようとしています。

このページを読んでいますが、混乱しています。

誰かが似たようなことをしたことがありますか?

Answer 1

VersionOne API は、画像やグラフ固有のデータを提供しません。クエリ言語と残りのエンドポイントを使用して、バーンダウンに必要なデータを生成できます。データを読み取り/解析し、自分でグラフを作成できる必要があります。

そうは言っても、バーンダウン グラフは、クローズドな見積もりとオープンな見積もりの​​量を比較し、それを経時的にグラフ化します。したがって、オープン見積もり、クローズ見積もり、時間の 3 つのデータを知る必要があります。また、特定のプロジェクト (およびその子) に制限することもできます。

これにより、プロジェクトのバーンダウンに必要なデータに近づくはずです。

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'

しかし、ルートに集約できないことがすぐにわかりました。つまり、見積もりを合計したい場合は、プロジェクト (スコープ) のような別のものを使用してデータを取得する必要があります。

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 にあります)。バーンダウン、累積フローなどがあります:)