手動テストの実行

Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022

Microsoftテスト ランナーを使用して手動テストを実行し、各テスト ステップの結果を記録します。 Web アプリケーションとデスクトップ アプリケーションの両方をテストしたり、スイート内のすべてのアクティブなテストを実行したり、特定のテスト ケースを選択したり、特定のビルドに対してテストを実行したりできます。

テストの実行中に、テスト ステップ、スクリーンショット、コメントを自動的に含め、スクリーンショットのキャプチャ、アクションの記録、テスト ランナーからのバグの直接作成または更新を行うことができます。

テスト ポイント

テスト ケース自体は実行可能ではありません。 テスト スイートにテスト ケースを追加すると、 テスト ポイントが生成されます。 テスト ポイントは、テスト ケース、テスト スイート、構成、テスト担当者の一意の組み合わせです。

たとえば、Test サインイン機能という 2 つの構成 (Microsoft Edgeと Chrome) のテスト ケースでは、2 つのテスト ポイントが生成されます。 各テスト ポイントは個別に実行でき、各実行によってテスト結果が生成されます。 テスト ポイントのすべての実行を実行履歴で表示できます。 [ 実行 ] タブには、各テスト ポイントの最新の結果が表示されます。

実行オプション

Web ブラウザー ランナーは、サポートされている任意のブラウザーで実行され、スクリーンショット、アクション ログ、画面記録をサポートします。 Web アプリケーションとデスクトップ アプリケーションの両方で機能します。

重要

Windowsのテスト ランナー クライアントは廃止されます。 Web ベースのテスト ランナーに移行します。このランナーは、パフォーマンスの向上と継続的な開発で同じ機能を提供します。 詳細については、「 Azure Test Plansを参照してください。

実行オプションにアクセスするには、[ 実行 ] タブでテストを選択し、[ オプションを指定して実行] を選択します。 [ オプションを指定して実行 ] ダイアログでは、次のことができます。

前提条件

カテゴリ 要件
プロジェクトアクセス権 プロジェクトの成員。
アクセス レベル Basic 以上のアクセス レベル。 詳細については、「手動テストのアクセスおよび許可」を参照してください。

TCM コマンドライン ツールの前提条件

カテゴリ 要件
ツール Visual Studio 2017 (Professional または Enterprise) 以前。 TCM 実行可能ファイル (tcm.exe) は、次のディレクトリにあります。
- %programfiles(x86)%\Microsoft Visual Studio\2017\Professional\Common7\IDE
- %programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE
- %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
アクセス レベル 少なくともアクセスしたいプロジェクトの基本アクセスとメンバーシップが必要です。 テスト 計画とテスト スイートを複製またはインポートするには、 Basic + Test Plans アクセスが必要です。 詳細については、「手動テストのアクセスおよび許可」を参照してください。

TCM コマンドを実行するには、 /collection パラメーターと /teamproject パラメーターを指定し、必要に応じて /login します。

パラメーター 説明
/コレクション:CollectionURL 必須。 チーム プロジェクト コレクションの URI を指定します。 URI の形式は次のとおりです。
- Azure DevOps サービスの場合: https://dev.azure.com/OrganizationName または https://OrganizationName.visualstudio.com
- Azure DevOps Serverの場合: http://ServerName:Port/VirtualDirectoryName/CollectionName。 仮想ディレクトリが使用されていない場合、形式は http://ServerName:Port/CollectionName です。
/teamproject:project 必須。 自動テストを複製またはインポートするテスト オブジェクトを含むプロジェクトの名前。
/login:username,[password] 省略可能。 コマンドを実行するアクセス許可を持つ有効なAzure DevOps ユーザーの名前とパスワードを指定します。 Windows資格情報に適切なアクセス許可がない場合、基本認証を使用している場合、またはドメインに接続していない場合は、このオプションを使用します。

Web アプリのテストを実行する

  1. Web ポータルでプロジェクトを開き、[Test Plans]>[テスト計画] を選びます。 テスト ケースをまだ作成していない場合は、「テスト ケースの作成」を参照してください。

  2. [自分のもの] または [すべて] を選ぶか、[タイトルでフィルター] を使ってテスト計画を見つけて選びます。 [実行] タブを選びます。

    テスト スイートが選ばれ、[実行] タブが選ばれているスクリーンショット

  3. テスト スイートから 1 つ以上のテストまたはすべてのテストを選びます。 次に、[Web アプリケーションの実行] を選びます。

    特定のテストを選んで実行する方法を示すスクリーンショット。

    Microsoftテスト ランナーが新しいブラウザー ウィンドウで開きます。

  4. テストするアプリを起動します。

    テスト結果を記録している Test Runner を示すスクリーンショット。

    テスト対象のアプリは、テスト ランナーと同じコンピューターで実行する必要はありません。 たとえば、別のデバイスでモバイル アプリまたはタブレット アプリをテストしているときに、デスクトップでテスト ランナーを実行できます。

  5. 予想される結果に基づいて、各テスト ステップを合格または不合格とマークします。

    Test Runner で開かれている失敗したテストを示すスクリーンショット。ここでコメントを入力できます。

    テスト ステップが失敗した場合は、失敗した理由に関するコメントを入力したり、テストの診断データを収集したりできます。 バグを作成または追加することもできます。

    重要

    期待される結果を持つテスト ステップは、 検証テスト ステップです。 テスト担当者は、各検証テスト ステップを合格または失敗としてマークする必要があります。 検証テスト ステップが失敗としてマーク されているか 、マークされていないままになっている場合、全体的なテスト ケースの結果は失敗します。

バグを作成するか、バグに追加する

テスト ステップが失敗した場合は、新しいバグを作成したり、テスト ランナーから直接既存のバグを更新したりできます。 テスト手順、コメント、診断データが自動的に含まれます。

新しいバグを作成する

  1. ステップが失敗したら、コメントを入力して [バグの作成] を選びます。

    失敗したテストと強調された [バグの作成] が表示されている Test Runner を示すスクリーンショット。

  2. [新しいバグ] ダイアログ ボックスで、バグの名前を入力します。 手順とコメントが自動的に追加されます。

    [バグの作成] が選択され、[新しいバグ] ダイアログ ボックスが開いている Test Runner を示すスクリーンショット。

    テスト ランナーが Web ブラウザーで実行されている場合は、クリップボードから直接バグにスクリーンショットを貼り付けることができます。

  3. 必要に応じて、バグの割り当て、コメントの追加、または他の作業項目へのリンクを行います。 終わったら [保存して閉じる] を選びます。

テスト セッションの間に報告されたバグを確認できます。

テストの間に作成されたバグの数を示すスクリーンショット。

Note

[バグの作成] ボタンでバグ作業項目が起動しない場合は、チームの設定を確認します。

  1. Project設定Team正しいチームが既定として設定されていることを確認します。
  2. [ イテレーションとエリア パス ] リンクを選択して、[チームの構成] ページを開きます。
  3. イテレーション、既定、バックログのイテレーションがテストケースのチームと一致することを確認します。
  4. [領域] を選択し、既定の領域がテスト ケースのチームと一致することを確認します。

既存のバグに追加する

新しいバグを作成する代わりに、既存のバグをエラーの詳細で更新します。 [バグの作成] ドロップダウン メニューから [既存のバグに追加] を選びます。

[既存のバグに追加] が選択されているテスト ランナーを示すスクリーンショット。

結果を保存して確認する

  1. テストの実行が完了したら、[ 保存して閉じる] を選択します。 Azure Test Plansは、すべてのテスト結果を格納します。

  2. [ 実行 ] タブで、テスト スイートのテスト状態を表示します。 各テストの最新の結果が表示されます。

    アクティブ、失敗、合格の結果が表示されたテスト ケースの実行結果を示すスクリーンショット。

    まだ実行していないテストには、 アクティブの状態が表示されます。 テストをもう一度実行するには、その状態を アクティブにリセットします。

  3. テスト中に提出されたバグを表示するには、テスト ケースの作業項目を開き、[ 関連する作業] セクションで子バグ リンクを確認します。

    そのテストに対して提出されたバグを表示する作業項目の [関連作業] セクションを示すスクリーンショット。

ヒント

テストをオフラインで実行し、結果をインポートすることもできます。 詳しくは、Offline Test Execution 拡張機能をご覧ください。

デスクトップ アプリのテストを実行する

重要

Windowsのテスト ランナー クライアントは廃止されます。 Web ベースのテスト ランナーに移行します。このランナーは、パフォーマンスの向上と継続的な開発で同じ機能を提供します。 詳細については、「 Azure Test Plansを参照してください。

Web ブラウザー ランナーを使用して、デスクトップ アプリケーションをテストできます。 デスクトップ アプリと共にブラウザー ウィンドウでテスト ランナーを実行し、各テスト ステップを合格または失敗としてマークします。

  1. 「Web アプリのテストを実行する」の手順に従って、[実行] タブでテスト 計画を開きます。

  2. 1 つ以上のテストを選択し、[ Web アプリケーションの実行] を選択します。

  3. デスクトップ アプリを開き、テスト 手順に従って、各ステップをテスト ランナーで成功または失敗としてマークします。

Web ランナーは、デスクトップ アプリのスクリーンショット、アクション ログ、画面記録をサポートしています。 詳細については、「 テスト中に診断データを収集する」を参照してください。

Note

デスクトップ アプリに Web ランナーを使用すると、スクリーンショットとアクション ログによって、デスクトップ アプリケーションではなくブラウザー ウィンドウがキャプチャされます。 画面記録を使用して、デスクトップ アプリを含む全画面表示をキャプチャします。

すべてのテストを実行する

テスト スイート内のすべてのテストを一度に実行できます。

テスト スイートを選択し、[ Web アプリケーションの実行 ] を選択して、すべてのアクティブなテストを実行します。

テスト スイート内のすべてのアクティブなテストを選んで実行する方法を示すスクリーンショット。

ビルドのテストを実行する

特定のビルドに対してテストを実行するには、実行オプションからビルドを選択します。

  1. ドロップダウンから [オプションを指定して実行] オプションを選びます。

    オプションを指定した Web アプリケーションのテストの実行を示すスクリーンショット。

  2. [オプションを指定して実行] ダイアログ ボックスで、目的のビルドを選びます。

    ビルドが選択された [オプションを指定して実行] ダイアログ ボックスを示すスクリーンショット。

    Note

    選択したビルドは、テストと同じプロジェクトのビルドである必要があります。

    実行中にファイルしたバグは選択したビルドに関連付けられ、テスト結果はそのビルドに対して発行されます。

テストの実行中にテスト ステップを変更する

テストの実行中にテスト手順を修正できます。 [テスト ステップの編集] アイコンを選択して、ステップを挿入、並べ替え、削除、または編集します。

テストの実行時にテスト ステップを編集するツールを示すスクリーンショット。

診断データをキャプチャする

テストの実行中に、スクリーンショット、アクション ログ、画面記録をキャプチャできます。 詳細な手順については、「 診断データの収集」を参照してください。

TCM を使用してテストを実行する

テスト ケース管理 (TCM) コマンド ライン ツールを使用して、テスト 計画の一部であるテストを実行できます。 このツールを使うと、テスト実行を作成して開始し、既存のすべてのテスト実行を管理できます。 これらのタスクを実行するには、ここに記載されている tcm コマンドを使います。

テスト実行を一覧表示する | テスト実行を作成する | テスト実行を実行する | テスト実行を中止する | テスト実行を削除する | テスト実行をエクスポートする | テスト実行を発行する

テスト実行を一覧表示する

テスト計画で使用可能な実行とその tcm run /list の一覧を表示するには、 を使います。 ID は、実行の作成時に定義された作業項目 ID に対応します。

tcm run /list /collection:teamprojectcollectionurl /teamproject:project 
           [/planid:id  |  /querytext:query] [/login:username,[password]]
パラメーター 説明
/planid:id 省略可能。 指定したテスト 計画に関連付けられているテスト実行のみを返します。
/querytext:query 省略可能。 テスト計画のサブセットの一覧を表示するために使うクエリを指定します。

/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドでは、fabrikamprime 組織でホストされている Fabrikam Fiber プロジェクトに対して定義されているテスト実行の一覧が表示されます。 ID とタイトルは、そのテスト実行に定義されている作業項目 ID とタイトルに対応します。 たとえば、テスト実行 1000052 には、 サイクル 1 のテスト計画 (手動) というタイトルが付けられます。

tcm run /list /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

Id        Title                              Owner               Date Completed
--------- ---------------------------------- ------------------- -----------
1000006   Sprint 2 (Manual)                  Jamal Hartnett      1/5/2026
1000032   33 : Change initial view (Manual)  Christie Church     1/11/2026
1000040   Sprint 2 (Manual)                  Jamal Hartnett      1/16/2026
1000042   Sprint 3 (Manual)                  Jamal Hartnett      1/16/2026
1000046   Special testing (Manual)           Francis Totten      1/18/2026
1000052   Test Plan for Cycle 1 (Manual)     Chuck Reinhart      2/1/2026
1000060   Game Shopping (Manual)             Chuck Reinhart      2/6/2026

テスト実行を作成する

指定したテスト計画に関連付けられたテスト実行を作成するには、tcm run /create を使います。 テスト計画に加えて、使用するテスト スイートと構成を対応する ID で指定します。 これらの ID を収集するには、 tcm plans /list、 tcm suites /list、および tcm configs /list コマンドを使用 します。

tcm run /create /title:title /planid:id /collection:CollectionURL /teamproject:project 
            (suiteid:id /configid:configid | /querytext:query) 
            [/settingsname:name] [/owner:owner] [/builddir:directory]  
            [/testenvironment:name] [/login:username,[password]] [/include]
パラメーター 説明
/title:title 作成するテスト実行のタイトルを指定します。
/planid:id テスト実行を作成したいテスト計画を指定します。
/suiteid:id テストの実行に使用するテスト スイートを指定します。
/configid:id テスト スイートに対して実行するテスト構成を指定します。
/querytext:query suiteid と configid を指定する場合は省略可能です。 実行するテストの選択に使うクエリを指定します。

ヒント： 複数のテスト スイートを実行するには、 /querytest パラメーターを使用します。 たとえば、 querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)”と指定します。
/settingsname:name 省略可能。 このテスト実行に使うテスト設定を指定します。 テスト設定を選ばないと、テスト計画の既定のテスト設定が使われます。
/owner:owner 省略可能。 テスト実行の所有者を指定します。
/builddir:directory 省略可能。 テスト用のテスト アセンブリを探すために使うビルド ディレクトリを指定します。 このパラメーターを指定しない場合、ビルドの場所は、現在テスト 計画に割り当てられているビルドに基づいて使用されます。
/testenvironment:name 省略可能。 このテスト実行に使うテスト環境を指定します。 テスト環境を選ばないと、テスト計画の既定のテスト環境が使われます。
/include 省略可能。 テストが現在アクティブな状態でない場合でも、テスト実行用に選択されたすべてのテストが含まれます。

/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、ID を持つテスト 計画に 77 という名前のテスト実行を作成します。 この実行では、ID を持つテスト スイートと161ID を持つテスト構成9を使用します。 この実行は、fabrikamprime 組織でホストされている Fabrikam Fiber プロジェクトに対して定義されます。

この例では、テストの実行には の 1000082。

tcm run /create /title:MyTestRun /planid:77 /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber" /suiteid:161 /configid:9

Run created with ID: 1000082.

テスト実行を実行する

tcm run /executeを使用して、テスト計画のいずれかの実行を開始します。 指定する ID は、実行の作成時に定義された作業項目 ID に対応します。 すべてのテスト実行識別子の一覧を表示するには、 tcm run /list コマンドを使用します。

tcm run /execute /id:id /collection:teamprojectcollectionurl /teamproject:project [/login:username,[password]]
パラメーター 説明
/id:id 実行するテスト実行の ID を指定します。

/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、fabrikamprime 組織でホストされている 1000082 プロジェクトの ID のテスト実行を開始します。 結果が CLI ウィンドウに表示されます。

tcm run /execute /id:1000082 /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

Executing run: MyTestRun

Results
------------------------
Total:                   2
Passed:                  1
Failed:                  1
Inconclusive:            0

テスト実行を中止する

tcm run /abortを使用して、進行中のテストの実行を取り消します。 指定する ID は、実行の作成時に定義された作業項目 ID に対応します。

tcm run /abort /id:id /collection:teamprojectcollectionurl /teamproject:project [/login:username,[password]]
パラメーター 説明
/id:id 取り消すテスト実行の ID を指定します。

/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、fabrikamprime 組織でホストされている 1000082 プロジェクトの ID を使用してテストの実行を停止します。 結果は、取り消された実行の ID と タイトル を確認します。

tcm run /abort /id:1000082 /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

Run with ID [1000082] and title [MyTestRun] has been aborted.

テスト実行を削除する

テスト計画からテスト実行を削除するには、tcm run /delete を使います。 指定する ID は、テスト実行の作成時に定義された作業項目 ID に対応しています。

tcm run /delete /id:id [/noprompt] /collection:teamprojectcollectionurl /teamproject:project [/login:username,[password]]
パラメーター 説明
/id:id 削除するテスト実行の ID を指定します。
/noprompt 省略可能。 テスト実行の削除の確認をユーザーに求めないことを指定します。

/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、fabrikamprime 組織でホストされている 1000082 プロジェクトの ID を使用してテスト実行を削除します。 ユーザーは指定したテスト実行を削除する意思の確認を求められ、結果が提供されます。

tcm run /delete /id:1000082 /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

Are you sure you want to delete run [MyTestRun]? (Yes/No) y

Run [MyTestRun] has been deleted.

テスト実行をエクスポートする

テスト実行を指定した場所にエクスポートするには、tcm run /export を使います。 指定する ID は、実行の作成時に定義された作業項目 ID に対応しています。

tcm run /export /id:id /resultsfile:path /collection:teamprojectcollectionurl /teamproject:project [/login:username,[password]]
パラメーター 説明
/id:id エクスポートするテスト実行の ID を指定します。
/resultsfile:path エクスポートするテスト実行の場所とファイル名を指定します。

/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、fabrikamprime 組織でホストされている 1000082 プロジェクトの ID を使用してテスト実行をc:\temp\ResultsForDeveloper.trxにエクスポートします。

tcm run /export /id:1000082 /resultsfile:"c:\temp\ResultsForDeveloper.trx" /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

テスト実行を発行する

tcm run /publish を使用して、Visual Studio のテスト実行結果ファイルを、指定されたテスト計画に対して公開します。

tcm run /publish /suiteid:id /configid:id /resultowner:owner /resultsfile:path 
            /collection:teamprojectcollectionurl /teamproject:project [/title:runtitle] 
            [/runowner:owner] [/build:buildnumber /builddefinition:builddefinition] 
            [/flavor:flavor] [/platform:platform] [/assignfailurestouser:user] 
            [/login:username,[password]] [/buildverification]
パラメーター 説明
/suiteid:id テスト実行を発行するときに使うテスト スイートを指定します。
/configid:id テスト実行を発行するときに使うテスト構成を指定します。
/resultowner:owner テスト結果の所有者を指定します。
/resultsfile:path 発行するテスト実行の場所を指定します (例: "c:\temp\ResultsForDeveloper.trx")。
/title:runtitle 省略可能。 発行するテスト実行に使うタイトルを指定します。
/runowner:owner 省略可能。 テスト実行の所有者を指定します。
/build:buildnumber 省略可能。 テスト実行の発行に使うビルド番号を指定します。 このパラメーターは、/builddefinition と共に使う必要があります。
/builddefinition:builddefinition 省略可能。 テスト実行の発行に使うビルド定義を指定します。 このパラメーターは、/build と共に使う必要があります。
/flavor:flavor 省略可能。 Release などのビルド フレーバーを指定します。 このパラメーターは、/build パラメーターが使われている場合にのみ使用できます。
/platform:platform 省略可能。 ビルド プラットフォームを指定します (x86 など)。 このパラメーターは、/build パラメーターが使われている場合にのみ使用できます。
/assignfailurestouser:user 省略可能。 テスト実行で失敗したテストを割り当てるユーザーを指定します。
/buildverification 省略可能。 このテスト実行に、ビルドの基本的な機能を確認するビルド検証テストが含まれることを指定します。

/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドでは、テスト スイートが ID161 でテスト構成が ID9 のテスト実行が発行されて、所有者が再割り当てされます。 このコマンドは、この構成と組み合わせて、指定した .trx ファイルに結果を発行する、テスト スイート内のテスト ケースの既存のテスト ポイントを更新します。 このコマンドは、テスト実行で失敗したテストを指定したユーザーに割り当てます。

tcm run /publish /suiteid:167 /configid:9 /resultowner:"Jamal Hartnett" /resultsfile:"c:\temp\ResultsForDeveloper.trx" /assignfailurestouser:"Chuck Reinhart" /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

::: moniker-end

よく寄せられる質問

Q: テスト実行の添付ファイルをプレビューできないのはなぜですか?

A： プレビューできるのは、 .txt ファイルと .log ファイルのみです。 その他のファイルの種類については、添付ファイルをダウンロードします。

Q: テスト データの保持期間を制御するにはどうすればよいですか?

A： 「 テストアイテム保持ポリシーの設定」を参照してください。

Q: オフラインでテストを実行して結果をインポートすることはできますか?

A: はい。Offline Test Execution 拡張機能をご覧ください。

次のステップ

テストの進行状況を表示する

関連コンテンツ

  • Last updated on