バーンダウンのサンプルクエリとレポートをリリースする

[アーティクル]
01/10/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

バーンダウンレポートとバーンアップレポートには、時間の経過と同時に完了している作業量が表示されます。次の図は、ユーザーストーリーの数とストーリーポイントの合計によるバーンダウンの両方を示しています。

Power BI Release バーンダウンクラスター化縦棒グラフレポートのスクリーンショット。

バーンダウングラフは、グラフの期間の作業を計画する場合にのみ意味があります。それ以外の場合、スプリント単位で計画している場合、標準バーンダウンは表示されません。これらのインスタンスでは、バーンアップグラフは、時間の経過に伴う進行状況を確認する方が理にかなっています。

重要

エリアパスを削除したり、反復パスを再構成したりすると、データが失われ、元に戻すことはできません。たとえば、 エリアパス が変更されたチームのバーンダウンまたはバーンアップウィジェットグラフ、スプリントバーンダウン、ベロシティグラフは、正しいデータを反映しません。履歴傾向グラフは、各作業項目の過去のポイントで定義されている エリアパス と 反復パス を参照します。 エリアパスまたは反復パスが削除されると、その履歴データを取得できません。

バーンダウンとバーンアップの詳細については、バーンダウンまたはバーンアップウィジェットの構成とバーンダウンとバーンアップのガイダンスを参照してください。

Note

この記事では、「 OData クエリを使用したサンプルレポートの概要」を読み、Power BI の基本的な理解があることを前提としています。

前提条件

分析データを表示してサービスにクエリを実行するには、 Basic アクセス以上のプロジェクトのメンバーである必要があります。既定では、すべてのプロジェクトメンバーには、Analytics のクエリと分析ビューの定義に対するアクセス許可が付与されます。
サービスと機能の有効化と一般的なデータ追跡アクティビティに関するその他の前提条件については、「 Analytics にアクセスするためのアクセス許可と前提条件」を参照してください。

サンプルクエリ

このセクションのクエリでは、履歴データに基づいて作業項目のバーンダウングラフを生成する方法を示します。これらのクエリはすべて、エンティティセットを指定します WorkItemSnapshot 。

Note

フィルターまたはレポートの目的で使用できるプロパティを確認するには、「Azure Boardsのメタデータリファレンス」を参照してください。クエリをフィルター処理したり、で使用可能なまたは値のProperty下EntityTypeNavigationPropertyBinding Pathの値のいずれかを使用してプロパティをEntitySet返したりできます。各は EntitySet に EntityType対応します。各値のデータ型の詳細については、対応する EntityTypeに提供されているメタデータを確認してください。

開始日と終了日からのエリアパス内のユーザーストーリーのバーンダウン

次のクエリは、リリースタグでタグ付けされた作業項目に基づいて、リリースのユーザーストーリーの履歴データを返す方法を示しています。

Note

タグのフィルター処理に基づくレポートの場合、リリースの開始時またはバーンダウン/バーンアップ開始日にタグを作業項目に割り当てる必要があります。それ以外の場合、作業項目は返されたデータに含まれません。

Power BI クエリ
OData クエリ

以下に示す Power BI クエリは、[ データの取得- 空の>クエリ ] ウィンドウに直接貼り付けることができます。詳細については、「 OData クエリを使用したサンプルレポートの概要」を参照してください。

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?"
        &"$apply=filter(WorkItemType eq 'User Story' "
            &"and StateCategory ne 'Completed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and Tags/any(x:x/TagName eq '{tagname}') "
            &"and DateValue ge {startdate} "
            &"and DateValue le {enddate} "
        &") "
        &"/groupby ( "
            &"(DateValue,State,Area/AreaPath), "
            &"aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

次の OData クエリコードを使用して、Power BI でクエリを使用する前にクエリを変更またはテストできます。詳細については、「 Power BI クエリと OData クエリを使用した接続」を参照してください。

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?
        $apply=filter(WorkItemType eq 'User Story'
            and StateCategory ne 'Completed'
            and startswith(Area/AreaPath,'{areapath}')
            and Tags/any(x:x/TagName eq '{tagname}')
            and DateValue ge {startdate}
            and DateValue le {enddate}
        )
        /groupby (
            (DateValue,State,Area/AreaPath),
            aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints)
        )

置換文字列とクエリの内訳

次の文字列を実際の値に置き換えます。置換に角かっこを {} 含めないでください。たとえば、組織名が "Fabrikam" の場合は、ではなく {Fabrikam}をにFabrikam置き換えます{organization}。

{organization} - 組織名
{project} - プロジェクト間クエリの場合は、チームプロジェクト名を指定するか、"/{project}" を完全に省略します
{areapath} - エリアパス。形式の例: Project\Level1\Level2
{tag} - リリースを表すタグ。タグ付けされたすべての {tagname} 作業項目がレポートに含まれます
{startdate} - バーンダウンレポートを開始する日付を次の形式で指定します YYYY-MM-DDZ。たとえば、 2022-04-01Z 2022 年 4 月 1 日を表します。引用符で囲む必要はありません。
{enddate} - バーンダウンレポートを終了する日付。

クエリの内訳

次の表では、クエリの各部分について説明します。

クエリパーツ

説明

$apply=filter(WorkItemType eq 'User Story'

バーンダウンにユーザーストーリーを含める。

and StateCategory ne 'Completed'

完了したアイテムをフィルター処理します。状態カテゴリの詳細については、「ワークフローの状態と状態カテゴリをバックログとボードで使用する方法」を参照してください。

and startswith(Area/AreaPath,'{areapath}')

特定 のエリアパス の置き換えの下にユーザストーリーのみを含めます '{areapath}'。
チーム名でフィルター処理するには、filter ステートメントを使用します Teams/any(x:x/TeamName eq '{teamname})'。

and Tags/any(x:x/TagName eq '{tagname}').

バーンダウンするリリースを表し、{tagname} でタグ付けされたすべての作業項目をレポートに含めるタグラベルを指定します。

and DateValue ge {startdate}

指定した日付以降にバーンダウンを開始します。例: 2019-04-01Z は 2019-April-01 を表します。

and DateValue le {enddate}

指定した日付以前にバーンダウンを開始します。 {startdate} と同じ形式です。

)

Close filter() 句。

/groupby (

Start groupby() 句。

(DateValue, State, Area/AreaPath),

グループ化 DateValue (トレンドに使用)、およびレポートするフィールド。

aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints)

ユーザーストーリーの数とストーリーポイントの合計で集計します。

)

Close groupby() 句。

チームのユーザーストーリーのバーンダウン

次のクエリでは、エリアパスではなくチーム名でフィルター処理されたバーンダウンデータが返されます。

Power BI クエリ
OData クエリ

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?"
        &"$apply=filter(WorkItemType eq 'User Story' "
            &"and StateCategory ne 'Completed' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') "
            &"and Tags/any(x:x/TagName eq '{tagname}') "
            &"and DateValue ge {startdate} "
            &"and DateValue le {enddate} "
        &") "
        &"/groupby ( "
            &"(DateValue,State,Area/AreaPath), "
            &"aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?
        $apply=filter(WorkItemType eq 'User Story'
            and StateCategory ne 'Completed'
            and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}')
            and Tags/any(x:x/TagName eq '{tagname}')
            and DateValue ge {startdate}
            and DateValue le {enddate}
        )
        /groupby (
            (DateValue,State,Area/AreaPath),
            aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints)
        )

毎週金曜日にスナップショットを使用してユーザーストーリーをバーンダウンする

週単位のスナップショットを使用すると、Power BI に取り込まれるデータの量が減り、クエリのパフォーマンスが向上します。

Power BI クエリ
OData クエリ

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?"
        &"$apply=filter(WorkItemType eq 'User Story' "
            &"and StateCategory ne 'Completed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and Tags/any(x:x/TagName eq '{tagname}') "
            &"and DateValue ge {startdate} "
            &"and DateValue le {enddate} "
            &"and Date/DayName eq 'Friday' "
        &") "
        &"/groupby ( "
            &"(DateValue,State,Area/AreaPath,AreaSK), "
            &"aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?
        $apply=filter(WorkItemType eq 'User Story'
            and StateCategory ne 'Completed'
            and startswith(Area/AreaPath,'{areapath}')
            and Tags/any(x:x/TagName eq '{tagname}')
            and DateValue ge {startdate}
            and DateValue le {enddate}
            and Date/DayName eq 'Friday'
        )
        /groupby (
            (DateValue,State,Area/AreaPath,AreaSK),
            aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints)
        )

エリアと反復パスに基づくバーンダウンユーザーストーリー

一部の組織では、イテレーションパスを使用してリリースのストーリーをマークします。たとえば、MyProject\Release1 の反復パスがあるとします。次のクエリは、反復パスでユーザーストーリーを選択する方法を示しています。

Power BI クエリ
OData クエリ

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?"
        &"$apply=filter(WorkItemType eq 'User Story' "
            &"and StateCategory ne 'Completed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and startswith(Iteration/IterationPath,'{iterationpath}') "
            &"and DateValue ge {startdate} "
            &"and DateValue le {enddate} "
            &") "
        &"/groupby ( "
            &"(DateValue,StateCategory,State,Area/AreaPath,AreaSK), "
            &"aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?
        $apply=filter(WorkItemType eq 'User Story'
            and StateCategory ne 'Completed'
            and startswith(Area/AreaPath,'{areapath}')
            and startswith(Iteration/IterationPath,'{iterationpath}')
            and DateValue ge {startdate}
            and DateValue le {enddate}
            )
        /groupby (
            (DateValue,StateCategory,State,Area/AreaPath,AreaSK),
            aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints)
        )

ユーザー設定フィールド値を持つバーンダウンユーザーストーリー

一部の組織では、ユーザー設定フィールドを使用してリリースのユーザーストーリーをマークします。たとえば、マイルストーンというフィールドがあるとします。このクエリでは、ユーザー設定フィールドでユーザーストーリーを選択する方法を示します。

クエリの両方{customfieldname}{releasevalue}を置き換える必要があります。ユーザー設定フィールドの名前を確認するには、Azure Boards のメタデータリファレンス、カスタムプロパティに関するページを参照してください。たとえばCustom_Milestone、カスタムプロパティ名に置き換えます{customfieldname}。

Power BI クエリ
OData クエリ

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?"
        &"$apply=filter(WorkItemType eq 'User Story' "
            &"and StateCategory ne 'Completed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and {customfieldname} eq '{releasevalue}' "
            &"and DateValue ge {startdate} "
            &"and DateValue le {enddate} "
            &") "
        &"/groupby ( "
            &"(DateValue,StateCategory,State,Area/AreaPath,AreaSK), "
            &"aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot?
        $apply=filter(WorkItemType eq 'User Story'
            and StateCategory ne 'Completed'
            and startswith(Area/AreaPath,'{areapath}')
            and {customfieldname} eq '{releasevalue}'
            and DateValue ge {startdate}
            and DateValue le {enddate}
            )
        /groupby (
            (DateValue,StateCategory,State,Area/AreaPath,AreaSK),
            aggregate ($count as Count, StoryPoints with sum as TotalStoryPoints)
        )

(省略可能)クエリの名前を変更する

既定のクエリラベル Query1 の名前を、より意味のある名前に変更できます。 [ クエリ設定] ペインから新しい名前を入力するだけです。

Power BI クエリメニューオプションのスクリーンショット。クエリの名前を変更します。

Power Query エディターの列を展開する

レポートを作成する前に、複数のフィールドを含むレコードを返す列を展開する必要があります。この例では、次のレコードを展開します。

Links
Links.TargetWorkItem
Area
Iteration
AssignedTo

作業項目を展開する方法については、「 Analytics データを変換して Power BI レポートを生成する」を参照してください。

クエリを閉じて変更を適用する

すべてのデータ変換が完了したら、[ホーム] メニューから [閉じる] & [適用] を選択してクエリを保存し、Power BI の [レポート] タブに戻ります。

クラスター化縦棒グラフを作成する

Power BI で、[視覚化] で [クラスター化縦棒グラフ] を選択します。
X 軸に追加DateValueし、右クリックしてではなくを選択DateValueします。Date Hierarchy
[Y 軸] にを追加Countします。
[Y 軸] にを追加TotalStoryPointsします。

このレポートの例では、ストーリーの数と合計または ストーリーポイントの両方にバーンダウンが表示されます。

Power BI サンプルリリースバーンダウンクラスター縦棒グラフレポートのスクリーンショット。

バーンダウンのサンプルクエリとレポートをリリースする

前提条件

サンプルクエリ

開始日と終了日からのエリアパス内のユーザーストーリーのバーンダウン

置換文字列とクエリの内訳

クエリの内訳

チームのユーザーストーリーのバーンダウン

毎週金曜日にスナップショットを使用してユーザーストーリーをバーンダウンする

エリアと反復パスに基づくバーンダウンユーザーストーリー

ユーザー設定フィールド値を持つバーンダウンユーザーストーリー

(省略可能)クエリの名前を変更する

Power Query エディターの列を展開する

クエリを閉じて変更を適用する

クラスター化縦棒グラフを作成する

フィードバック

フィードバック

その他のリソース

バーンダウン のサンプル クエリとレポートをリリースする

前提条件

サンプル クエリ

開始日と終了日からのエリア パス内のユーザー ストーリーのバーンダウン

置換文字列とクエリの内訳

クエリの内訳

チームのユーザー ストーリーのバーンダウン

毎週金曜日にスナップショットを使用してユーザー ストーリーをバーンダウンする

エリアと反復パスに基づくバーンダウン ユーザー ストーリー

ユーザー設定フィールド値を持つバーンダウン ユーザー ストーリー

(省略可能)クエリの名前を変更する

Power Query エディターの列を展開する

クエリを閉じて変更を適用する

クラスター化縦棒グラフを作成する

関連記事

フィードバック

フィードバック

その他のリソース

バーンダウンのサンプルクエリとレポートをリリースする

サンプルクエリ

開始日と終了日からのエリアパス内のユーザーストーリーのバーンダウン

チームのユーザーストーリーのバーンダウン

毎週金曜日にスナップショットを使用してユーザーストーリーをバーンダウンする

エリアと反復パスに基づくバーンダウンユーザーストーリー

ユーザー設定フィールド値を持つバーンダウンユーザーストーリー