配置 Crystal Reports「Java 報告元件 (JRC)」執行時期

若要使用 ClearQuest Report Server for Crystal Reports 來產生 ClearQuest 報告,請在 WebSphere Application Server 上安裝及配置 Crystal Reports「Java 報告元件 (JRC)」的支援版本。

開始之前

如果您已安裝「Java 報告元件」執行時期,請在執行這些配置步驟之前移除現有版本。請參閱移除 Crystal Reports JRC 執行時期

關於這項作業

如需 Crystal Reports「Java 報告元件 (JRC)」執行時期版本的 ClearQuest 支援版本及其下載位置的相關資訊,請參閱技術文件 1216371

這些指示包括此變數的參照:

%CLEARQUEST_HOME%\cqweb\cqwebprofile
在 Windows 上,此變數表示部署 ClearQuest Web 應用程式的 WebSphere 設定檔目錄的預設路徑。CLEARQUEST_HOME 是 ClearQuest 的安裝目錄。
$CLEARQUEST_HOME/cqweb/cqwebprofile/
在 Linux 及 UNIX 上,此變數表示部署 ClearQuest Web 應用程式的 WebSphere 設定檔目錄的預設路徑。CLEARQUEST_HOME 是 ClearQuest 的安裝目錄。
註: 在這些指示中,JRC 執行時期的安裝目錄是根據 ClearQuest 要安裝在新的 WebSphere 設定檔中的這個預設位置而定:
cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
如果 ClearQuest 已安裝在現有 WebSphere Application 設定檔中,此路徑可能不同,在複製 JRC 檔案之前必須更新該指示中的路徑。另一個要檢查的一般位置是這個目錄:
/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war.
如果 ClearQuest 是在 Solaris 平台上管理,則預設 WebSphere Application Server Cell 目錄是 <srv>Node01CelldfltCell 值是 Windows、Unix 及 Linux 平台的預設值。

程序

  1. 下載符合 ClearQuest 報告需求的 Crystal Reports「Java 報告元件 (JRC)」保存檔。 請參閱技術文件 1216371
  2. 將 Crystal Reports JRC 複製到 Web 應用程式。
    在 Windows 上
    執行此批次檔,將 JRC 複製到 Web 應用程式。

    如果您是使用 Crystal Reports JRC 11.8.x 版,請執行 configureJRC.bat。若為 JRC 12.2.x 版,請執行 configureJRC12.bat

    1. 從命令提示字元,移至已安裝 ClearQuest 批次檔的目錄:
      cd %CLEARQUEST_HOME%\cqweb\cqwebprofile\installedApps\dfltCell\RationalClearQuestWebReport.ear\CQWebReportModule.war
    2. 將 Crystal Reports JRC 執行時期保存檔複製到此目錄。
    3. 視您所部署的執行時期版本而定,來執行下列其中一項指令。
      configureJRC JRC_runtime_file.zip
      configureJRC12 JRC_runtime_file.zip
    在 Unix 上
    如果您是使用 Crystal Reports JRC 11.8.x 版,請執行 Shell Script configureJRC.sh。如果您是使用 Crystal Reports JRC 12.2.x 版,請執行 configureJRC12.sh Script。
    1. 開啟 UNIX 主控台視窗,並移至已安裝 ClearQuest Shell Script 的目錄。
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/installedApps/dfltCell/RationalClearQuestWebReport.ear/CQWebReport.war
    2. 將 Crystal Reports JRC 執行時期保存檔複製到此目錄。
    3. 設定您要執行的 Script 版本的權限:
      chmod u+x ./configureJRC.sh chmod u+x ./configureJRC12.sh
    4. 對您所複製的 JRC 版本執行下列指令:
      ./configureJRC.sh JRC_runtime_file.zip ./configureJRC12.sh JRC_runtime_file.zip
  3. 停止並重新啟動 IBM WebSphere Application Server,以讓變更生效。
    註: 如果 ClearQuest 已安裝到現有 WebSphere 設定檔,則這些指示中的目錄可能不同。
    在 Windows 上:
    1. 按一下開始 > 控制台 > 系統管理工具 > 服務
    2. 在「服務」窗格中,用滑鼠右鍵按一下 IBM WebSphere Application Server 7.0 版 - %CLEARQUEST_HOME%\cqweb\cqwebprofile。
    3. 按一下停止
    4. 服務停止之後,用滑鼠右鍵按一下伺服器名稱,然後按一下啟動,以重新啟動伺服器。
    在 UNIX 系統及 Linux 上:
    1. 從 UNIX 主控台視窗,移至已安裝 ClearQuest 伺服器元件的 WebSphere 設定檔的 bin 目錄。
      註: 如果 ClearQuest 已安裝到現有 WebSphere 設定檔,則這些指示中的目錄可能不同。
      cd $CLEARQUEST_HOME/cqweb/cqwebprofile/bin
    2. 執行下列指令,以停止及啟動預設設定檔:
      ./stopServer.sh server1 ./startServer.sh server1
  4. 若要驗證 ClearQuest Report Server for Crystal Reports 已正確配置,請開啟瀏覽器視窗,並移至這個 URL:http://localhost:<port>/cqwebreport/CRInvoker 其中 <port> 是設定檔中定義的埠,用來部署應用程式。預設 ClearQuest 設定檔使用埠 12080。預設 WebSphere Application Server 設定檔使用埠 9080
    如果伺服器已正確配置,則會顯示此訊息。
    The report document has expired.
  5. 在下列狀況下需要其他配置步驟:
    • ClearQuest 綱目中的資料庫欄位名稱已變更。
    • ClearQuest 顯示欄位名稱不符合資料庫欄位名稱。
    • ClearQuest 顯示欄位名稱超過 30 個字元。
    請參閱技術文件 1419660

意見