WebSphere Application ServerRational ClearQuest 适配器的任务

您可以使 IBM® Rational® ClearQuest® 共享库可供 IBM Rational Publishing Engine 数据服务应用程序使用,以便可以从 Rational Publishing Engine 使用 Rational ClearQuest API。

开始之前

  • 必须在应用程序服务器所在的同一台计算机上安装 Rational ClearQuest
  • 部署 Rational Publishing Engine 数据服务应用程序报告数据服务适配器
  • 更正任何防火墙警告或许可问题,然后再配置 Rational ClearQuest 共享库。

过程

  1. Rational ClearQuest 安装中共享库的路径添加到在其中部署 Rational Publishing Engine 数据服务应用程序WebSphere Application Server 节点:
    1. WebSphere Application Server 中,单击环境 > 共享库
    2. 要指定作用域设置,请选择 Node=RationalPublishingEngineNode01, Server=RationalPublishingEngineServer 条目。 RationalPublishingEngineNode01 是节点的缺省名称,而 RationalPublishingEngineServer 是服务器的缺省名称。
    3. 要创建共享库参考,请单击新建
    4. 设置名称描述类路径的值。确保类路径所引用的文件位于正确的位置。
      表 1. 共享库引用字段
      描述
      名称 ClearQuest CM API
      描述 The shared library for the ClearQuest adapter.
      类路径

      application_files\IBM\RationalSDLC\ClearQuest\cqjni.jar
      application_files\IBM\RationalSDLC\ClearQuest\stpcq.jar
      application_files\IBM\RationalSDLC\Common\stpcmmn.jar
      application_files\IBM\RationalSDLC\Common\stpwvcm.jar

      注: 列出的缺省值适用于 Rational ClearQuest 7.1。要使用的实际路径取决于 Rational ClearQuest 的安装位置和版本。确保所引用的文件位于其正确位置。要查看 Rational ClearQuest 的安装位置,请单击开始 > 所有程序 > IBM Installation Manager > 查看已安装的软件包以在 IBM Installation Manager 中检查。
    5. 单击确定,然后单击保存
  2. Rational ClearQuest 共享库与数据服务应用程序概要文件相关联:
    1. 单击服务器 > 应用程序服务器
    2. 单击在其中部署数据服务应用程序的服务器。 缺省服务器名称为 RationalPublishingEngineServer
    3. 单击服务器基础结构 > Java 和进程管理 > 类装入器
    4. 要为共享库创建类装入器,请单击新建 > 确定
    5. 要使共享库引用与类装入器相关联,请单击在子步骤 2.d 中创建的新类装入器的超链接。
    6. 对于每个要建立关联的库,请单击添加,选择库,然后单击确定
    7. 单击共享库引用
    8. 要与每个库建立关联,请单击添加,选择库,然后单击确定
    9. 单击保存
  3. Linux 图标 如果使用的是 Linux,请配置通用 JVM 参数:
    1. 单击服务器 > 服务器类型 > WebSphere Application Servier
    2. 单击服务器名称。
    3. 在“服务器基础结构”部分中,展开 Java 和进程管理,然后单击进程定义
    4. 单击 Java 虚拟机
    5. 在“通用 JVM 参数”字段中,输入:Generic JVM arguments -Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib
    6. 单击确定
  4. Linux 图标 如果使用的是 Linux,请配置 LD_LIBRARY_PATH 环境变量:
    1. 在“进程定义”页面中,单击环境条目,然后单击 LD_LIBRARY_PATH
    2. 输入名称和库路径。 示例:/opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
  5. 重新启动数据服务应用程序
  6. 验证是否正确配置了 IBM Rational ClearQuest 适配器和库。 在浏览器中输入 Rational ClearQuest 适配器的 URL。
    • 输入 http://host:port/DataServices/ClearQuest。 如果安装正确,那么您将看到一列 Rational ClearQuest 连接显示在 Rational ClearQuest Maintenance Tool 中。
    • 输入 http://host:port/DataServices/ClearQuest/version。 如果安装正确,那么您将看到一列 Rational ClearQuest 用户数据库。
    • 输入 http://host:port/DataServices/ClearQuest/version/database_name。 如果安装正确,那么您将看到一列查询。

下一步做什么

复制查询 URL 以添加到模板或文档规范。
注: 数据服务应用程序仅支持具有静态结果集的查询。动态查询不受支持。

示例

通过所有缺陷查询的 URL,您将看到一个结果集,该结果集含有该查询将针对 Rational ClearQuest 客户机返回的命中数。 对于特定的记录类型,每一个结果都是一个唯一的 DBID。您可以继续此过程,直到获取返回特定记录的数据为止。保留查询 URL 以在 Rational Publishing Engine 报告编写中使用。

除去参数(包括问号以及问号后面的内容):

之前:http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects?Type=Query
之后:http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects


反馈