工作项转换器配置文件

  • 项目

更新：2007 年 11 月

工作项配置文件是一个 XML 文件，它提供 ClearQuest 转换器的设置。本主题的后面部分将描述该文件的各节，后跟一个示例配置文件，可用它来创建自己的配置文件。

配置文件的节

工作项转换器配置 XML 文件包含几个节，这些节指定工作项如何从 ClearQuest 迁移到 Team Foundation。本主题后面的部分将对这些节进行详细介绍。

<ClearQuest>

ClearQuest 节包含有关您要迁移的 ClearQuest 数据库的信息。

  • ConnectionName   ClearQuest 连接名称。

  • UserDatabase   ClearQuest 用户数据库名称。

  • QueryName   保存在 ClearQuest 中的查询的名称。

  • UserID   ClearQuest 用户 ID。必须使用“admin”用户 ID。该用户应具有创建所有工作项类型的权限。

<VSTS>

VSTS 节包含有关您将迁移到的 Team Foundation 工作项跟踪 服务器和团队项目的信息。

  • URI   Team Foundation Server 友好名称或完整 URI。例如，“MyAtServer”或“http://MyAtServer:8080”。

  • ProjectName   Team Foundation 工作项跟踪 团队项目名称。

其他配置设置

XML 文件的其他节让您控制

  • ExitOnError   此节接受 true 或 false 值。选择 True 可在出错时退出。这意味着如果在迁移某些工作项时发现错误，ClearQuest 转换器将停止。

    说明：

    此设置仅适用于非错误。对于严重错误，如 ClearQuest 转换器无法连接 ClearQuest，转换器将总是退出，即使此设置为 False。

  • OutputDirectory   指定您想将生成的文件保存到哪个目录。如果不指定输出目录，则转换器将以基本实体 (Base Entity) 名称创建目录以用于生成输出文件。如果目录已存在，则转换器将覆盖该目录中的文件。

工作项转换器配置文件示例

以下是一个工作项转换器配置文件示例，它使用 All Defects Query，通过 CQRep 连接将 ClearQuest TEST 数据库迁移到 Team Foundation 中的 JoseLugoProjectX 团队项目。它还指定转换器应在发生任何错误时停止，并指定转换器所创建的输出文件的目录。

<?xml version="1.0" encoding="utf-8"?>
<WorkItemConverter>
  <Source id="ClearQuest">
    <ClearQuest>
      <ConnectionName>CQRep</ConnectionName> 
      <UserDatabase>TEST</UserDatabase> 
      <QueryName>Public Queries/All Defects</QueryName> 
      <UserID>admin</UserID>
    </ClearQuest>
  </Source>
  <VSTS>
    <URI>JoseLugo</URI>
    <ProjectName>JoseLugoProjectX</ProjectName> 
  </VSTS>
  <ExitOnError>true</ExitOnError>
  <OutputDirectory>DefectSchema</OutputDirectory>
</WorkItemConverter>

请参见

任务

如何：生成转换器配置文件

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

其他资源

工作项类型定义架构