AzureTestPlan@0 - Azure Test Plan v0 タスク

2025-06-24

Java、JavaScript、Python言語のテストプランで手動テストと自動テストを実行します。

注

このタスクはパブリックプレビュー段階です。

構文

# Azure Test Plan v0
# Run manual and automated tests points of test plan for different testing frameworks like Maven and Gradle for Java, PyTest for Python and Jest for JavaScript.
- task: AzureTestPlan@0
  inputs:
    testSelector: # 'manualTests' | 'automatedTests'. Required. Test cases to be executed. 
    testPlanOrRunSelector: 'testPlan' # 'testPlan' | 'testRun'. Required. Select tests using. Default: testPlan.
    #testRunId: '$(test.RunId)' # string. Required when testPlanOrRunSelector = testRun. Test Run. Default: $(test.RunId).
    testPlan: # string. Required when testPlanOrRunSelector = testPlan. Test plan. 
    testSuite: # string. Required when testPlanOrRunSelector = testPlan. Test suite. 
    testConfiguration: # string. Required. Test configuration. 
    #testLanguageInput: # 'JavaMaven' | 'JavaGradle' | 'Python' | 'JavaScriptJest'. Select Test framework language. 
    #pomFilePath: # string. Optional. Use when testLanguageInput = JavaMaven. Pom file path. 
    #gradleFilePath: # string. Optional. Use when testLanguageInput = JavaGradle. Gradle file path. 
    #failTaskOnFailedTests: true # boolean. Fail if there are test failures. Default: true.
    #failTaskOnFailureToPublishResults: false # boolean. Fail if there is failure in publishing test results. Default: false.
    #failTaskOnMissingResultsFile: false # boolean. Fail if no result files are found. Default: false.
  # advanced
    #publishRunAttachments: true # boolean. Upload test results files. Default: true.

入力

testSelector - 実行するテストケース
string。必須。使用できる値: manualTests (手動テスト)、 automatedTests (自動テスト)。

手動テスト: このオプションを使用して、テスト計画から手動テストをトリガーします。
自動テスト: このオプションを使用して、自動テスト方法が関連付けられているテスト計画からテストを実行します。

testPlanOrRunSelector - を使用してテストを選択する
string。必須。使用できる値: testPlan (テスト計画)、 testRun (テスト実行)。既定値: testPlan。

テストアセンブリ: このオプションを使用して、テストを含む 1 つ以上のテストアセンブリを指定します。必要に応じて、特定のテストのみを選択するフィルター条件を指定できます。
テストプラン: このオプションを使用して、自動テスト方法が関連付けられているテスト計画からテストを実行します。
テスト実行: このオプションは、テストハブからテストを実行する環境を設定する場合に使用します。このオプションは、継続的インテグレーション/継続的デプロイ (CI/CD) パイプラインでテストを実行する場合は使用しないでください。

testRunId - テスト実行
string。 testPlanOrRunSelector = testRunする場合に必要です。既定値: $(test.RunId)。

テスト実行ベースの選択は、テストハブから自動テスト実行をトリガーするときに使用されますが、この値はそのままにしておく必要があります。

testPlan - テスト計画の
string。 testPlanOrRunSelector = testPlanする場合に必要です。

テストケースを含むテストスイートを含むテスト計画 ID を入力するか貼り付けます。

testSuite - テストスイートの
string。 testPlanOrRunSelector = testPlanする場合に必要です。

テストケースを含む 1 つ以上のテストスイートを選択します。

testConfiguration - テスト構成
string。必須。

[テスト構成] を選択します。

testLanguageInput - [テストフレームワーク言語] を選択します
string。使用できる値: JavaMaven (Java - Maven)、 JavaGradle (Java - Gradle)、 Python (Python - PyTest)、 JavaScriptJest (JavaScript - Jest)。

テスト計画の自動テストのテストフレームワーク言語。

pomFilePath - POM ファイルパス
string。任意。 testLanguageInput = JavaMavenするときに使用します。

リポジトリルートから Maven POM ファイルへの相対パス。

gradleFilePath - Gradle ファイルパス
string。任意。 testLanguageInput = JavaGradleするときに使用します。

リポジトリルートから build.gradle ファイルへの相対パス。

publishRunAttachments - テスト結果ファイルのアップロード
boolean。既定値: true。

テストの実行時に収集された診断情報を含むログおよびその他のファイルをアップロードします。

failTaskOnFailedTests - テストエラーが発生した場合は失敗
boolean。既定値: true。

テストの失敗がある場合は、タスクを失敗させます。このオプションをオンにすると、結果ファイルでテストの失敗が検出された場合にタスクが失敗します。

failTaskOnFailureToPublishResults - テスト結果の発行に失敗した場合に失敗
boolean。既定値: false。

テスト結果の発行に失敗した場合は、失敗します。テスト結果の公開が部分的に失敗した場合にタスクが失敗するには、このオプションをオンにします。

failTaskOnMissingResultsFile - 結果ファイルが見つからない場合は失敗
boolean。既定値: false。

結果ファイルが見つからない場合は、タスクを失敗させます。

タスクコントロールのオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。詳細については、「コントロールオプションと一般的なタスクプロパティを参照してください。

出力変数

なし。

注釈

自動テストをテスト計画と統合する

次の手順に従って、自動テストを手動テストケースと統合し、Test Plansから、またはビルドパイプラインの Azure Test Plan タスクを使用して実行します。

プロジェクトがAzure DevOps Repos(またはGitHub Repos)にあることを確認します。

Gradle や Maven などのタスクを使用してテストを実行するパイプラインを作成します。テストが既存のパイプラインの一部として既に実行されている場合は、この手順をスキップできます。テストの実行は不可欠であり、テストが少なくとも 1 回実行された後にのみ、手動テストケースに関連付けることができます。

 trigger: none

 pool:
   vmImage: ubuntu-latest

 steps:
 - task: Gradle@3
   inputs:
     gradleWrapperFile: 'gradlew'
     workingDirectory: '$(Build.SourcesDirectory)'
     tasks: 'build'
     publishJUnitResults: true
     testResultsFiles: '**/TEST-*.xml'
     testRunTitle: 'gridinitialexecution'
     javaHomeOption: 'JDKVersion'
     sonarQubeRunAnalysis: false
     spotBugsAnalysis: false

  trigger: none

  variables:
  - name: system.debug
    value: true

  pool:
    vmImage: ubuntu-latest

  steps:
  - task: Maven@4
    inputs:
      mavenPomFile: 'pom.xml'
      publishJUnitResults: true
      testResultsFiles: '**/surefire-reports/TEST-*.xml'
      javaHomeOption: 'JDKVersion'
      mavenVersionOption: 'Default'
      mavenAuthenticateFeed: false
      effectivePomSkip: false
      sonarQubeRunAnalysis: false

trigger: none    
pool:
  vmImage: windows-latest

steps:
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.8.10'
    addToPath: true
    displayName: 'Use Python $(python.version)'

- script: |
   pip install pytest pytest-azurepipelines
   pytest
  displayName: 'pytest'

次の手順では、パイプライン実行の概要の [テスト] タブからテストケースを手動テストケース作業項目にリンクします。これを行うには、新しいテストケースを作成するか、既存のテストケースを使用します(TC4の「自動化ステータス」列に注意してください)。
テストケースを作成したら、パイプライン実行の概要ページに戻り、自動テストをテストケースに関連付けます。
手動テストケースに自動テストが関連付けられているかどうかを確認する方法を次に示します。

テストケースが手動テストケース作業項目に関連付けられたので、Azure Test Plan タスクの引数としてテスト計画を渡すことで、パイプラインの一部としてテストケースを実行できます。

trigger: none
pool:
  vmImage: ubuntu-latest

steps:
- task: AzureTestPlan@0
  inputs:
    testSelector: 'automatedTests'
    testPlanOrRunSelector: 'testPlan'
    testPlan: '21294'
    testSuite: '229461'
    testConfiguration: '82'
    testLanguageInput: 'JavaGradle'

パイプラインを保存して実行します。

パイプラインの結果の概要を次に示します。これは、TC4 の結果と他のテストケースを示しています。

関連付けられた自動化タブのスクリーンショット。

要求事項

要件	説明
パイプラインの種類	YAML、クラシックビルド、クラシックリリース
実行日	エージェント、DeploymentGroup
の需要	無し
機能	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	[任意]
設定可能な変数	[任意]
エージェントのバージョン	2.144.0 以上
タスクカテゴリ	テスト

次の方法で共有

AzureTestPlan@0 - Azure Test Plan v0 タスク

構文

入力

タスク コントロールのオプション

出力変数

注釈

自動テストをテスト計画と統合する

要求事項

フィードバック

その他のリソース

タスクコントロールのオプション