テスト管理をサポートするようにテストプロジェクトを手動で更新する

[アーティクル]
06/09/2015

既存の内部設置型配置を Team Foundation Server (TFS) 2013.3 にアップグレードすると、テスト計画とテストスイートをカスタマイズできるようになります。それはこれらのオブジェクトが作業項目の種類 (WIT) として再モデル化されるからです。

この変換を実現するために、TFS アップグレードウィザードは、アプリケーション層のすべてのコレクションに対して定義されたチームプロジェクトを自動的に更新し、既存のテストデータおよびオブジェクトを移行します。内部では次の 2 つの処理が実行されます。

テスト計画とテストスイートの WIT 定義をインポートし、チームプロジェクトのカテゴリ定義を更新して、テスト計画カテゴリとテストスイートカテゴリを含めます。
既存のテスト管理データを移行します。作業項目は既存のテスト計画とテストスイートから作成され、他の既存のテスト成果物 (テストポイント、テストの実行、およびテスト結果など) の相互間のリンクは作業項目ベースのテスト計画とテストスイートを参照するように固定されます。

データの移行は WIT 定義および更新の正常なインポートに依存します。最初の処理が失敗すると 2 番目の処理は発生しません。前の処理が失敗した場合、ウィザードは 1 つ以上の警告またはエラーをログ出力します。

テスト管理のエラーを表示する TFS アップグレードウィザード

この場合、チームプロジェクトを手動で更新する必要があります。手動更新を実行するまで、既存のテスト計画とテストスイートにはアクセスできなくなります。

エラーは、チームプロジェクトに Test Plan または Test Suite というラベルが付いた WIT が既に含まれている場合や、TFS 2005 および 2008 からアップグレードし、テスト管理をサポートするために必要な作業追跡オブジェクトを追加していない場合に発生する可能性があります。「MSF v4.2 プロセステンプレートに基づくチームプロジェクトの更新」を参照してください。

TFS 2013.3 テストエクスペリエンスをサポートするためにチームプロジェクトを手動で更新する

テスト計画およびテストスイート WIT 定義をインポートします。
1. 管理アクセス許可がない場合は、アクセス許可の設定を依頼してください。すべての更新ステップを実行するには、[Team Foundation 管理者] セキュリティグループのメンバーで、アプリケーション層サーバーの管理者である必要があります。
2. プロセステンプレートの最新バージョンのダウンロードを実行します。
3. Visual Studio またはチームエクスプローラーがインストールされている環境でコマンドプロンプトウィンドウを開き、次のように入力します。
```
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
```
  32 ビット版の Windows で、%programfiles(x86)% を %programfiles% に置き換えます。チームエクスプローラーは無料でダウンロードできます。
4. テスト計画およびテストスイート WIT 定義をインポートします。ダウンロードしたプロセステンプレートを含む WorkItem Tracking/TypeDefinitions フォルダーへの DirectoryPath を指定します。
```
witadmin importwitd /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath\TestPlan.xml"
witadmin importwitd /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath\TestSuite.xml"
```
  たとえば、CollectionURL は「http://MyServer:8080/tfs/DefaultCollection」となります。
  
  DirectoryPath は Drive:\TemplateFolder \WorkItem Tracking\TypeDefinitionsという構造である必要があります。次に例を示します。
  
  C:\Process Template\Microsoft Visual Studio Scrum 2013.3\WorkItem Tracking\TypeDefinitions

カテゴリ定義を更新します。

カテゴリ定義ファイルをエクスポートします。

witadmin exportcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\Categories.xml"

次のカテゴリを追加します。

<CATEGORY name="Test Plan Category" refname="Microsoft.TestPlanCategory">
    <DEFAULTWORKITEMTYPE name="Test Plan" />
  </CATEGORY>
  <CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
    <DEFAULTWORKITEMTYPE name="Test Suite" />
  </CATEGORY>

新しい WIT を隠しカテゴリに追加します。

<CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
    <WORKITEMTYPE name="Code Review Response" />
    <WORKITEMTYPE name="Feedback Request" />
    <WORKITEMTYPE name="Feedback Response" />
    <WORKITEMTYPE name="Shared Steps" />
    <WORKITEMTYPE name="Shared Parameter" />
    <WORKITEMTYPE name="Test Plan" />
    <WORKITEMTYPE name="Test Suite" />
  </CATEGORY>

更新ファイルをインポートします。

witadmin importcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\Categories.xml"

既存のテスト計画およびスイートを作業項目ベースのテスト計画およびスイートに移行します。

次の操作を実行して、TFS アプリケーション層サーバーでコマンドプロンプトウィンドウを開きます。
```
cd %programfiles%\Microsoft Team Foundation Server 12.0\Tools
```

TfsConfig TCM コマンドを実行します。

TFSConfig TCM /upgradeTestPlans /CollectionName:CollectionName /TeamProject:TeamProjectName

次に例を示します。

TFSConfig TCM /upgradeTestPlans /CollectionName:"Fabrikam Fiber Collection" /TeamProject:"Fabrikam Fiber"

表示される質問に応答します。

Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TPC_UPG_AT_0515_143821.log
Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.
 
Command: tcm
Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.
 
In order to upgrade the test plans, you have to complete the following steps:
1. Import the test plan work item definition into the project. Have you complete
d this step? (Yes/No) Yes
2. Import the test plan category into the project. Have you completed this step?
(Yes/No) Yes

Test plan migration job successfully scheduled.

大量のテスト計画およびテストスイートを移行する場合、次のコマンドを実行して、データ移行の進捗を監視できます。
```
TFSConfig TCM /upgradeStatus /collectionName:CollectionName /TeamProject:TeamProjectName
```

データ移行が正常終了すると、すべてのテスト管理データは使用できるようになります。このユーティリティの詳細については、こちらを参照してください。

テストマネージャーまたは Team Web Access で、新しい WIT ベースのテスト計画およびテストスイートにアクセスする方法の詳細については、「手動テストの計画」を参照してください。

次の方法で共有

TFS 2013.3 テストエクスペリエンスをサポートするためにチームプロジェクトを手動で更新する

その他のリソース

次の方法で共有

TFS 2013.3 テスト エクスペリエンスをサポートするためにチーム プロジェクトを手動で更新する

その他のリソース

TFS 2013.3 テストエクスペリエンスをサポートするためにチームプロジェクトを手動で更新する