在 Apache Tomcat 上配置 Rational 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 ClearQuest 共用程式庫:

    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 中檢查。
  2. Rational ClearQuest 共用程式庫貼到 Apache Tomcat %CATALINA_HOME%\lib 目錄中。
  3. Linux 圖示 如果您使用 Linux,請配置通用 JVM 引數:
    1. 開啟用來啟動 Apache Tomcat 伺服器的檔案。 範例:%CATALINA_HOME%/bin/startup.sh
    2. 在檔案尾端新增下列指令:
      export JAVA_OPTS="-Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib"
  4. Linux 圖示 如果您使用 Linux,請配置 LD_LIBRARY_PATH 環境變數:
    1. 在用來啟動 Apache Tomcat 伺服器的檔案中,於檔案尾端新增下列指令:
      export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
    2. 儲存對用來啟動 Apache Tomcat 伺服器之檔案的變更。
  5. 重新啟動「報告資料服務」應用程式。
  6. 驗證 IBM Rational ClearQuest 配接器和程式庫配置正確。 在瀏覽器中輸入 Rational ClearQuest 配接器的 URL。
    • 輸入 http://host:port/DataServices/ClearQuest。如果安裝正確,您會看到 Rational ClearQuest 連線清單,這和「Rational ClearQuest 維護工具」中顯示的清單相同。
    • 輸入 http://host:port/DataServices/ClearQuest/version。如果安裝正確,您會看到 Rational ClearQuest 使用者資料庫清單。
    • 輸入 http://host:port/DataServices/ClearQuest/version/database_name。如果安裝正確,您會看到查詢清單。

下一步

複製查詢 URL,以新增至範本或文件規格中。
註: 「報告資料服務」應用程式只支援含有靜態結果集的查詢。不支援動態查詢。

範例

利用 All Defects 查詢的 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


意見