要件追跡ロールアップのサンプルレポート

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

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

要件追跡ロールアップレポートは、要件追跡レポートに基づいており、1 レベルのロールアップのメトリックを集計する方法を示しています。たとえば、ユーザーストーリーを使用して要件を追跡する場合は、この記事で提供されているクエリを使用してフィーチャーのデータを集計できます。

次の図に例を示します。

Power BI ストーリーの概要ロールアップレポートのスクリーンショット。

このレポートには、一覧表示される要件ごとに次の情報が表示されます。

達成率: 要件にリンクされているすべてのタスクの完了時間のロールアップに基づいて完了した作業時間の割合を示す進行状況バー。
成功したテスト: 最新のテスト実行に基づいて成功したテストケースの実行の数。
失敗したテスト: 最新のテスト実行に基づいて失敗したテストケースの実行の数。
テストの実行: 実行されたテスト実行の数。
アクティブなバグ: アクティブ状態のリンクされたバグの数。
終了したバグ: Closed、Done、または Completed 状態のリンクされたバグの数。

Note

要件の追跡は、要件ベースのテストスイートを介してリンクされたテストケースでのみサポートされます。要件作業項目 (ユーザーストーリー (アジャイル)、製品バックログ項目 (スクラム)、要件 (CMMI)、または問題 (基本)) と手動テスト実行の関連付けは、テストケースが要件ベースのテストスイートを介してリンクされている場合にのみ形成されます。

レポートの回答に関する質問

要件追跡レポートは、次の種類の質問に回答するのに役立ちます。

作業の進行状況

各要件に残っている作業の量は、期待値に対応していますか?
上位ランクの要件は最初に実装されていますか?
各要件に対していくつのテストが定義されていますか? 合格しているテストの数はいくつですか?
テストケースが定義されていない要件は何が実装されていますか?

品質の進行状況

各要件に対して実行されたテストケースの数と、合格したテストケースの数。
各要件に含まれるアクティブなバグの数はいくつですか?
テスト中の要件に関するバグが見つかりましたか?
バグは解決されていますか、それともアクティブなままですか?

リスク評価

どの要件が危険にさらされていますか?
リリースに対して十分に安定していない要件はどれですか?
現在出荷できる要件はどれですか?

重要

Power BI の統合と Analytics サービスの OData フィードへのアクセスは、Azure DevOps Services および Azure DevOps Server 2020 以降のバージョンで一般提供されています。この記事で提供されるサンプルクエリは、Azure DevOps Server 2020 以降のバージョンに対してのみ有効であり、v3.0-preview 以降のバージョンによって異なります。これらのクエリを使用し、フィードバックをお寄せください。

前提条件

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

Note

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

レポートで有用なデータを生成するには、次のタスクを実行する必要があります。

要件作業項目を定義し、対象の領域と反復パスに割り当てた。エリアパスと反復パスを定義する方法については、「エリアパスの定義」および「反復パスの定義」を参照してください。
時間の完了率を取得するには、タスクまたは要件にリンクされているバグの [完了作業時間] フィールドと [残存作業時間] フィールドに子リンクの種類を入力する必要があります。
テストケースの実行状態を取得するには、それらの要件に対応する要件ベースのテストスイートをテストプランに作成します。ボードを通じて追加するインラインテストは、この前提条件を満たしますが、テストにリンクする要件は満たしていません。詳細についてはテスト計画およびテストスイートの作成を参照してください。
バグの状態を取得するには、子リンクの種類を使用してバグを作成し、要件にリンクします。

サンプルクエリ

レポートを生成するには、Power BI Desktop に 3 つの Power BI クエリを追加し、それらをリンクする必要があります。各クエリは、またはTestPointsエンティティセットのいずれかをWorkItems実行します。

Note

次のセクションで提供される Power BI クエリスニペットには、列を展開してデータ型を変更するために必要なデータ変換が含まれています。

クエリ領域と反復パス

レポートのスコープを特定の領域とイテレーションパスに設定するには、次を使用してAreaSKIterationSKクエリをフィルター処理できます。詳細については、「OData Analytics を使用した基本的なクエリの定義」を参照してください。

Note

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

要件に対する時間の完了率のクエリ

Note

使用している WorkItemType プロセスに基づいて変更します。スクラムテンプレートは機能をサポートし、Basic テンプレートはロールアップ作業項目の種類として Epic をそれぞれサポートします。

Power BI クエリ
OData クエリ

次の Power BI クエリをコピーして、[データ>の空のクエリの取得] ウィンドウに直接貼り付けます。詳細については、OData クエリを使用したサンプルレポートの概要を参照してください。

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems? 
$filter=( 
    IterationSK eq {iterationSK}
    and AreaSK eq {areaSK}
    and WorkItemType eq 'Feature'
)
&$expand=Descendants( 
    $apply=filter( CompletedWork ne null or RemainingWork ne null ) 
    /aggregate( 
        iif(CompletedWork ne null, CompletedWork, 0) with sum as SumCompletedWork, 
        iif(RemainingWork ne null, RemainingWork, 0) with sum as SumRemainingWork 
    ) 
    /compute( 
        (SumCompletedWork add SumRemainingWork) as TotalWork, 
        SumCompletedWork as SumCompleted 
    ) 
    /compute( 
        iif(TotalWork gt 0,(SumCompleted div cast(TotalWork, Edm.Double) mul 100), 0) as PercCompletedWork 
    ) 
)
&$select=WorkItemId, Title", null, [Implementation="2.0"]),
    #"Expanded Descendants" = Table.ExpandTableColumn(Source, "Descendants", {"SumCompletedWork", "SumRemainingWork", "TotalWork", "SumCompleted", "PercCompletedWork"}, {"Descendants.SumCompletedWork", "Descendants.SumRemainingWork", "Descendants.TotalWork", "Descendants.SumCompleted", "Descendants.PercCompletedWork"}),
    #"Changed Type" = Table.TransformColumnTypes(#"Expanded Descendants",{{"Descendants.SumCompletedWork", type number}, {"Descendants.SumRemainingWork", type number}, {"Descendants.TotalWork", type number}, {"Descendants.SumCompleted", type number}, {"Descendants.PercCompletedWork", type number}})
in
    #"Changed Type"

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

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems? 
$filter=( 
    IterationSK eq {iterationSK}
    and AreaSK eq {areaSK}
    and WorkItemType eq 'Feature'
)
&$expand=Descendants( 
    $apply=filter( CompletedWork ne null or RemainingWork ne null ) 
    /aggregate( 
        iif(CompletedWork ne null, CompletedWork, 0) with sum as SumCompletedWork, 
        iif(RemainingWork ne null, RemainingWork, 0) with sum as SumRemainingWork 
    ) 
    /compute( 
        (SumCompletedWork add SumRemainingWork) as TotalWork, 
        SumCompletedWork as SumCompleted 
    ) 
    /compute( 
        iif(TotalWork gt 0,(SumCompleted div cast(TotalWork, Edm.Double) mul 100), 0) as PercCompletedWork 
    ) 
)
&$select=WorkItemId, Title

要件のテスト実行状態のクエリ

Note

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

Power BI クエリ
OData クエリ

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/TestPoints? 
	$apply=filter(
	    (TestSuite/RequirementWorkItem/IterationSK eq {iterationSK}
    and TestSuite/RequirementWorkItem/AreaSK eq {areaSK}
    and TestSuite/RequirementWorkItem/Processes/any(p:p/BacklogType eq 'RequirementBacklog')
    and TestSuite/RequirementWorkItem/Processes/all(p:p/IsBugType eq false)
	))
	/compute(iif(TestSuite/RequirementWorkItem/Parent ne null, TestSuite/RequirementWorkItem/Parent/WorkItemId, 0) as ParentWorkItemId, 
	iif(TestSuite/RequirementWorkItem/Parent ne null, TestSuite/RequirementWorkItem/Parent/Title, 'Unparented') as ParentWorkItemTitle
	)/groupby(
	    (ParentWorkItemId, ParentWorkItemTitle), 
	    aggregate(
	        $count as TotalCount, 
	        cast(LastResultOutcome eq 'Passed', Edm.Int32) with sum as PassedCount, 
	        cast(LastResultOutcome eq 'Failed', Edm.Int32) with sum as FailedCount, 
            cast(LastResultOutcome eq 'Blocked', Edm.Int32) with sum as BlockedCount,
            cast(LastResultOutcome eq 'NotApplicable', Edm.Int32) with sum as NotApplicableCount,
	        cast(LastResultOutcome eq 'None', Edm.Int32) with sum as NotRunCount, 
	        cast(LastResultOutcome ne 'None', Edm.Int32) with sum as RunCount)
)", null, [Implementation="2.0"]),
    #"Changed Type" = Table.TransformColumnTypes(#"Source",{{"TotalCount", type number}, {"PassedCount", type number}, {"FailedCount", type number}, {"BlockedCount", type number}, {"NotApplicableCount", type number}, {"NotRunCount", type number}, {"RunCount", type number}})
in
    #"Changed Type"

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/TestPoints? 
$apply=filter(
    (TestSuite/RequirementWorkItem/IterationSK eq {iterationSK}
and TestSuite/RequirementWorkItem/AreaSK eq {areaSK}
and TestSuite/RequirementWorkItem/Processes/any(p:p/BacklogType eq 'RequirementBacklog')
and TestSuite/RequirementWorkItem/Processes/all(p:p/IsBugType eq false)
))
/compute(iif(TestSuite/RequirementWorkItem/Parent ne null, TestSuite/RequirementWorkItem/Parent/WorkItemId, 0) as ParentWorkItemId, 
iif(TestSuite/RequirementWorkItem/Parent ne null, TestSuite/RequirementWorkItem/Parent/Title, 'Unparented') as ParentWorkItemTitle
)/groupby(
    (ParentWorkItemId, ParentWorkItemTitle), 
    aggregate(
        $count as TotalCount, 
        cast(LastResultOutcome eq 'Passed', Edm.Int32) with sum as PassedCount, 
        cast(LastResultOutcome eq 'Failed', Edm.Int32) with sum as FailedCount, 
        cast(LastResultOutcome eq 'Blocked', Edm.Int32) with sum as BlockedCount,
        cast(LastResultOutcome eq 'NotApplicable', Edm.Int32) with sum as NotApplicableCount,
        cast(LastResultOutcome eq 'None', Edm.Int32) with sum as NotRunCount, 
        cast(LastResultOutcome ne 'None', Edm.Int32) with sum as RunCount
    )
)

Note

このエントリは TestSuite/RequirementWorkItem/... 、前提条件で説明されているように、要件ベースのテストスイートを 使用して作業項目をテストスイート にリンクする必要があることを示します。

要件にリンクされているバグの状態を照会する

Note

Power BI クエリ
OData クエリ

let
    Source = OData.Feed("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $filter=(
        IterationSK eq {iterationSK}
        and AreaSK eq {areaSK}
        and WorkItemType eq 'Feature'
    )
&$expand=Descendants(
    $apply=filter(
        WorkItemType eq 'Bug'
    )
    /groupby(
        (State),
        aggregate($count as Count)
    )
)
&$select=WorkItemId,Title", null, [Implementation="2.0"]),
    #"Expanded Descendants" = Table.ExpandTableColumn(Source, "Descendants", {"State", "Count"}, {"Descendants.State", "Descendants.Count"}),
    #"Filtered Rows" = Table.SelectRows(#"Expanded Descendants", each [Descendants.Count] <> null and [Descendants.Count] <> ""),
    #"Pivoted Column" = Table.Pivot(#"Filtered Rows", List.Distinct(#"Filtered Rows"[Descendants.State]), "Descendants.State", "Descendants.Count", List.Sum),
    #"Changed Type" = Table.TransformColumnTypes(#"Pivoted Column",{{"Active", type number}, {"Closed", type number}})
in
    #"Changed Type"

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
    $filter=(
        IterationSK eq {iterationSK}
        and AreaSK eq {areaSK}
        and WorkItemType eq 'Feature'
    )
&$expand=Descendants(
    $apply=filter(
        WorkItemType eq 'Bug'
    )
    /groupby(
        (State),
        aggregate($count as Count)
    )
)
&$select=WorkItemId,Title

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

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

{organization} - 組織名
{project} - プロジェクトの名前
{iterationSK}- 対象のイテレーションパスに関連付けられている GUID。 GUID を検索するには、[../extend-analytics/wit-analytics.md#iterationsk](特定のイテレーションパスの IterationSK を返します)
{areaSK} - 対象のエリアパスに関連付けられている GUID。 GUID を検索するには、[../extend-analytics/wit-analytics.md#areask](特定のエリアパスの AreaSK を返します)。

クエリの内訳

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

クエリパーツ

説明

$filter=( IterationSK eq {iterationSK} and AreaSK eq {areaSK} and WorkItemType eq 'Feature' )'

指定したイテレーションとエリアの下にあるフィーチャーのみのデータを返します。

filter( (TestSuite/RequirementWorkItem/IterationSK eq {iterationSK} and TestSuite/RequirementWorkItem/AreaSK eq {areaSK} and TestSuite/RequirementWorkItem/Processes/any(p:p/BacklogType eq 'RequirementBacklog') and TestSuite/RequirementWorkItem/Processes/all(p:p/IsBugType eq false)))

指定したイテレーションと領域の下で、選択したバックログ要件項目のデータのみを返します。

&$expand=Descendants( $apply=filter( CompletedWork ne null or RemainingWork ne null )

フィーチャーの子項目を展開し、作業項目の完了した作業データと残存作業時間データを返します。

&$expand=Descendants( $apply=filter( WorkItemType eq 'Bug' ) /groupby( (State), aggregate($count as Count) )

フィーチャーの子項目を展開し、バグをフィルター処理し、状態別に戻りデータをグループ化し、子項目の合計数を sun でグループ化します。

/aggregate($count as TotalCount,

カウントが次の TotalCount値を持つフィルター処理されたテストポイント全体のデータを集計します。

cast(LastResultOutcome eq 'Passed', Edm.Int32) with sum as PassedCount, cast(LastResultOutcome eq 'Failed', Edm.Int32) with sum as FailedCount, cast(LastResultOutcome eq 'Blocked', Edm.Int32) with sum as BlockedCount, cast(LastResultOutcome eq 'NotApplicable', Edm.Int32) with sum as NotApplicableCount, cast(LastResultOutcome eq 'None', Edm.Int32) with sum as NotRunCount, cast(LastResultOutcome ne 'None', Edm.Int32) with sum as RunCount)

集計中に、成功、失敗、ブロック、NotApplicable、None の最新の実行結果に基づいてテスト ポイントの値を合計します。また、最新の結果が None と等しくないテストポイントの値を合計して、合計RunCountを取得します。

/aggregate( iif(CompletedWork ne null, CompletedWork, 0) with sum as SumCompletedWork, iif(RemainingWork ne null, RemainingWork, 0) with sum as SumRemainingWork

フィルター処理された作業項目全体の完了した作業と残存作業時間のデータを集計します。

)/compute( (SumCompletedWork add SumRemainingWork) as TotalWork, SumCompletedWork as SumCompleted

完了した作業時間と残存作業時間の合計ロールアップを計算します。

)/compute( iif(TotalWork gt 0,(SumCompleted div cast(TotalWork, Edm.Double) mul 100), 0) as PercCompletedWork )

完成した虫の割合を計算します。

テーブルレポートを作成する

[モデリング] タブでリレーションシップの管理を選択し、3 つのクエリ結果を列ごとにWorkItemIdリンクします。
[視覚化] で [テーブル] を選択 します。
3 つの Power BI クエリから関心のある列を追加します。
[成功したテスト] などの加法列の集計として [合計] を選択します。

ここでは、 認証シナリオ は 2 つのユーザーストーリーの親機能です。

Power BI サンプルストーリーの概要ロールアップレポートのスクリーンショット。

次の方法で共有

要件追跡ロールアップのサンプルレポート

レポートの回答に関する質問

前提条件

サンプルクエリ

クエリ領域と反復パス

要件に対する時間の完了率のクエリ

要件のテスト実行状態のクエリ

要件にリンクされているバグの状態を照会する

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

クエリの内訳

テーブルレポートを作成する

フィードバック

その他のリソース

次の方法で共有

要件追跡ロールアップのサンプル レポート

レポートの回答に関する質問

前提条件

サンプル クエリ

クエリ領域と反復パス

要件に対する時間の完了率のクエリ

要件のテスト実行状態のクエリ

要件にリンクされているバグの状態を照会する

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

クエリの内訳

テーブル レポートを作成する

関連記事

フィードバック

その他のリソース

要件追跡ロールアップのサンプルレポート

サンプルクエリ

テーブルレポートを作成する