手動テスト スイート集計ビューのサンプル レポート

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

1 つ以上のテスト スイートの実行状態を報告できます。 この記事の情報を使用して作成するレポートは、次の図のようになります。

次の図に示すように、テスト スイートは階層構造の組織内に配置できます。 次に示すように、2 つのテスト スイートの下に同じ名前の 3 つのテスト スイート Australia と Asia というラベルが付けられます。 この記事では、特定のテスト スイート レベルのデータを集計する方法について説明します。

重要

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

前提条件

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

Note

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

レポートで有用なデータを生成するには、チームがテスト計画を管理するために次のアクティビティを実行する必要があります。

• テスト 計画、テスト スイート、およびテスト ケースを定義します。 状態を指定します。 テスト スイートを実行するには、テスト スイートが進行中の状態である必要があります。 テスト ケースを実行するには、準備完了状態である必要があります。 詳細については、「テスト 計画とテスト スイートの作成および手動テスト ケースの作成を参照してください。

• 手動テストを実行し、結果を確認します。 テスト ケースの各検証ステップの結果を合格または失敗としてマークします。 詳細については、「 手動テストの実行」を参照してください。

  Note

  テスト 担当者は、テスト ステップが検証テスト ステップの場合、状態をマークする必要があります。 テストの全体的な結果には、マークされたすべてのテスト ステップの状態が反映されます。 そのため、テスト ステップが失敗としてマークされているか、マークされていない場合、テストの状態は失敗になります。

サンプル クエリ

TestPoints エンティティ セットの次のクエリを使用して、集計されたテスト スイート レポートを作成できます。

Note

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

Power BI クエリ

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

let 
    Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/TestPoints?" 
        &"$apply=filter((TestSuite/TestPlanTitle eq '{testPlanTitle}' and TestSuite/IdLevel3 ne null))" 
            &"/groupby(" 
                &"(TestSuite/TitleLevel3)," 
                &"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 'None', Edm.Int32) with sum as  NotRunCount," 
                    &"cast(LastResultOutcome ne 'None', Edm.Int32) with sum as RunCount" 
            &")" 
        &")" 
        &"/compute(" 
            &"RunCount mul 100 div TotalCount as RunPercentage," 
            &"NotRunCount mul 100 div TotalCount as NotRunPercentage," 
            &"iif(TotalCount gt NotRunCount, PassedCount mul 100 div RunCount,0) as PassedPercentage," 
            &"iif(TotalCount gt NotRunCount, FailedCount mul 100 div RunCount,0) as FailedPercentage" 
        &")" 
        &"&$orderby=RunPercentage desc", null, [Implementation="2.0"]) 
in 
    Source 

OData クエリ

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

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/TestPoints?  
$apply=filter((TestSuite/TestPlanTitle eq '{testPlanTitle}' and TestSuite/IdLevel3 ne null)) 
/groupby( 
    (TestSuite/TitleLevel3), 
    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 'None', Edm.Int32) with sum as  NotRunCount, 
        cast(LastResultOutcome ne 'None', Edm.Int32) with sum as RunCount 
    )
)
/compute( 
    RunCount mul 100 div TotalCount as RunPercentage, 
    NotRunCount mul 100 div TotalCount as NotRunPercentage, 
    iif(TotalCount gt NotRunCount, PassedCount mul 100 div RunCount,0) as PassedPercentage, 
    iif(TotalCount gt NotRunCount, FailedCount mul 100 div RunCount,0) as FailedPercentage 
) 
&$orderby=RunPercentage desc

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

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

• {organization} - 組織名
• {project} - プロジェクト間クエリの場合は、チーム プロジェクト名を指定するか、"/{project}" を完全に省略します
• {testPlanTitle} - データを返すテスト計画のタイトル。

クエリの内訳

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

クエリ パーツ

説明

filter((TestSuite/TestPlanTitle eq '{testPlanTitle}' and TestSuite/IdLevel3 ne null))

選択したテスト計画のみのデータを返します。 また、レベル 3 以降のテスト スイートのデータも返します。 filter((TestSuite/TestPlanTitle eq '{testPlanTitle1}' or TestSuite/TestPlanTitle eq '{testPlanTitle2}' and TestSuite/IdLevel3 ne null))などの句を使用して、複数のプランを追加できます。 テスト スイート、テスト構成に関連するその他のフィルターをここで適用することもできます。

/groupby((TestSuite/TitleLevel3),

グループ化するテスト スイート。 テスト スイート階層のレベル 3 にあるすべての個別のテスト スイートのレポートを取得する場合は、このクエリ パーツを指定できます。 レベル番号は 1 から 14 に変更できます。 同じ名前のテスト スイートを分離する場合は、 /groupby((TestSuite/TitleLevel3, TestSuite/IdLevel3), を使用して、同じ名前のテスト スイートが 2 つある場合でも、2 つの異なる ID を持つ 2 つの異なるエントリとして表示されるようにすることができます。

/aggregate($count as TotalCount,

カウントを TotalCountにして、フィルター処理されたテスト ポイント全体のデータを集計します。

cast(LastResultOutcome eq 'Passed', Edm.Int32) with sum as Passed,

集計中、型キャストテストは、最新の実行結果 'Passed' を 1 にポイントし、それらを "Passed" メトリックとして合計します。

/compute(Executed mul 100 div TotalCount as ExecPct

計算されたメトリック ExecPct を指定します (実行されたテスト ポイント/合計カウント * 100)。

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

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

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

レポートを作成する前に、 TestSuite 列を展開して、レコードを特定のフィールドにフラット化する必要があります。 方法については、「 Transform Analytics データを使用して Power BI レポートを生成するを参照してください。

Power BI で、次の手順を実行します。

完了したら、列の名前を変更できます。

1. 膨らむ TestSuite

   • 展開ボタンを選択します。

     

   • フラット化するフィールドを選択します。

     

   • テーブルには、 TestSuite.IdLevel3 と TestSuite.TitleLevel3のエンティティ フィールドが含まれるようになりました。

     

2. 列ヘッダーを右クリックし、 Rename... を選択します。

   

列のデータ型を変更する

Power Query エディターから、TotalCount、RunCount、Passedなど、数値を含むすべての列を選択し、Transform メニューから Data Type を選択し、Whole Number を選択します。 データ型の変更の詳細については、「 Transform Analytics データを使用して Power BI レポートを生成する」、列データ型の変換を参照してください。

(省略可能)列フィールドの名前を変更する

列フィールドの名前を変更できます。 たとえば、列 NotApplicable の名前を Not Applicable に変更したり、 TotalCount を Total Count に変更したりできます。 方法については、「 Rename 列フィールドを参照してください。

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

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

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

1. [ Visualizationsで、[ Table] を選択します。
2. Columnsの下に、TestSuite.TitleLevel3、NotRunCount、RunCount、PassedCount、TotalCountをドラッグ アンド ドロップします。
3. Count の集計として Sum を選択します。

   

レポートは次の図のようになります。

関連記事

• OData クエリを使用したサンプル レポートの概要
• Power BI クエリと OData クエリを使用して接続する
• サンプル レポートとクイック リファレンス インデックス