如何：迁移工作项

更新：2007 年 11 月

分析阶段结束后，转换器会为每个 ClearQuest 记录类型生成工作项类型定义 (WITD)。例如，ClearQuest Defect 记录类型的文件名为 Defect.xml。在分析阶段，作为架构生成的一部分，转换器会生成一个默认的工作项窗体。但是，此默认窗体包含的格式设置很少，一般都需要按您所希望的工作项布局进行编辑。有关如何更改工作项类型定义文件的信息，请参见自定义 Team Foundation 的工作项类型。

编辑工作项布局后，就可以将工作项从 ClearQuest 迁移到 Team Foundation 工作项跟踪 了。

必需的权限

若要执行这些过程，您必须是“Service Accounts”安全组的成员。有关更多信息，请参见 Team Foundation Server 权限。您还必须具有 ClearQuest 数据库的“超级用户”权限。有关更多信息，请参见 ClearQuest Administrator's Guide（《ClearQuest 管理员指南》）。

迁移 ClearQuest 工作项

迁移工作项

1. 在命令提示符下，运行下列命令：

   **CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:**路径\Schemamap.xml

   其中“路径”是架构映射文件的路径。架构映射文件是在分析阶段在指定输出目录中生成的。

   说明：
   对于大型数据库，ClearQuest 转换器可能需要运行几个小时。

2. 迁移结束后，请查看迁移报告以了解迁移状态以及其他问题（如果有）；例如由于某些字段映射不一致而未进行迁移的缺陷。

   迁移报告名为 CQMigrationReport.xml，是在运行 ClearQuest 转换器的文件夹中创建的。

   说明：
   由于转换器转换指定查询中包含的所有工作项以及这些工作项所链接到的所有工作项，因此被迁移的实际工作项数可能与查询中工作项数不同。

3. 如果所有工作项未全部迁移，则可以在解决迁移报告中所列出的问题之后再次运行转换。

若要将更多工作项从 ClearQuest 迁移到 Team Foundation 工作项跟踪，可再次运行迁移过程。

对同一个 ClearQuest 数据库再次运行迁移

1. 更正上一次迁移的迁移报告中列出的所有问题。

2. 在 ClearQuest 中生成一个返回所需工作项的查询，或者，如果您只需迁移第一次未迁移的工作项，则可以运行相同的查询。

3. 更改配置文件中的“<QueryName>”节以指定新的查询名称。

4. 打开命令提示窗口，然后键入迁移命令：

   **CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:**路径\Schemamap.xml

   对于大型数据库，ClearQuest 转换器可能需要运行几个小时。

   说明：
   有关 ClearQuest 转换器命令的更多信息，请参见 用于 ClearQuest 数据库迁移的 CQConverter 命令行实用工具。

5. 迁移结束后，请查看迁移报告以了解迁移状态。迁移报告名为 CQMigrationReport.xml，是在运行 ClearQuest 转换器的文件夹中创建的。

请参见

任务

演练：将 ClearQuest 工作项迁移到 Team Foundation

其他资源

迁移工作项后的工作

用于 ClearQuest 数据库迁移的 CQConverter 命令行实用工具