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

2025-10-08

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

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

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

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

重要

エリアパスの値を削除するか、繰り返しパスの値を再構成すると、次のグラフでは元に戻せないデータ損失が発生します。
- バーンダウンとバーンアップウィジェットチャート
- スプリントバーンダウングラフ
- エリアパスが変更されたチームの速度グラフ
- 各作業項目の時点で定義された エリアパス と 反復パス の値を参照する履歴傾向グラフ
これらのパスを削除しても、履歴データを取得することはできません。
領域パスと反復パスは、作業項目で使用されなくなった場合にのみ削除できます。

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

注

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

カテゴリ	要求事項
アクセスレベル	- プロジェクトメンバー。 - 少なくともベーシックアクセス。
アクセス許可	既定では、プロジェクトメンバーには Analytics にクエリを実行してビューを作成する権限があります。サービスと機能の有効化と一般的なデータ追跡アクティビティに関するその他の前提条件の詳細については、「 Analytics にアクセスするためのアクセス許可と前提条件を参照してください。

サンプルクエリ

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

注

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

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

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

注

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

Power BI クエリ
OData クエリ

次の Power BI クエリをコピーして、 Get Data>Blank クエリ ウィンドウに直接貼り付けます。詳細については、「 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" の場合は、ではなく {organization}をにFabrikam置き換えます{Fabrikam}。

{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}')

特定のArea パスの下にユーザーストーリーのみを含める'{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 年 4 月 1 日を表します。

and DateValue le {enddate}

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

)

句 filter() 閉じます。

/groupby (

句 groupby() 開始します。

(DateValue, State, Area/AreaPath),

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

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

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

)

句 groupby() 閉じます。

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

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

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)
        )

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

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

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)
        )

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

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

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

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 レポートを生成する」を参照してください。

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

すべてのデータ変換が完了したら、Home メニューから Close & Apply を選択してクエリを保存し、Power BI の Report タブに戻ります。

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

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

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

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

フィードバック

このページはお役に立ちましたか?

次の方法で共有

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

サンプル クエリ

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