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

[アーティクル]
11/21/2024

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

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

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

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

重要

Area パスの削除または Iteration Paths の再構成により、元に戻せないデータ損失が発生します。たとえば、 Area Paths が変更されたチームのバーンダウンおよびバーンアップウィジェットグラフ、スプリントバーンダウン、ベロシティグラフでは、正確なデータは表示されません。履歴傾向グラフは、作業項目ごとに定義された エリアパス と Iteration Path を参照します。一度削除すると、これらのパスの履歴データを取得することはできません。
削除できるのは、作業項目で使用されなくなった領域パスと反復パスのみです。

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

Note

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

前提条件

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

サンプルクエリ

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

Note

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

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

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

Note

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

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" の場合は、ではなく {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}')

特定の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 でクラスター化縦棒グラフを選択します。
X 軸に追加DateValueし、右クリックしてではなくを選択DateValueします。Date Hierarchy
[Y 軸] にを追加Countします。
[Y 軸] にを追加TotalStoryPointsします。

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

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

次の方法で共有

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

前提条件

サンプルクエリ

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

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

クエリの内訳

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

毎週金曜日にスナップショットを含むバーンダウンユーザーストーリー

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

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

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

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

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

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

フィードバック

その他のリソース

次の方法で共有

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

前提条件

サンプル クエリ

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

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

クエリの内訳

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

毎週金曜日にスナップショットを含むバーンダウン ユーザー ストーリー

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

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

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

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

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

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

関連記事

フィードバック

その他のリソース

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

サンプルクエリ

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

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

毎週金曜日にスナップショットを含むバーンダウンユーザーストーリー

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

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