Update a team project manually to support test management

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

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

1. テスト計画とテスト スイートの WIT 定義をインポートし、チーム プロジェクトのカテゴリ定義を更新して、テスト計画カテゴリとテスト スイート カテゴリを含めます。

2. 既存のテスト管理データを移行します。 作業項目は既存のテスト計画とテスト スイートから作成され、他の既存のテスト成果物 (テスト ポイント、テストの実行、およびテスト結果など) の相互間のリンクは作業項目ベースのテスト計画とテスト スイートを参照するように固定されます。

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

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

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

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

1. テスト計画およびテスト スイート 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

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

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

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

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

      <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>
      

   3. 新しい 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>
      

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

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

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

   1. 次の操作を実行して、TFS アプリケーション層サーバーでコマンド プロンプト ウィンドウを開きます。

      cd %programfiles%\Microsoft Team Foundation Server 12.0\Tools
      

   2. 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.
      

   3. 大量のテスト計画およびテスト スイートを移行する場合、次のコマンドを実行して、データ移行の進捗を監視できます。

      TFSConfig TCM /upgradeStatus /collectionName:CollectionName /TeamProject:TeamProjectName
      

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

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