テストの概要サンプルレポート

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

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

パイプラインの実行を実行し、パイプライン定義内にテストタスクを含めると、さまざまなテスト結果に対するテスト実行の数を示すレポートを作成できます。成功、失敗、未実行、影響なし。

次の図は、テストの概要レポートの例を示しています。

テストの概要ドーナツレポートのスクリーンショット。

この記事で提供されているクエリを使用して、次のレポートを生成します。

ビルドワークフローのテストの概要
リリースワークフローのテストの概要
特定のブランチのテストの概要
特定のテストファイルのテストの概要
特定のテスト所有者のテストの概要

重要

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 の基本的な理解を持っていることを前提としています。

サンプルクエリ

エンティティセットの次のクエリを TestResultsDaily 使用して、似たパイプラインテストの概要レポートを作成できます。エンティティセットは TestResultsDaily 、テストごとにグループ化された実行の毎日の TestResult スナップショット集計を提供します。

Note

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

ビルドワークフローのテストの概要

ビルド ワークフローのパイプラインのテストの概要を表示するには、次のクエリを使用します。

Power BI クエリ
OData クエリ

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

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And DateSK ge {startdate} "
      &"And Workflow eq 'Build' "
      &")/aggregate("
      &"ResultCount with sum as ResultCount, "
      &"ResultPassCount with sum as ResultPassCount, "
      &"ResultFailCount with sum as ResultFailCount, "
      &"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
      &"ResultNotImpactedCount with sum as ResultNotImpactedCount"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

{startdate}クエリの実際の値に置き換えます{pipelineName}。

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

https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And DateSK ge {startdate} 
    And Workflow eq 'Build'
)/aggregate(
    ResultCount with sum as ResultCount,
    ResultPassCount with sum as ResultPassCount,
    ResultFailCount with sum as ResultFailCount,
    ResultNotExecutedCount with sum as ResultNotExecutedCount,
    ResultNotImpactedCount with sum as ResultNotImpactedCount
)

リリースワークフローのテストの概要

リリース ワークフローのパイプラインのテストの概要を表示するには、次のクエリを使用します。

Note

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

Power BI クエリ
OData クエリ

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And DateSK ge {startdate} "
      &"And Workflow eq 'Release'"
      &")/aggregate("
      &"ResultCount with sum as ResultCount, "
      &"ResultPassCount with sum as ResultPassCount, "
      &"ResultFailCount with sum as ResultFailCount, "
      &"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
      &"ResultNotImpactedCount with sum as ResultNotImpactedCount"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And DateSK ge {startdate} 
    And Workflow eq 'Release'
    )/aggregate(
    ResultCount with sum as ResultCount,
    ResultPassCount with sum as ResultPassCount,
    ResultFailCount with sum as ResultFailCount,
    ResultNotExecutedCount with sum as ResultNotExecutedCount,
    ResultNotImpactedCount with sum as ResultNotImpactedCount
)

ブランチでフィルター処理されたテストの概要

特定のブランチのパイプラインのテストの概要を表示するには、次のクエリを使用します。レポートを作成するには、この記事の後半で指定されているものと共に、次の追加手順を実行します。

次に展開します Branch 。 Branch.BranchName
Power BI 視覚化スライサーを選択し、スライサーのフィールドにフィールドBranch.BranchNameを追加します
結果の概要を表示する必要があるスライサーからブランチ名を選択します。

スライサーの使用の詳細については、「Power BI のスライサー」を参照してください。

Power BI クエリ
OData クエリ

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And DateSK ge {startdate} "
      &"And Workflow eq 'Build'"
      &")/groupby("
      &"(Branch/BranchName),"
      &"aggregate("
      &"ResultCount with sum as ResultCount, "
      &"ResultPassCount with sum as ResultPassCount, "
      &"ResultFailCount with sum as ResultFailCount, "
      &"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
      &"ResultNotImpactedCount with sum as ResultNotImpactedCount"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And DateSK ge {startdate} 
    And Workflow eq 'Build'
)/groupby(
    (Branch/BranchName),
    aggregate(
        ResultCount with sum as ResultCount,
        ResultPassCount with sum as ResultPassCount,
        ResultFailCount with sum as ResultFailCount,
        ResultNotExecutedCount with sum as ResultNotExecutedCount,
        ResultNotImpactedCount with sum as ResultNotImpactedCount
    )
)

テストファイルでフィルター処理されたテストの概要

特定のテストファイルのパイプラインのテストの概要を表示するには、次のクエリを使用します。レポートを作成するには、この記事の後半で定義されているものと共に、次の追加手順を実行します。

次に展開します Test 。 Test.ContainerName
Power BI 視覚化スライサーを選択し、スライサーのフィールドにフィールドTest.ContainerNameを追加します
結果の概要を表示する必要があるスライサーからコンテナー名を選択します。

Power BI クエリ
OData クエリ

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And DateSK ge {startdate} "
      &"And Workflow eq 'Build'"
      &")/groupby("
      &"(Test/ContainerName),"
      &"aggregate("
      &"ResultCount with sum as ResultCount, "
      &"ResultPassCount with sum as ResultPassCount, "
      &"ResultFailCount with sum as ResultFailCount, "
      &"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
      &"ResultNotImpactedCount with sum as ResultNotImpactedCount"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And DateSK ge {startdate} 
    And Workflow eq 'Build'
)/groupby(
    (Test/ContainerName),
    aggregate(
        ResultCount with sum as ResultCount,
        ResultPassCount with sum as ResultPassCount,
        ResultFailCount with sum as ResultFailCount,
        ResultNotExecutedCount with sum as ResultNotExecutedCount,
        ResultNotImpactedCount with sum as ResultNotImpactedCount
    )
)

テスト所有者によってフィルター処理されたテストの概要

特定のテスト所有者が所有するテストのパイプラインのテストの概要を表示するには、次のクエリを使用します。レポートを作成するには、この記事の後半で定義されているものと共に、次の追加手順を実行します。

次に展開します Test 。 Test.TestOwner
Power BI 視覚化スライサーを選択し、スライサーのフィールドにフィールドTest.TestOwnerを追加します
結果の概要を表示する必要があるスライサーからテスト所有者を選択します。

Power BI クエリ
OData クエリ

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/mseng/AzureDevOps/_odata/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And DateSK ge {startdate} "
      &"And Workflow eq 'Build'"
      &")/groupby("
      &"(Test/TestOwner),"
      &"aggregate("
      &"ResultCount with sum as ResultCount, "
      &"ResultPassCount with sum as ResultPassCount, "
      &"ResultFailCount with sum as ResultFailCount, "
      &"ResultNotExecutedCount with sum as ResultNotExecutedCount, "
      &"ResultNotImpactedCount with sum as ResultNotImpactedCount"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And DateSK ge {startdate} 
    And Workflow eq 'Build'
)/groupby(
    (Test/TestOwner),
    aggregate(
        ResultCount with sum as ResultCount,
        ResultPassCount with sum as ResultPassCount,
        ResultFailCount with sum as ResultFailCount,
        ResultNotExecutedCount with sum as ResultNotExecutedCount,
        ResultNotImpactedCount with sum as ResultNotImpactedCount
    )
)

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

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

{organization} - 組織名。
{project} - チームプロジェクト名。
{pipelinename} - パイプライン名。例: Fabrikam hourly build pipeline。
{startdate} - レポートを開始する日付。日付は YYYYMMDD 形式で入力できます。たとえば、 20220815 2022 年 8 月 15 日などです。

クエリの内訳

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

クエリパーツ

説明

$apply=filter(

Start filter() 句。

Pipeline/PipelineName eq '{pipelineName}'

指定したパイプラインのテスト実行を返します。

and CompletedOn/Date ge {startdate}

指定した日付以降にテストが実行されます。

and Workflow eq 'Build' または and Workflow eq 'Release'

返されるテストの実行は、またはReleaseワークフローでBuild指定されたパイプラインに対してのみ行われます。

)

Close filter() 句。

aggregate(

フィルター条件に aggregate 一致するすべてのテスト実行の句を開始します。

ResultCount with sum as ResultCount,

テスト実行の合計数を次のように ResultCountカウントします。

ResultPassCount with sum as ResultPassCount,

成功したテスト実行の合計数を次のように ResultPassCountカウントします。

ResultFailCount with sum as ResultFailCount

失敗したテスト実行の合計数を次のように ResultFailCountカウントします。

ResultNotExecutedCount with sum as ResultNotExecutedCount,

未実行のテスト実行の合計数を次のように ResultNotExecutedCountカウントします。

ResultNotImpactedCount with sum as ResultNotImpactedCount

影響を受けなかったテスト実行の合計数を次のように ResultNotImpactedCountカウントします。

)

句を aggregate() 閉じます。

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

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

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

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

列フィールドの名前を変更できます。たとえば、列Pipeline.PipelineNameの名前を、または TotalCount Total Count〗にPipeline Name変更できます。方法については、「列フィールドの名前を変更する」を参照してください。

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

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

ドーナツグラフレポートを作成する

Power BI の [視覚化] で、ドーナツ レポートを選択します。
次のフィールドを値に指定された順序で追加します。各フィールドを右クリックし、[合計] が選択されていることを確認します。
- ResultPassCount
- ResultFailCount
- ResultNotExecutedCount
- ResultNotImpactedCount

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

サンプルテストの概要ドーナツレポートのスクリーンショット。

次の方法で共有

テストの概要サンプルレポート

前提条件

サンプルクエリ

ビルドワークフローのテストの概要

リリースワークフローのテストの概要

ブランチでフィルター処理されたテストの概要

テストファイルでフィルター処理されたテストの概要

テスト所有者によってフィルター処理されたテストの概要

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

クエリの内訳

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

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

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

ドーナツグラフレポートを作成する

フィードバック

その他のリソース

次の方法で共有

テストの概要サンプル レポート

前提条件

サンプル クエリ

ビルド ワークフローのテストの概要

リリース ワークフローのテストの概要

ブランチでフィルター処理されたテストの概要

テスト ファイルでフィルター処理されたテストの概要

テスト所有者によってフィルター処理されたテストの概要

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

クエリの内訳

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

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

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

ドーナツ グラフ レポートを作成する

関連記事

フィードバック

その他のリソース

テストの概要サンプルレポート

サンプルクエリ

ビルドワークフローのテストの概要

リリースワークフローのテストの概要

テストファイルでフィルター処理されたテストの概要

ドーナツグラフレポートを作成する