使用 Report Launcher for ClearQuest

使用 Report Launcher for ClearQuest®,來管理及執行以 BIRT 或 Crystal Reports 報告工具設計並儲存在共用檔案伺服器上的報告。授權使用者可以從 Report Launcher 導覽視窗選取報告,並在 Report Launcher 檢視視窗中檢視所產生的資料。

部署 Report Launcher for ClearQuest 之後,就可以從 Report Launcher for ClearQuest Web 介面使用它來執行和檢視報告。此介面的操作方式與下載網站相似。左窗格提供導覽來執行和檢視報告。右窗格包含可呈現所選取報告的報告檢視器。

表 1. Report Launcher for ClearQuest 使用者作業和指示
作業 指示
啟動 Report Launcher
在瀏覽器的位址列,以下列其中一種格式輸入 Report Launcher URL:
https://server_host:<port>/cqreportlauncher/reports http://server_host:<port>/cqreportlauncher/reports
其中
  • server_host 是安裝 Report Launcher for ClearQuest 伺服器的機器的主機名稱及網域。如需 server_host 位置的相關資訊,請聯絡您的管理者。
  • port 是設定檔中定義的埠,用來部署應用程式。預設 ClearQuest 設定檔使用埠 12443。預設 Websphere Application Server 設定檔使用埠 9443。

依預設,會顯示 Report Launcher for ClearQuest Web 介面。唯有已啟用用戶端安全且安全規則需要鑑別時,才會顯示登入畫面。

尋找報告 在 Report Launcher 的左窗格中,按一下資料夾名稱,往下探查至報告清單的目錄。

如果 Report Launcher 安裝包括深層巢狀子目錄,您也可以直接導覽至特定路徑,而不必往下探查至目標子目錄。例如,您可以輸入如下的路徑,直接移至 Defect_Reports 資料夾中的報告:

http://server_host:<port>/cqreportlauncher/reports/Department1/Defect_Reports
執行報告 當您按一下報告名稱時,Report Launcher for ClearQuest 會啟動報告伺服器上的報告,並在右側視窗中開啟報告檢視器。
儲存、列印、匯出報告 在 Report Launcher Web 介面中,會使用用來建立報告的報告工具的報告檢視器來顯示報告。例如,使用 Business Intelligence and Reporting Tools (BIRT) 建立的報告會顯示在 BIRT 報告檢視器中。報告檢視器工具列或功能表會提供報告作業,如儲存、列印及匯出可用的特性。這些特性是使用報告檢視器執行時期環境所提供的參數進行配置。如需如何自訂可用特性的範例,請參閱自訂 BIRT 報告檢視器
提供報告認證 按一下 Report Launcher for ClearQuest Web 介面中的設定認證鏈結,以指定啟動報告時儲存及通過的認證。儲存使用者認證時,使用者的名稱會顯示在頁面左上方。使用清除認證鏈結可移除已儲存的認證。
註: 如需報告安全的相關資訊,請參閱關於 ClearQuest 報告安全
檢視靜態內容 使用者可以從 Report Launcher Web 介面檢視報告檔案伺服器上的靜態內容。依預設,支援 PDF 及 HTML 格式。您可以提供功能來檢視其他檔案格式,作法是將檔案類型副檔名新增至 Report Launcher 配置檔 reportlauncher.propertiesreports.launcher.filereader.suffix 規格中。如需更新此檔案的相關資訊,請參閱配置 Report Launcher for ClearQuest
使用 PDF 建立報告 Snapshot 您可以從 Report Launcher for ClearQuest Web 介面的報告檢視器中匯出報告,再將它另存為 PDF 檔,來建立報告 Snapshot。
  1. 使用 Report Launcher for ClearQuest 執行報告及檢視報告。
  2. 在 Report Launcher for ClearQuest Web 介面的報告檢視器視窗中,按一下報告檢視器工具列中的「匯出」選項。
  3. 按一下報告檢視器工具列的匯出選項,將報告匯出成 PDF。
  4. 按一下儲存,將報告儲存至 Report Launcher 介面可見的檔案路徑。
使用範例報告 ClearQuest 提供一個可用於測試的範例報告集合。
Windows
\Program Files\IBM\RationalSDLC\clearquest\reports\driver\plugins\com.ibm.rational.clearquest.report.samples_version.timestamp.jar
Linux 及 UNIX:
/opt/rational/clearquest/reports/driver/plugins/com.ibm.rational.clearquest.report.samples_version.timestamp.jar
  1. 建立 ReportSamples 目錄。然後,將報告範例保存檔中的檔案解壓縮到這個目錄。
  2. 若要將報告範例發佈到 Report Launcher,請將 ReportSamples 目錄複製到 Report Launcher baseDirectory,或更新 reportlauncher.properties 檔案,以併入範例目錄。
  3. 如需報告範例的相關資訊,請參閱報告目錄 .\Crystal\CrystalSamples.html.\BIRT\BIRTSamples.html 中的 Readme 檔。
  4. 若要執行範例報告,請配置儲存庫和資料庫 7.0.0/SAMPL。部分報告需要匯入查詢。所需的查詢與範例一起放在 /Queries 子目錄中。將查詢匯入名稱為 Public Queries/Report Queries 的 ClearQuest 資料夾中。
註: 從 Report Launcher 同時啟動 BIRT 與 Crystal Reports 時,只有其中一種報告類型可以存取 "JNI" 資料來源。若要在相同伺服器上同時執行 BIRT 及 Crystal Reports,請更新 BIRT 資料來源,以使用 ClearQuest Web 伺服器連線。您可以使用 WordPad 來更新 BIRT 報告檔案庫 CQSamples.rptlibrary 中的資料來源定義。將 :jdbc:cq:7.0.0/SAMPL 變更為:jdbc:cq:7.0.0/SAMPL@http://mycqserver:12080/TeamWeb/services/Team

意見