報告設計者可以使用 Document Studio 來匯入資料來源綱目,並建置報告範本。
程序
- 如需範本開發程序的概觀,請檢閱設計文件範本。 開始規劃您文件的結構以及可能包含的資料。 舉例來說,決定最終文件要從一個範本產生,或是從各含有可重複使用的內容片段的多個範本檔產生。
- 在 Document Studio 應用程式中,建立文件範本。
- 識別資料來源中的資料來源綱目。 您可以從下列其中一個選項,來識別 Rational Tau 的資料來源綱目:
- 使用 Rational Publishing Engine 隨附之預先產生的 Rational Tau 綱目。這個資料來源綱目位於 %RPE_HOME%\source\Tau\schema\ttdMetamodel.xsd 中。
- 從 Rational Tau UML 專案產生資料來源綱目。請參閱擷取 Rational Tau 資料來源綱目,以取得相關資訊。
- 將資料來源綱目新增至文件範本。 對於 Rational Tau,您可以完成下列步驟:
- 在 Document Studio 中,按一下。
- 在綱目類型中,從清單中選取綱目的類型。 針對 Rational Tau,選取 Tau。
- 在綱目檔欄位中,按一下瀏覽,然後選取上一步所識別的資料來源綱目。 範例:%RPE_HOME%\source\Tau\schema\ttdMetamodel.xsd
- 在資料來源 ID 欄位中,輸入範本中資料來源的名稱。 按下一步。
- 如果資源位於安全伺服器,請指定使用者名稱。
- 如果資源位於安全伺服器,請指定密碼。
- 從清單中選取鑑別類型。 如果您沒有選取類型,則會測試每一種類型,直到找到正確的類型,但這可能增加文件產生時間。
- 將元素新增至範本。 Rational Publishing Engine 有一組綜合性的範本元素,可供您用來建立文件結構。您可以將元素拖曳到範本內容編輯器中。例如,您可以新增「儲存器」元素,來保留數個段落。每一個段落可能由一個測試條件控制,且該測試條件只讓它與特定的資料產生關聯。如需相關資訊,請參閱「選用區」視圖中的範本元素和新增元素至範本。
- 利用查詢、屬性和變數,將資料新增到範本中。這些項目指定要在報告中產生的資訊片段。 IBM Rational Tau 中的查詢語法類似於 XPath 語法。不過,與 XPath 不同的是,Rational Publishing Engine 查詢不會指定過濾器;過濾器和排序子句與查詢有所區隔。除了查詢,每一個綱目元素都是透過 Rational Tau 原生查詢來定義。這項查詢是用 OCL 表示,它會提取 Rational Tau 資料。舉例來說,模型元素 model.rootResource 之下的根元素附加了
GetModelRoots() Rational Tau 查詢。
註: - 您無法在 Rational Tau 資料來源綱目中建立自訂屬性。
- 您無法從 Launcher 或 Document Studio 應用程式預覽 Rational Tau。
- 將格式化和樣式新增至元素,來控制如何在輸出中顯示它們。
- 建立過濾器,來縮小要取出到報告的資料。 您可以利用過濾器(一般資料來源 URI 的詳細版本)來指向特定的資料子集,以免 Rational Publishing Engine 在產生報告期間嘗試從資料來源擷取非必要的資訊。
這些過濾器必須範圍夠大,足以擷取範本所參照的所有必要資料,否則,產生的報告無法包括完整的資料。 另請參閱REST 原生過濾器支援的過濾器條件,以取得相關資訊。
- 您可以利用強制轉型查詢過濾器來修正查詢結果。
類型強制轉型特性是作為資料來源元素的替代過濾器,請參閱類型強制轉型和Rational Tau 屬性,以取得詳細資料。
- 建立排序,來組織您報告中的資料。 Rational Tau 資料來源不支援原生排序。請使用 Rational Publishing Engine 排序。
範例
表 1. Rational Tau 多重範本文件範例範本檔名稱 |
範本內容 |
用法說明 |
titlePage.dta |
標題頁、目錄 |
從「模組」內容產生標題頁 |
Preamble.dta |
前言章節 |
包含具有前言章節的 Microsoft Word 檔 |
Requirements.dta |
系統需求 |
從列出系統需求的資料來源產生資料 |
userRequirements.dta |
使用者需求 |
從列出使用者需求的資料來源產生資料 |
Design.dta |
建模資訊 |
從列出 UML 模型中之資訊的資料來源產生資料 |