設計範本並以 Design Management 作為資料來源

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

開始之前

提示: Rational® Publishing Engine 安裝架構包含一組範例報告。在您開始發佈文件之前,您可以探索這個範例文件產生實務。請參閱建立 REST 範例範本
熟悉 Design Management REST 服務,以及利用 Rational Publishing EngineDesign Management 擷取資料時所需的各種 URL。如果要尋找您 Design Management 版本的資訊中心,請參閱 Rational Software Architect 系列產品資訊中心

關於這項作業

資料是用 REST API 來擷取。這個介面由資料來源應用程式安裝與實作,並與 Rational Publishing Engine 分開運作。如需該資料來源的 REST API 相關資訊,請參閱該資料來源的說明文件。

程序

  1. 如需範本開發程序的概觀,請檢閱設計文件範本 開始規劃您文件的結構以及可能包含的資料。 舉例來說,決定最終文件要從一個範本產生,或是從各含有可重複使用的內容片段的多個範本檔產生。
  2. 在 Document Studio 應用程式中,建立文件範本
  3. 將資料來源綱目新增至文件範本。 對於 Design Management,您可以輸入應用程式的基本 URL,來探索資料來源綱目。
    1. 在 Document Studio 中,按一下資料 > 綱目探索 > REST 綱目探索
    2. 輸入資料來源的名稱
    3. 輸入資料來源的說明
    4. 指定資源的基本 URL Design Management 的基本 URL 是:https://server:port/dm/reporting
    5. 從清單中選取鑑別類型
      重要: 對於 Design Management,您必須指定鑑別類型,才能存取您報告的資料。Rational Publishing Engine 無法自動偵測鑑別類型。
    6. 如果資源位於安全伺服器,請指定使用者名稱。
    7. 如果資源位於安全伺服器,請指定密碼
    8. 下一步 您輸入的基本 URL 中會自動附加 ?metadata=schema。 範例:https://server:port/dm/reporting?metadata=schema
    9. 按一下完成 您選取的資料來源綱目會顯示在「資料來源綱目」視圖中。
  4. 將元素新增至範本。 Rational Publishing Engine 有一組綜合性的範本元素,可供您用來建立文件結構。您可以將元素拖曳到範本內容編輯器中。例如,您可以新增「儲存器」元素,來保留數個段落。每一個段落可能由一個測試條件控制,且該測試條件只讓它與特定的資料產生關聯。如需相關資訊,請參閱「選用區」視圖中的範本元素新增元素至範本
  5. 利用查詢屬性變數,將資料新增到範本中。這些項目指定要在報告中產生的資訊片段。
  6. 格式化和樣式新增至元素,來控制如何在輸出中顯示它們。
  7. 建立過濾器,來縮小要取出到報告的資料。 您可以利用過濾器(一般資料來源 URI 的詳細版本)來指向特定的資料子集,以免 Rational Publishing Engine 在產生報告期間嘗試從資料來源擷取非必要的資訊。 這些過濾器必須範圍夠大,足以擷取範本所參照的所有必要資料,否則,產生的報告無法包括完整的資料。 Design Management 支援使用「可報告的 REST 第 1 版」資料來源中的原生過濾。 在「可報告的 REST 第 1 版」原生過濾器中,您只需在方括弧 [] 之間輸入文字。過濾器的其餘部分由 Rational Publishing Engine 產生。 如需相關資訊,請參閱 可報告的 REST 第 1 版
  8. 建立排序,來組織您報告中的資料。

意見