修改连接器服务参数

cqconnector.properties 文件包含参数设置,ClearQuest® 网关和 synctool 命令行实用程序将根据这些参数设置来运行。
关于此任务

ClearQuest 连接器安装向导根据您在该向导中选择的选项来更新 cqconnector.properties 文件。如果您打算将 ClearQuest 连接器部署在运行该向导的计算机上,那么不需要编辑 cqconnector.properties 文件。如果您打算将 ClearQuest 连接器部署到另一台计算机(例如运行 Linux® 的计算机)上,请将 cqconnector.properties 文件复制到该计算机,然后编辑该文件以确保参数中指定的所有计算机路径名均正确。

下表描述 ClearQuest 连接器参数。
表 1. ClearQuest 连接器参数
参数 描述
com.ibm.rational.interop.pollingPeriod 轮询周期,此周期控制 ClearQuest 网关执行轮询以查找 ClearQuest 用户数据库变更的频率。缺省轮询周期是 60 秒。
com.ibm.team.uris Jazz™ 服务器的统一资源标识(URI)。缺省 URI 是 https://cqconnector:cqconnector@localhost:9443/jazz。请使用分号(;)来分隔多个 Jazz 服务器的条目。您必须创建名为 cqconnector 的 Jazz 用户或者将 cqconnector 替换为另一个 Jazz 用户的名称。Jazz 用户(cqconnector 或另一名称)必须具有 Jazz ClearQuest 连接者或开发者许可证。如果使用 cqconnector 作为用户标识,那么务必将密码变更为除缺省值 cqconnector 以外的值。
cq.dbSetDbName ClearQuest 模式存储库和用户数据库。缺省模式存储库是 sample_schema_repo。缺省用户数据库是 SAMPL。格式为 schema-repository-connection-name/user-database-name
cq.orderedProperties.record-type 以逗号分隔的字段列表,此列表指示 ClearQuest 连接器在传出同步操作期间设置那些字段的值时应该遵循的顺序。您可以为每种具有同步规则的记录类型设置此参数。列表中未指定的字段将在列表中的那些字段之后处理。如果 ClearQuest 记录类型包含用于在字段之间建立依赖关系的挂钩,那么可能需要指定顺序。

另一种指定顺序的方法是,在 ClearQuest Designer 中使用表单定义中的字段的 Web 从属字段属性。如果同时指定“Web 从属字段”属性和 cq.orderedProperties 参数,那么 ClearQuest 连接器将使用 cq.orderedProperties 参数指定的顺序。

cq.password 用于登录到 ClearQuest 用户数据库的密码。ClearQuest 网关和导入工具使用此密码和 cq.userId 参数指定的用户名来登录到 ClearQuest 用户数据库以及检索要导入到 Jazz 存储库的记录。缺省值为 cqconnector。请务必将密码变更为除缺省值以外的值。
cq.userId 用于登录到 ClearQuest 用户数据库的用户名。ClearQuest 网关和导入工具使用此用户名和 cq.password 参数指定的密码来登录到 ClearQuest 用户数据库以及检索要导入到 Jazz 存储库的记录。缺省值为 cqconnector。此用户必须具有 SQL 编辑者许可权。
cq.queryTreeRoot 根文件夹的完整路径名,此文件夹包含特定于项目区域的查询文件夹,那些查询用于对要与 Rational Team Concert™ 项进行同步的记录进行过滤。对于每个项目区域,您可以对所同步的每种记录类型指定一个查询。您必须将查询编写成避免选择要与同一 Jazz Team Server 上的多个项目区域同步的 ClearQuest 记录。

根文件夹可以是“公用查询”或“个人查询”下的文件夹层次结构的任何一层,但其层次结构必须如下所示:root-folder/project-area-name-folder。查询必须直接存储在项目区域文件夹中。可以有多个项目区域文件夹。每个项目区域文件夹的名称都必须与 Jazz 存储库中的相应项目区域名称匹配。

您必须对此参数指定一个值。指定的根查询文件夹必须存在,并且,对于每个要使记录与工作项同步的项目区域,根文件夹都必须包含一个相应的文件夹。如果项目区域文件夹未包含用于某种具有同步规则的记录类型的查询,那么 ClearQuest 连接器将尝试对该记录类型的所有记录进行同步。

   

要修改参数,请执行下列操作:

  1. 转到 install-directory\gateway 文件夹。打开 cqconnector.properties 文件。
  2. 必要时修改参数值,以使它们与环境匹配。
    1. 编辑 com.ibm.team.uris 参数值,使其指向 Jazz 服务器的位置。缺省情况下,ClearQuest 网关将尝试以 cqconnector 用户身份登录到 Jazz 服务器。您必须创建名为 cqconnector 的 Jazz 用户或者将 cqconnector 替换为另一个 Jazz 用户的名称。Jazz 用户(cqconnector 或另一名称)必须具有 Rational Team Concert ClearQuest 连接器或开发者许可证。要指定另一个用户,请在主机名前面插入 user_name[:password]@。例如:https://chris:chris_pw@localhost:9443/jazz。请使用分号(;)来分隔多个 Jazz 服务器的条目。
    2. 编辑 cq.dbSetDbName 参数值,以指定模式存储库和用户数据库。
    3. 如果要变更缺省轮询周期(60 秒),请编辑 com.ibm.rational.interop.pollingPeriod 参数值。
    4. 要对所要同步的 ClearQuest 记录进行过滤,请为每种具有同步规则的记录类型创建查询。请将查询存储在根文件夹下特定于项目区域的文件夹中。请编辑 cq.queryTreeRoot 参数,以指定根文件夹的完整路径名。例如:“公用查询/Jazz CQ Connector”。即使您不想对记录进行过滤,也必须创建根文件夹,并且必须为每个要对记录和工作项进行同步的项目区域创建一个项目区域文件夹。
    5. 使用 cq.userId 和 cq.password 参数来指定用于登录到 ClearQuest 的用户名和密码。您使用 cq.userId 参数指定的用户必须具有 SQL 编辑者特权。
    6. 如果要进行同步的 ClearQuest 记录类型中的任何字段带有挂钩(用于与其他字段建立依赖关系),并且您未使用 ClearQuest 表单定义中的“Web 从属字段”属性来指定字段值的设置顺序,请设置 cq.orderedProperties.record-type 参数。与一个字段相关联的挂钩可以使用用户输入到该字段中的值来确定如何设置另一个字段的值。在这种情况下,您必须指定传出同步操作期间挂钩的执行顺序,以确保 ClearQuest 记录字段设置为正确的值。例如:cq.orderedProperties.Defect=Headline,Type,Product,Component。此示例指定应该先设置 “缺陷”记录类型中的 Headline 字段,然后设置 Type、Product 和 Component 字段。

      如果同时指定“Web 从属字段”属性和 cq.orderedProperties 参数,那么 ClearQuest 连接器将使用 cq.orderedProperties 参数指定的顺序。

    7. 关闭并保存 cqconnector.properties 文件。
下一步做什么
注: 由于 cqconnector.properties 文件包含 ClearQuest 和 Jazz 用户帐户的登录名和密码,因此请确保对该文件设置许可权以使其只能被授权用户读取。

反馈

本资料对您是否有帮助?您可以在 Jazz.net 上提供反馈(需要注册):在论坛中发表意见或者提交错误