Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
Microsoft Test Runner を使って手動テストを実行し、各テスト ステップのテスト結果を記録します。 Web アプリケーションとデスクトップ アプリの両方のテストを実行できます。
Test Runner を使うと、すべてのアクティブなテストをバッチまたは特定のテスト ケースとして実行できます。 テストの実行中にそれを変更します。 特定のビルドについてテストを実行できます。
テスト中に、スクリーンショットやテスト アクションなどの情報を収集します。 テストで問題が見つかった場合は、Test Runner を使ってバグを作成します。 テスト手順、スクリーンショット、コメントをバグに含めます。
Note
テスト ケースではなく、テスト ポイントを実行します。 テスト スイートにテスト ケースを追加すると、1 つ以上のテスト ポイントが生成されます。 テスト ポイントは、テスト ケース、テスト スイート、構成、テスト担当者の一意の組み合わせを表します。
たとえば、テスト ケースの名前がTest login functionality で、Edge ブラウザーと Chrome ブラウザー用の 2 つの構成がある場合、2 つのテスト ポイントが生成されます。 これらの各テスト ポイントを実行できます。 実行すると、テスト結果が生成されます。 テスト結果ビューまたは実行履歴で、テスト ポイントのすべての実行を確認できます。 [実行] タブには、テスト ポイントの最新の実行が表示されます。
サポートされているクライアントと実行のオプション
特定のビルドのテストの実行に加えて、実行オプションではさまざまなテスト シナリオがサポートされています。 オプションを表示するには、[実行] タブでテストを選んでから、[オプションを指定して実行] を選びます。
[テストの種類とランナーを選択する] には次のオプションがあります。
[Web ブラウザー ベースのランナーを使用する手動テスト]: 「ビルドのテストを実行する」で説明されているように、テストする特定のビルドを選択できます。 [ビルドの検索] を選んで [ビルドの検索] ダイアログ ボックスを開き、テスト対象のビルドを検索します。
[Test Runner クライアントを使用した手動のテスト]: Test Runner クライアントを使ってデスクトップ アプリケーションの手動テストを実行できます。 必要な場合は、Test Runner デスクトップ クライアントをインストールします。
[リリース ステージを使用した自動テスト]: リリース ステージを使ってテストを実行するには、ビルドを選びます。 ビルドの成果物を使用するリリース パイプラインとステージを選びます。 詳しくは、「テスト計画から自動テストを実行する」をご覧ください。
[Microsoft Test Manager 2017 クライアントを使用して手動でテスト]: ローカル コンピューターからデータを収集します。 ビルドを選びます。 データ コレクター ([操作ログ]、[イベント ログ]、[画面と音声のレコーダー]、[システム情報]) を 1 つ以上選びます。
[Microsoft Test Manager 2015 以前のクライアントを使用して手動でテスト]:
Microsoft Test Manager クライアントのテスト センターは、デスクトップ ベースの手動テスト ソリューションです。 テスト担当者は、手動テストのニーズにそれを使用できます。 詳しくは、「 Microsoft Test Manager の使用に関するガイダンス」をご覧ください。 Microsoft Test Manager を入手するには、Visual Studio Enterprise または Visual Studio Test Professional をインストールします。
前提条件
| カテゴリ | 要件 |
|---|---|
| プロジェクトへのアクセス | プロジェクトメンバー. |
| アクセスレベル | Basic 以上のアクセス レベル。 詳細については、「手動テストのアクセスとアクセス許可」を参照してください。 |
TCM コマンドライン ツールの前提条件
| カテゴリ | 要件 |
|---|---|
| ツール | Visual Studio 2017 Professional 以前のバージョン。 コマンド プロンプトと次のディレクトリから TCM にアクセスします。 - %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- TCM コマンドを実行するには、 /collection パラメーターと /teamproject パラメーターを指定し、必要に応じて /login します。 次の必須パラメーターと省略可能なパラメーターの表も参照してください。 |
| アクセスレベル | - アクセスする 1 つ以上のプロジェクトの有効なプロジェクト メンバーシップと、実行するコマンドに基づく必要なアクセス許可。 詳細については、「手動テストのアクセスとアクセス許可」を参照してください。 - テスト オブジェクトを複製またはインポートするためのテスト 計画とテスト スイートを追加する場合と同じアクセス レベル。 |
| パラメーター | 説明 |
|---|---|
/徴収:CollectionURL |
必須。 チーム プロジェクト コレクションの URI を指定します。 URI の形式は次のとおりです。 - Azure DevOps Services の場合: http://dev.azure.com/OrganizationName- Azure DevOps Server の場合: http://ServerName:Port/VirtualDirectoryName/CollectionName。 仮想ディレクトリが使用されていない場合の URI の形式: http://ServerName:Port/CollectionName。 |
/teamproject:project |
必須。 自動テストを複製またはインポートするテスト オブジェクトを含むプロジェクトの名前。 |
/login:username,[password] |
省略可能。 有効な Azure DevOps ユーザーの名前とパスワード、およびコマンドを実行するアクセス許可を持つユーザーを指定します。 Windows 資格情報に適切なアクセス許可がない場合、基本認証を使用している場合、ドメインに接続していない場合は、このオプションを使用します。 |
Web アプリのテストを実行する
Web アプリケーションのテストを実行するには、次の手順のようにします。
Web ポータルでプロジェクトを開き、[Test Plans]>[テスト計画] を選びます。
まだ行っていない場合は、手動テストを作成します。
[自分のもの] または [すべて] を選ぶか、[タイトルでフィルター] を使ってテスト計画を見つけて選びます。 [実行] タブを選びます。
![テスト スイートが選ばれ、[実行] タブが選ばれているスクリーンショット](media/run-manual-tests/test-suite-execute-tab.png?view=azure-devops)
テスト スイートから 1 つ以上のテストまたはすべてのテストを選びます。 次に、[Web アプリケーションの実行] を選びます。
新しいブラウザーで Microsoft Test Runner が開いて実行されます。
テストするアプリを起動します。
Test Runner と同じコンピューターでアプリを実行する必要はありません。 Test Runner は、テストの手動実行中に合格または失敗したテスト ステップを記録するためだけに使います。
たとえば、デスクトップ コンピューターで Test Runner を実行し、Windows 8 タブレットでテストする Windows 8 用ストア アプリを実行できます。
予想される結果に基づいて、各テスト ステップを合格または不合格とマークします。
テスト ステップが失敗した場合は、失敗した理由に関するコメントを入力したり、テストの診断データを収集したりできます。 バグを作成したり、バグに追加したりすることもできます。
重要
期待される結果があるテスト ステップは、検証テスト ステップと呼ばれます。 テスト手順が、検証テスト手順の場合、テスト担当者は、状態でテスト手順をマークする必要があります。 テスト ケースの全体的な結果には、テスト担当者がマークしたすべてのテスト ステップの状態が反映されます。 したがって、テスト担当者がいずれかのテスト ステップを失敗とマークした場合、またはマークしなかった場合、テスト ケースは失敗状態になります。
バグを作成するか、バグに追加する
テスト ステップが失敗した場合は、動作に関するコメントを入力し、診断データを収集します。 バグを作成して、問題のキャプチャと追跡を行うことができます。 また、失敗に関する情報で既存のバグを更新することもできます。
ステップが失敗したら、コメントを入力して [バグの作成] を選びます。
![失敗したテストと強調された [バグの作成] が表示されている Test Runner を示すスクリーンショット。](media/run-manual-tests/create-bug-button.png?view=azure-devops)
Note
[バグの作成] ボタンでバグ作業項目が開始しない場合は、次のようにチームの設定の領域とイテレーション レベルが正しいかどうかを確認します。
プロジェクトの設定とチームに移動し、正しいチームが既定として設定されているかどうかを確認します。
そのチームから、チーム名の近くにあるイテレーションと領域のパスのハイパーリンクをクリックします。 チームの構成ページに移動します。
チームの構成ページでイテレーションを選びます。既定とバックログのイテレーションが、テスト ケースが実行されているチームと一致する必要があります。
チームの構成ページで、領域を選びます。既定の領域が、テスト ケースが実行されているチームと一致している必要があります。
[新しいバグ] ダイアログ ボックスで、バグの名前を入力します。
![[バグの作成] が選択され、[新しいバグ] ダイアログ ボックスが開いている Test Runner を示すスクリーンショット。](media/run-manual-tests/create-bug-test-fail.png?view=azure-devops)
手順とコメントが、バグに自動的に追加されます。 Test Runner が Web ブラウザー ウィンドウで実行されている場合は、スクリーンショットをクリップボードからバグに直接コピーできます。
バグの割り当て、コメントの入力、または他の問題へのリンクを行うことができます。 終わったら [保存して閉じる] を選びます。 作成したバグにテスト ケースがリンクされます。
テスト セッションの間に報告されたバグを確認できます。
バグを作成する代わりに、このステップに関する情報で既存のバグを更新することもできます。 [バグの作成] ドロップダウン メニューから [既存のバグに追加] を選びます。
![[既存のバグに追加] が選択されている Test Runner を示すスクリーンショット](media/run-manual-tests/find-existing-bug.png?view=azure-devops)
結果を保存し、セッションを終了して、結果を確認する
テストが完了したら、結果を保存し、セッションを閉じて、テスト結果を確認します。
すべてのテストを実行したら、[保存して閉じる] を選びます。 すべてのテスト結果は、Azure Test Plans に格納されます。
テスト スイートのテスト状態を表示します。 各テストの最新の結果が表示されます。
まだ実行していないテストの状態はアクティブです。 テストを再実行したい場合は、その状態をアクティブにリセットします。
テスト スイートを開き、[関連作業] セクションでテスト ケースを選びます。 次に、その作業項目の [関連作業] セクションの子リンクを使い、テスト担当者によって提出されたバグを表示します。
![そのテストに対して提出されたバグを表示する作業項目の [関連作業] セクションを示すスクリーンショット。](media/run-manual-tests/related-work-shows-bugs.png?view=azure-devops)
オフラインでテストを実行して結果をインポートすることができます。 詳しくは、Offline Test Execution 拡張機能をご覧ください。
デスクトップ アプリのテストを実行する
デスクトップ アプリケーションの診断データをさらに収集する場合は、Test Runner クライアントを使ってテストを実行します。
Web ポータルでプロジェクトを開き、[Test Plans]>[テスト計画] を選びます。
[自分のもの] または [すべて] を選ぶか、[タイトルでフィルター] を使ってテスト計画を見つけて選びます。 [実行] タブを選びます。
Azure Test Plans のドロップダウン メニューから [デスクトップ アプリケーションの実行] を選んで Test Runner を起動します。
必要な場合は、Test Runner デスクトップ クライアントをダウンロードしてインストールします。
![[デスクトップ アプリケーションの実行] ダイアログ ボックスと、Test Runner をダウンロードして起動するためのオプションが示されているスクリーンショット。](media/run-manual-tests/tr-atp-launch.png?view=azure-devops)
Note
- お使いのプラットフォームで Test Runner クライアントを使用できることを確認します。 現在、Test Runner は x64 でのみ使用できます。
- 組織で Microsoft Entra 経由の条件付きアクセス ポリシーが使われている場合、Azure Test Runner が機能しない可能性があります。 詳しくは、条件付きアクセスでの一般的な決定に関する記事をご覧ください
前のセクションで説明したように [起動] を選んでテストを開始します。 データの収集について詳しくは、「テスト中の診断データの収集」をご覧ください。
すべてのテストを実行する
テスト スイート内のすべてのテストを一度に実行できます。
すべてのアクティブなテストを実行するには、テスト スイートを選んで [Web アプリケーションの実行] または [デスクトップ アプリケーションの実行] を選びます。
ビルドのテストを実行する
テストを実行するビルドを選びます。
ドロップダウンから [オプションを指定して実行] オプションを選びます。
[オプションを指定して実行] ダイアログ ボックスで、目的のビルドを選びます。
![ビルドが選択された [オプションを指定して実行] ダイアログ ボックスを示すスクリーンショット。](media/run-manual-tests/run-test-select-build.png?view=azure-devops)
Note
選ぶビルドは、テストが定義されているプロジェクトのものである必要があります。
次のオプションでビルドを選択できます。
- Web ブラウザー ベースのランナーを使用する手動テスト
- リリース ステージを使用した自動テスト
- Microsoft Test Manager 2017 クライアントを使用して手動でテスト
ダイアログ ボックスに表示されるフィールドは、選んだオプションによって異なります。 詳しくは、「サポートされているクライアントと実行のオプション」をご覧ください。
実行中に報告されたバグは、選ばれているビルドに関連付けられます。 テスト結果は、そのビルドに対して公開されます。
テストの実行中にテスト ステップを変更する
テストがまだ実行されている間に、テストのステップに関する問題を修正します。 [テスト ステップの編集] アイコンを選びます。
ステップの挿入、並べ替え、削除を行うことができます。 テキスト自体を編集することもできます。
豊富な診断データをキャプチャする
テストの実行中に、スクリーンショットを追加したり、アクションをログとしてキャプチャしたり、ビデオや音声を記録したりできます。
スクリーンショットを追加する
テストの実行中に、テスト結果にスクリーンショットを追加します。
Google Chrome または Firefox をお使いの場合、テスト中に Web アプリのスクリーンショットを取得するには Web ランナーを使います。 Microsoft Internet Explorer または Microsoft Edge ブラウザーの場合、またはデスクトップ アプリのテストの場合は、Test Runner デスクトップ クライアントを使います。
詳細については、「診断データを修正する」を参照してください。
テストからアクションをキャプチャする
アプリケーションでのアクションをログとしてキャプチャします。
Google Chrome または Firefox をお使いの場合は、Web ランナーを使って、テスト中に Web アプリでのアクションを画像ログとしてキャプチャします。 Microsoft Internet Explorer または Microsoft Edge ブラウザーの場合、またはデスクトップ アプリのテストの場合は、Test Runner デスクトップ クライアントを使います。
詳細については、「診断データを修正する」を参照してください。
テストしているアプリの画面記録をキャプチャする
テスト中にアプリの画面記録をキャプチャします。
Google Chrome または Firefox をお使いの場合は、Web ランナーを使って、テスト中に Web アプリとデスクトップ アプリの画面記録をキャプチャします。 Microsoft Internet Explorer または Microsoft Edge ブラウザーの場合、またはデスクトップ アプリのテストの場合は、Test Runner デスクトップ クライアントを使います。
詳細については、「診断データを修正する」を参照してください。
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 のタイトルは Test Plan for Cycle 1 (Manual) です。
tcm run /list /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"
Id Title Owner Date Completed
--------- ---------------------------------- ------------------- -----------
1000006 Sprint 2 (Manual) Thomas Margand 11/5/2021
1000032 33 : Change initial view (Manual) Danielle Brasseur 11/11/2021
1000040 Sprint 2 (Manual) Thomas Margand 11/16/2021
1000042 Sprint 3 (Manual) Thomas Margand 11/16/2021
1000046 Special testing (Manual) Nicoletta Guibord 11/18/2021
1000052 Test Plan for Cycle 1 (Manual) Bukhosi Bhengu 12/1/2021
1000060 Game Shopping (Manual) Bukhosi Bhengu 12/6/2021
テスト実行を作成する
指定したテスト計画に関連付けられたテスト実行を作成するには、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 コマンド ライン ツールを使用した作業」を参照してください。
例
次のコマンドでは、MyTestRun という名前のテスト実行が、ID77 のテスト計画に作成されます。 この実行では、ID161 のテスト スイートと、ID9 のテスト構成が使われます。 この実行は、fabrikamprime 組織でホストされている Fabrikam Fiber プロジェクトに対して定義されます。
この例のテスト実行は、1000082 という ID で作成されます。
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 コマンドを使うと、すべてのテスト実行 ID の一覧を確認できます。
tcm run /execute /id:id /collection:teamprojectcollectionurl /teamproject:project [/login:username,[password]]
| パラメーター | 説明 |
|---|---|
/id:id |
実行するテスト実行の ID を指定します。 |
/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。
例
次のコマンドでは、fabrikamprime 組織でホストされている Fabrikam Fiber プロジェクトに対する ID1000082 のテスト実行が開始されます。 結果は 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 組織でホストされている Fabrikam Fiber プロジェクトに対する ID1000082 のテスト実行が停止されます。 結果では、取り消された実行の 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 組織でホストされている Fabrikam Fiber プロジェクトに対する ID1000082 のテスト実行が削除されます。 ユーザーは指定したテスト実行を削除する意思の確認を求められ、結果が提供されます。
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 組織でホストされている Fabrikam Fiber プロジェクトの ID1000082 のテスト実行を、c:\temp\ResultsForDeveloper.trx にエクスポートすることを指定します。
tcm run /export /id:1000082 /resultsfile:"c:\temp\ResultsForDeveloper.trx" /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"
テスト実行を発行する
指定したテスト計画の Visual Studio テスト実行結果ファイルから結果を発行するには、tcm run /publish を使います。
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:"Thomas Margand" /resultsfile:"c:\temp\ResultsForDeveloper.trx" /assignfailurestouser:"Bukhosi Bhengu" /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"
よく寄せられる質問
よくある質問を次に示します。
Q: テストを実行し直すにはどうすればよいですか?
A: 任意のテストを選んで、[実行] を選ぶだけです。
Q: テスト スイート内のすべてのテストを一緒に実行できますか?
A: はい。テスト スイートを選んで、[実行] を選びます。 このオプションは、テスト スイート内のすべてのアクティブなテストを実行します。 まだ実行していないテストの状態はアクティブです。 テストを再実行する場合は、その状態をアクティブにリセットできます。
Q: テストを実行するビルドを選択できますか?
A: はい。[実行] を選んでから、[オプションを指定して実行] を選びます。
ドロップダウン リストから目的のビルドを選びます。
実行中に報告されたすべてのバグは、選択されているビルドに自動的に関連付けられます。 テスト結果は、そのビルドに対して公開されます。
Note
選ぶビルドは、テストが定義されているプロジェクトのものである必要があります。
Q: テストの実行中にテストのステップを修正できますか?
A: はい (Azure DevOps に対して Azure Test Plans を使用している場合)。 ステップの挿入、移動、削除を行うことができます。 または、テキスト自体を編集できます。 テスト ステップ番号の横にある編集アイコンを使います。
テストのステップを編集するツールが表示されます。
Q: テストの実行時に、スクリーンショットをテスト結果に追加できますか?
A: Google Chrome または Firefox をお使いの場合、テスト中に Web アプリのスクリーンショットを取得するには Web ランナーを使います。 Microsoft Internet Explorer または Microsoft Edge ブラウザーの場合、またはデスクトップ アプリのテストの場合は、Test Runner デスクトップ クライアントをダウンロードして使用できます。
詳細については、「診断データを修正する」を参照してください。
Q: アプリでのアクションをログとしてキャプチャできますか?
A: Google Chrome または Firefox をお使いの場合は、Web ランナーを使って、テスト中に Web アプリでのアクションを画像ログとしてキャプチャします。 Microsoft Internet Explorer または Microsoft Edge ブラウザーの場合、またはデスクトップ アプリのテストの場合は、Test Runner デスクトップ クライアントをダウンロードして使用できます。
詳細については、「診断データを修正する」を参照してください。
Q: アプリの画面記録をキャプチャできますか?
A: Google Chrome または Firefox をお使いの場合は、Web ランナーを使って、テスト中に Web アプリとデスクトップ アプリの画面記録をキャプチャします。 Microsoft Internet Explorer または Microsoft Edge ブラウザーの場合、またはデスクトップ アプリのテストの場合は、Test Runner デスクトップ クライアントをダウンロードして使います。
詳細については、「診断データを修正する」を参照してください。
Q: テスト実行の添付ファイルの一部でプレビュー オプションが表示されません。
A: プレビューできるのは、拡張子が txt と log のファイルのみです。 拡張子が txt または log のファイルのプレビュー オプションをクリックすると、別の UI が開き、ドロップダウン フィールドにテスト実行のすべての添付ファイルが表示されます。 拡張子の種類が txt または log 以外のファイルを選ぶと、次のメッセージが表示されます: "プレビューできるのは拡張子が txt と log のファイルだけです。ここをクリックして、この添付ファイルをダウンロードしてください。"
Q: テスト データの保持期間を制御するにはどうすればよいですか?
A: 詳しくは、「テスト保持ポリシーを設定する」をご覧ください。
Q: Test Runner クライアントはどこでダウンロードできますか?
A:Test Runner デスクトップ クライアントをダウンロードします。
Q: Test Runner クライアントでサポートされているオペレーティング システムは何ですか?
A: Test Runner デスクトップ クライアントは、現在、Windows x64 プラットフォームでのみサポートされています。
Q: Azure Test Runner デスクトップ クライアントを使っているときに、テスト実行エラーが発生します。
A: 最新バージョンの Test Runner デスクトップ クライアントを使っていることを確認してください。 Test Runner デスクトップ クライアントをダウンロードします。
Q: Azure Test Runner デスクトップ クライアントは、Microsoft Entra の条件付きアクセスが有効になっているデバイスで動作しますか?
A: 組織で Microsoft Entra 経由の条件付きアクセス ポリシーが使われている場合、Azure Test Runner が機能しない可能性があります。 詳しくは、条件付きアクセスでの一般的な決定に関する記事をご覧ください。 これは既知の制限であり、このシナリオでは Web ランナーを使うことをお勧めします。
Q: Test Runner クライアントのテレメトリをオプトアウトできますか?
A: いいえ。 Test Runner デスクトップ クライアントでは、ユーザーを特定できるデータは収集されません。 オプトアウト メカニズムは提供されていません。 詳しくは、Microsoft のプライバシー ポリシーに関する記事をご覧ください。
Q: オフラインでテストを実行して結果をインポートすることはできますか?
A: はい。Offline Test Execution 拡張機能をご覧ください。