設計範本並以 Rational Tau 作為資料來源

報告設計者可以使用 Document Studio 來匯入資料來源綱目,並建置報告範本。

開始之前

熟悉 Rational® Tau UML 模型,以及從 Rational Publishing Engine 擷取資料所需要的 Rational Tau 綱目。 如果要尋找您的 Rational Tau 版本的資訊中心,請參閱關於 Rational Tau 和 Rational DOORS® Analyst 資訊中心

程序

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

範例

表 1. Rational Tau 多重範本文件範例
範本檔名稱 範本內容 用法說明
titlePage.dta 標題頁、目錄 從「模組」內容產生標題頁
Preamble.dta 前言章節 包含具有前言章節的 Microsoft Word 檔
Requirements.dta 系統需求 從列出系統需求的資料來源產生資料
userRequirements.dta 使用者需求 從列出使用者需求的資料來源產生資料
Design.dta 建模資訊 從列出 UML 模型中之資訊的資料來源產生資料

意見