テスト計画、テスト スイート、テスト ケースをコピーまたは複製する

テスト計画、テスト スイートまたはその他のテスト オブジェクトの一覧を生成するには、次の手順を実行します。

1. プロジェクトで、[Boards]>[クエリ] を選択します。
2. クエリ エディターにパラメーター Work Item Type=Test Plan を入力します。 チーム プロジェクトに定義されているすべてのテスト計画を一覧表示できます。
3. [複数プロジェクトにわたるクエリ] チェックボックスをオンにします。 クエリによって、すべてのプロジェクトに定義されているすべてのテスト計画が一覧表示されます。 詳細については、「作業項目クエリを定義する」を参照してください。
4. クエリを実行します。

TCM によって、テスト計画とテスト スイートの一覧表示がサポートされます。 一覧には、各テスト計画またはテスト スイートの作業 ID が示されます。 この ID は計画 ID またはスイート ID と同じです。

テスト計画を一覧表示する | テスト スイートを一覧表示する

テスト計画を一覧表示する

tcm plans /list を使用してテスト計画の ID を判別します。 この ID は、テスト計画の作成時に定義された作業項目 ID に対応しています。

tcm plans /list [/planid:id  |  /querytext:query] /collection:teamprojectcollectionurl
           /teamproject:project [/login:username,[password]]

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

例

次のコマンドは、fabrikamprime 組織でホストされている Fabrikam Fiber プロジェクトに対して定義されているテスト計画を一覧表示します。 ID と Name は、テスト計画に定義されている作業項目 ID とタイトルに対応しています。 たとえば、テスト計画 86 のタイトルは Hello World Test です。

tcm plans /list /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber"

Id        Name
------***----------------------------------------------------------------
66        Sprint 1
72        All sprints
77        Sprint 2
86        Hello World Test

テスト スイートを一覧表示する

tcm suites /list を使用して、テスト スイートとその作業項目 ID を一覧表示します。 省略可能なパラメーターが指定されていない場合は、チーム プロジェクトのすべてのテスト スイートが一覧表示されます。

tcm suites /list [/planid:id  |  /querytext:query] /collection:teamprojectcollectionurl
           /teamproject:project [/login:username,[password]]

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

例

次のコマンドは、fabrikamprime 組織でホストされている Fabrikam Fiber プロジェクトに対して定義されているテスト スイートを一覧表示します。 ID は、テスト スイートに対して定義されている作業項目 ID に対応します。 Name 列の最初のエントリは、テスト スイートが定義されているテスト計画を示します。 -> (矢印) の後にあるのは、テスト スイートのタイトルまたは親テスト スイートのタイトルです。 たとえば、テスト スイート 75、Sub Suite 01 は、All sprints テスト計画に定義されている Suite 01 のサブテスト スイートです。

tcm suites /list /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber" 

Id        Name
------***----------------------------------------------------------------
67        Sprint 1
68        Sprint 1 -> 33 : Change initial view
69        Sprint 1 -> 34 : Welcome back page
70        Sprint 1 -> 43 : Cancel order form
73        All sprints
74        All sprints -> Suite 01
75        All sprints -> Suite 01 -> Sub Suite 01
78        Sprint 2
87        Hello World Test

TCM コマンドライン ツールを使用して、テスト計画を同じプロジェクトまたは別のプロジェクト内に複製したり、複製操作の状態を追跡したりすることができます。

テスト計画を一覧表示する | テスト計画を複製する | テスト計画の複製の状態を追跡する

テスト計画を複製する

tcm plans /clone を使用して、1 つのテスト スイートのすべてのテスト ケースを同じプロジェクト内の別の宛先スイートに複製する操作を開始します。 宛先のスイートは、別の計画に定義されて存在している必要があります。 含まれているスイートとテスト ケースはすべて複製されます。 このコマンドは、複製操作の状態と完了の追跡に使用できる操作 ID を返す場合があります。 複製操作がすぐに完了したとき、操作 ID は返されません。

tcm plans /clone /sourceplanid:id /destinationplanname:name
          [/overridefield:name=value [/overridefield:name=value ...]]
          [/sourcesuiteids:suiteid1,[suiteid2,...]]
          /collection:teamprojectcollectionurl /teamproject:project
          [/login:username,[password]]
          [/clonerequirements]
          [/clonechildren]

/clone /sourceplanid /destinationplanname によって新しい計画が作成されます。 /sourcesuiteids を指定すると、テスト ケースを新しい計画に複製する複製操作がコマンドによって開始されます。 このコマンドは、複製操作の状態と完了の追跡に使用できる操作 ID を返します。

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

例

次の例では、テスト計画 66 が、Test plan, Release 3 というタイトルの新しいテスト計画に複製され、ID 118 が割り当てられます。

tcm plans /clone /sourceplanid:66 /destinationplanname:"Test plan, Release 3" /overridefield:"Iteration Path"="Fabrikam Fiber\Release 3" /overridefield:"Area Path"="Fabrikam Fiber\Web" /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber"
Plan created with ID: 118

Clone operation is complete.

テスト計画の複製操作の状態を追跡する

tcm plans /clone /status を使用して、tcm suites /clone で行われた複製操作の状態を取得します。 多数のテスト ケースを含むテスト スイートは、複製にかなりの時間がかかる場合があります。

tcm plans /clone
           /status:cloneoperationid
           /collection:teamprojectcollectionurl /teamproject:project
           [/login:username,[password]]

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

TCM コマンドライン ツールを使用して、テスト計画を同じプロジェクトまたは別のプロジェクト内に複製したり、複製操作の状態を追跡したりすることができます。

テスト スイートを一覧表示する | テスト スイートを複製する | テスト スイートの複製の状態を追跡する

テスト スイートを複製する

tcm suites /clone を使用すると、既定で、1 つのテスト スイートのすべてのテスト ケースを同じプロジェクト内の別の宛先スイートに複製する操作が開始します。 宛先のスイートは、別の計画に定義されて存在している必要があります。 含まれているスイートとテスト ケースはすべて複製されます。 このコマンドは、複製操作の状態と完了の追跡に使用できる操作 ID を返します。

次のオプションは、オプションの複製操作をサポートします。

• /destinationteamproject: スイートを別のプロジェクトに複製します。
• /destinationworkitemtype: テスト ケースを複製するときに使用する作業項目の種類を指定します。 作業項目の種類をカスタムとしてテスト ケースを複製する場合は、このオプションを指定します。
• /overridefield: [区分パス] や [イテレーション パス] フィールドなど、選択したフィールドの値をオーバーライドします。これは、異なるプロジェクトに複製するときに必要です。 または、他のフィールドの値をオーバーライドして、複製したテスト ケースと元のテスト ケースを区別します。
• /clonerequirements: このスイッチを指定すると、要件ベースのスイートが、宛先の要件ベースのスイートとして複製されます。

tcm suites /clone
           /suiteid:id /destinationsuiteid:id
           [/overridefield:name=value [/overridefield:name=value ...]]
           [/destinationteamproject:projectname]
           [/destinationworkitemtype:workitemtype]
           /collection:teamprojectcollectionurl /teamproject:project
           [/login:username,[password]] [/clonerequirements]

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

複製する内容を理解する

テスト スイートを複製すると、次のオブジェクトがソース テスト計画から宛先テスト計画にコピーされます。

次のテスト情報はコピーされません。

• テスト設定: ソース テスト計画のテスト設定はコピーされません。 代わりに、宛先テスト計画のテスト設定が適用されます。
• テスト結果とテストの実行: テスト結果はコピーされません。 テストの実行はソース テスト計画にのみ適用されるため、コピーされません。

/clonerequirements を指定して、要件ベースのテスト スイートをコピーする場合:

• 要件ベースのテスト スイートがコピーされ、要件作業項目の新しいコピーにリンクされます。
• 複製対象の要件ベースのスイートに含まれる要件作業項目 (プロダクト バックログ項目またはユーザー ストーリー) が複製されます。
• スクラム プロセス テンプレートを使用するプロジェクト、またはバグ作業項目の種類が要件作業項目カテゴリにあるすべてのプロジェクトでは、バグ作業項目が複製されます。 それ以外の場合、バグは複製されません。

/clonerequirements を指定せずに、要件ベースのテスト スイートをコピーした場合:

• 要件ベースのテスト スイートは、宛先テスト計画内で静的テスト スイートに変換されます。
• 複製したテスト ケースは、静的テスト スイートの下で参照されます。
• 複製したテスト ケースには、元の要件作業項目へのリンクは含まれません。

例

次の例は、Fabrikam Fiber プロジェクトに定義されているテスト スイート 97 の Fabrikam Git プロジェクトへの複製を示します。 このテスト スイートにはクエリベースのスイートが含まれているため、ソース テスト スイートと宛先テスト スイートのそれぞれのクエリを確認して修正するように、警告メッセージが表示されます。

tcm suites /clone /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber" /destinationteamproject:"Fabrikam Git" /suiteid:97 /destinationsuiteid:104 /overridefield:"Iteration Path"="Fabrikam Git" /overridefield:"Area Path"="Fabrikam Git"

Started clone operation with id 4.
Use /status:4 to get progress and completion information of the operation.
Warning: You have cloned the following query based suites as part of this clone operation. You are advised to fix their respective queries in the source and destination suites, after the clone operation completes.
1. Sprint 3 -> Sprint 3 query-based suite

テスト スイートの複製操作の状態を追跡する

tcm suites /clone /status を使用して、tcm suites /clone で行われた複製操作の状態を取得します。 多数のテスト ケースを含むテスト スイートは、複製にかなりの時間がかかる場合があります。

tcm suites /clone
           /status:cloneoperationid
           /collection:teamprojectcollectionurl /teamproject:project
           [/login:username,[password]]

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

例

tcm suites /clone /status:4 /collection:https://dev.azure.com/fabrikamprime /teamproject:"Fabrikam Fiber"

Clone operation 4 has succeeded. Summary information:
Started on:           10-Nov-21 5:00:28 PM
Started by:           Jamal Hartnett
Source suite id:      97
Destination suite id: 114
Test cases cloned:    9
Shared steps cloned:  0
Requirements cloned:  0
Completed on:         10-Nov-21 5:00:30 PM