手动更新团队项目以支持测试管理

项目
06/09/2015

将现有本地部署升级到 Team Foundation Server (TFS) 2013.3 时，你可以自定义测试计划和测试套件，因为这些对象现在重新建模为工作项类型 (WIT)。

为了完成此转换，TFS 升级向导自动更新为应用程序层上的所有集合定义的团队项目，并且迁移现有测试数据和对象。在后台，它执行两项活动：

为测试计划和测试套件导入 WIT 定义，并更新团队项目的类别定义以包括测试计划和测试套件类别。
迁移现有测试管理数据。从现有测试计划和测试套件创建工作项，并修复其他现有测试项目（例如测试点、测试运行和测试结果）之间的链接以指向基于工作项的测试计划和测试套件。

数据迁移取决于 WIT 定义和更新的成功导入。如果第一个活动失败，将不会发生第二个活动。在任一活动未成功的情况下，向导将记录一个或多个警告或错误。

显示测试管理错误的 TFS 升级向导

发生这种情况时，你将需要手动更新团队项目。你将无法访问现有测试计划和测试套件，直到你执行手动更新。

如果团队项目已包含 WIT 标记的测试计划和测试套件，或者你已从 TFS 2005 和 2008 升级并且未添加必要的工作跟踪对象以支持测试管理，则可能发生错误。请参阅根据 MSF v4.2 过程模板更新团队项目。

手动更新团队项目以支持 TFS 2013.3 测试体验

导入测试计划和测试套件 WIT 定义。
1. 如果不具备管理权限，则请获取管理权限。若要执行所有更新步骤，你需要是**“Team Foundation Administrators”**安全组的成员，而且是应用程序层服务器上的管理员。
2. 下载最新版过程模板。
3. 打开已安装 Visual Studio 或团队资源管理器的命令提示符窗口，然后输入：
```
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
```
  在 32 位版本的 Windows 上，将 %programfiles(x86)% 替换为 %programfiles%。你可以免费下载团队资源管理器。
4. 导入测试计划和测试套件 WIT 定义。将 DirectoryPath 指定为包含你下载的过程模板的 WorkItem Tracking/TypeDefinitions 文件夹。
```
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
```

成功进行数据迁移后，所有测试管理数据应该可用。有关此实用工具的详细信息，请转至此处。

有关如何访问 Test Manager 或 Team 测试管理器中新的基于 WIT 测试计划和测试套件的信息，请参见计划手册测试。

手动更新团队项目以支持 TFS 2013.3 测试体验

其他资源