設計範本並以
Rational RequisitePro
作為資料來源
報告設計者可以使用 Document Studio 來匯入資料來源綱目,並建置報告範本。
開始之前
提示:
Rational® Publishing Engine
安裝架構包含一組範例報告。在您開始發佈文件之前,您可以探索這個範例文件產生實務。請參閱
建立 REST 範例範本
。
熟悉利用
Rational Publishing Engine
來擷取資料的
Rational RequisitePro®
需求。如果要尋找您的
Rational RequisitePro
版本的資訊中心,請參閱
關於
Rational RequisitePro
資訊中心
。
關於這項作業
資料是用 REST API 來擷取。這個介面由資料來源應用程式安裝與實作,並與
Rational Publishing Engine
分開運作。如需該資料來源的 REST API 相關資訊,請參閱該資料來源的說明文件。
程序
如需範本開發程序的概觀,請檢閱
設計文件範本
。
開始規劃您文件的結構以及可能包含的資料。 舉例來說,決定最終文件要從一個範本產生,或是從各含有可重複使用的內容片段的多個範本檔產生。
在 Document Studio 應用程式中,
建立文件範本
。
將資料來源綱目新增至文件範本。
對於
Rational RequisitePro
,您可以輸入應用程式的基本 URL,來探索資料來源綱目。
在 Document Studio 中,按一下
資料
>
綱目探索
>
REST 綱目探索
。
輸入資料來源的
名稱
。
輸入資料來源的
說明
。
指定資源的
基本 URL
。
從清單中選取
鑑別類型
。
對於「資料服務」所提供的
Rational RequisitePro
配接器,您必須指定
基本
鑑別。如果您沒有選取類型,則會測試每一種類型,直到找到正確的類型,但這可能增加文件產生時間。
如果資源位於安全伺服器,請指定
使用者
名稱。
如果資源位於安全伺服器,請指定
密碼
。
按
下一步
。
您輸入的基本 URL 中會自動附加
?metadata=schema
。
按一下
完成
。
您選取的資料來源綱目會顯示在「資料來源綱目」視圖中。
將元素新增至範本。
Rational Publishing Engine
有一組綜合性的範本元素,可供您用來建立文件結構。您可以將元素拖曳到範本內容編輯器中。例如,您可以新增「儲存器」元素,來保留數個段落。每一個段落可能由一個測試條件控制,且該測試條件只讓它與特定的資料產生關聯。如需相關資訊,請參閱
「選用區」視圖中的範本元素
和
新增元素至範本
。
利用
查詢
、
屬性
和
變數
,將資料新增到範本中。這些項目指定要在報告中產生的資訊片段。
將
格式化和樣式
新增至元素,來控制如何在輸出中顯示它們。
建立
過濾器
,來縮小要取出到報告的資料。
您可以利用過濾器(一般資料來源 URI 的詳細版本)來指向特定的資料子集,以免
Rational Publishing Engine
在產生報告期間嘗試從資料來源擷取非必要的資訊。 這些過濾器必須範圍夠大,足以擷取範本所參照的所有必要資料,否則,產生的報告無法包括完整的資料。
在「可報告的 REST 第 1 版」原生過濾器中,您只需在方括弧 [] 之間輸入文字。過濾器的其餘部分由
Rational Publishing Engine
產生。
下列的「可報告的 REST 第 1 版」原生過濾器範例使用
Stability='High'
來擷取
Rational RequisitePro
PRRequirements
綱目。
將過濾器表示式新增至
Appliances
之下的節點,以便只選取由特定製造商所製造的設備。
fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)
建立
排序
,來組織您報告中的資料。
Rational RequisitePro
不支援使用原生排序。不過,您可以在
Rational RequisitePro
中建立排序:
建立表格並輸入資料。
排序資料。
建立視圖
,並將資料儲存到視圖中。
匯出視圖,以便在
Rational Publishing Engine
中作為資料來源綱目。「報告資料服務」應用程式會自動偵測視圖。
將資料來源綱目新增至
Rational Publishing Engine
範本。
在
Rational Publishing Engine
輸出中產生的
Rational RequisitePro
資料會保留視圖中的排序,不過,有些巢狀資料可能不會顯示成巢狀。
範例:使用 Rational RequisitePro 資料來源綱目時的遞迴層次和遞迴區段
您可以在隨
Rational Publishing Engine
一起安裝的範例 (
%RPE_HOME%\source\XML\examples\RequisitePro.xsd
) 所提供給您的
IBM Rational RequisitePro
綱目中,使用
PRRequirement
查詢,來查看軟體需求清單。
範例:使用 Rational RequisitePro 建立 Script 表示式來設定標題樣式
這個範例使用
RequisitePro.xsd
通用 XML 綱目,且
PRRequirement
查詢中含有
層次
屬性。
前一個主題:
配置 Rational RequisitePro 與 Rational Publishing Engine 之間的整合
下一個主題:
產生文件並以 Rational RequisitePro 作為資料來源
相關概念
:
將 SoDA 範本移轉至
Rational Publishing Engine
相關資訊
:
DeveloperWorks 上的
Rational Publishing Engine
社群指導教學和實務
意見