您可以使用 Rational® Publishing Engine,根據納入了 Rational Reporting for Document
Generation 元件的產品和應用程式(例如:Collaborative Lifecycle Management 的 Rational 解決方案 應用程式)所提供的資料,來設計報告。然後您可以將這些範本匯入至產品或應用程式,以便在其介面中使用。
開始之前
在開始使用
Rational Publishing Engine 來自訂報告之前,必須利用可供您使用的有效授權,來設定授權金鑰伺服器。請聯絡您的管裡者,驗證已完成這件事,並且取得授權伺服器路徑。如果您尚未安裝
Rational Publishing Engine,您或您的管理者必須安裝它,然後驗證您可以連接到授權伺服器。
判斷整合產品(或「資料提供者」)隨附的 Rational Reporting for Document
Generation 版本。該版本會決定您在設計產品的報告範本時,必須使用的範本版本。請確定您熟悉新版 Rational Publishing Engine 與舊版 Rational Reporting for Document
Generation 之間的相容性限制。
程序
Rational Publishing Engine 可讓您編寫新的文件樣式報告範本。您可以設計範本,且這些範本收集了產品或應用程式中的資料,並會產生報告,如果該產品或應用程式含有 Rational Reporting for Document
Generation,您可以匯入這些範本,並在產品或應用程式的環境定義內,產生文件樣式的報告。
需要 Rational Publishing Engine 授權,才能編寫範本;不需要 Rational Publishing Engine 授權,就能匯入範本,並在含有 Rational Reporting for Document
Generation 的產品或應用程式的環境定義內,從這些範本來產生報告。
如果要透過
Rational Publishing Engine,使用產品或應用程式資料來建立報告,請完成下列步驟:
1:連接至 Rational Publishing Engine
如果您尚未安裝
Rational Publishing Engine,您或您的管理者必須先安裝它,然後再連接到授權伺服器。您可以使用
Rational Publishing Engine Document Studio,來匯入應用程式原始檔以及建置報告範本。您也可以使用
Rational Publishing Engine Launcher 來建置文件規格,它們會納入報告範本,並產生報告。
2:設計報告範本
重要: 您必須使用整合產品(或「資料提供者」)隨附之
Rational Reporting for Document
Generation 版本所支援的範本版本。如果要判斷所隨附的版本,請向產品的報告管理者洽詢。如需詳細資料,請參閱
版本相容性。
- 啟動 Rational Publishing Engine Document
Studio 來建置報告範本設計。
- 建立或匯入範本設計。
這個設計決定報告的佈置。
Rational Publishing Engine 隨附了一組範例報告與指導教學,可供您探索。
重要: 請更新「載入範本 API」中的範本版本號碼,使您使用的版本相容於資料提供者。如果您指定新的範本版本,並開啟了舊版範本,則會更新該範本的範本版本。
Rational Publishing Engine 資訊中心內的支援概念:
Rational Publishing Engine 資訊中心內的支援作業:
Meta 資料和匯入範本:
- 配置文件樣式報告的 meta 資料:將 meta 資料新增至 Rational Publishing Engine 範本,以便可將該範本匯入至其他產品中,並用來套用過濾器。
3:連接至應用程式資料來源
決定您要匯入的資料來源綱目。您可以使用綱目中的元素,將針對應用程式資料的查詢新增至範本。
這些查詢指定報告最後產生的資訊內容。
- 檢閱您要在報告中使用的可用資料綱目。每個產品都有唯一的綱目或綱目集。
- 建構指向資料來源綱目的 URL。
- 在 Document studio 中新增資料來源。
Rational Publishing Engine 資訊中心內的支援作業:
4:新增應用程式型資料查詢至範本
使用 Document Studio,將資料來源中的資料新增至現有的報告設計範本。您新增的資料查詢會決定在報告輸出的各個不同部分中要產生哪些資料。您必須在「資料來源綱目」視圖中選取資料點,並且依照階層式順序,將它們新增至範本。
Rational Publishing Engine 資訊中心內的支援概念:
Rational Publishing Engine 資訊中心內的支援作業:
5:建立文件規格
一旦建立報告範本並且移入應用程式資料點之後,您可以用各種不同的格式來產生報告。當您產生報告時,您必須連接至內含您要用來執行報告之資訊的資料來源。如果要這麼作,請指定指向內含相關資料的應用程式儲存庫的 URI。
您可以使用過濾器(這是一般資料來源 URI 較特定的版本),來指向特定資料子集,這樣在產生報告期間,Rational Publishing Engine 就不會嘗試從應用程式儲存庫擷取非必要的資訊。這些過濾器必須有足夠的寬容度,以便擷取範本參照的所有必要資料,否則產生的報告將會不完整。
- 指定要包含在報告中的範本。
- 指定輸出格式和位置。
- 決定資料來源 URI。您可以指向一般資料來源,這樣會擷取儲存庫內的所有相關資料,或者您可以選擇性地使用過濾器(它們是更特殊的 URI),藉由指定參數來從儲存庫擷取更小的資料集。
- 輸入資料來源 URI。
- 選用:輸入登入認證來存取指定的資料來源。如果要與其他使用者共用這個文件規格,您可以需要將認證欄位保持空白。
如果沒有指定認證,而使用者嘗試從文件規格來執行報告,就會提示他輸入認證。
如果指定認證,而使用者嘗試執行報告,就會使用已儲存的認證來存取儲存庫,即便這些認證並非該使用者的認證,也是如此。
Rational Publishing Engine 資訊中心內的支援概念:
6:產生報告
您可以從文件規格來產生報告。當您產生報告時,您必須連接至為報告提供資料的資料來源。如需使用
Rational Publishing Engine 來產生文件的相關資訊,請參閱定義文件規格,但不使用文件產生精靈。
7:匯入自訂文件樣式的報告
您可以將這份報告匯入到應用程式,之後使用者就可以利用 Web 介面中的「建立報告」精靈,來產生文件樣式的報告。如需匯入報告的相關資訊,請參閱您產品的資訊中心。