通过

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

  • 项目

更新：2007 年 11 月

转换器配置文件是一个 XML 文件，它提供 ClearQuest 转换器的设置。这些设置在 XML 文件的各个节中指定，如下所示：

<ClearQuest>

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

  • ConnectionName   ClearQuest 连接名称。

  • UserDatabase   ClearQuest 数据库名称。

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

  • UserID   ClearQuest 用户 ID。指定的用户 ID 对于 ClearQuest 数据库必须有“超级用户”权限。

<VSTS>

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

  • URI   Team Foundation Server 的友好名称或采用 http://MyServer:MyPort 格式的完整 URI。

    如果使用友好名称，请确保在运行转换器之前已通过 团队资源管理器 添加了 Team Foundation Server。

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

其他配置设置

XML 文件的其他各节允许您控制：

  • ExitOnError   此节接受 True 值或 False 值。选择 True 可在出错时退出。True 值表示如果在迁移某些工作项时遇到错误，ClearQuest 转换器将停止。

    说明：

    此设置仅适用于非错误。对于错误，例如 ClearQuest 转换器无法连接到 ClearQuest，则即使该设置为 False，转换器也始终会退出。

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

必需的权限

若要执行此过程，您必须对 ClearQuest 数据库有“活动用户”和“公共文件夹管理员”权限。有关更多信息，请参见 ClearQuest Administrator's Guide（《ClearQuest 管理员指南》）。

创建配置文件

  1. 收集以下信息：

    • ClearQuest 连接名称。

    • ClearQuest 数据库名称。

    • ClearQuest 管理员用户 ID 和密码。请确保此用户具有在 ClearQuest 中提交问题的权限。

    • Team Foundation 服务器名称。

    • Team Foundation 工作项跟踪 团队项目名称（要向其中迁移工作项的团队项目）。

  2. 在 ClearQuest 中创建一个查询，用于选择要迁移到 Team Foundation 工作项跟踪 的工作项，然后保存该查询。以任意名称保存该查询，例如“TransitionQuery”。

  3. 选择一个目录来存储分析阶段生成的文件。

  4. 将下面的 XML 配置文件复制到文本编辑器中：

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

  5. 使用在前面的步骤中收集的信息更改该文件以指定您的设置。例如，在“<QueryName>”下，将查询名称指定为包含查询路径的“TransitionQuery”。有关每一节应包含的内容的信息，请参见本主题前面的“配置文件”部分。

    说明：

    密码不在该文件中输入，稍后在迁移过程中，ClearQuest 转换器工具将提示输入密码。

  6. 保存该文件，例如可另存为“CqConverterConfig.xml”。

说明：

使用 UTF-8 编码保存文件。例如，如果使用“记事本”保存文件，则应在“另存为”对话框上的“编码”框中选择“UTF-8”。

请参见

其他资源

工作项类型定义架构