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

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

開始之前

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

關於這項作業

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

程序

  1. 如需範本開發程序的概觀,請檢閱設計文件範本 開始規劃您文件的結構以及可能包含的資料。 舉例來說,決定最終文件要從一個範本產生,或是從各含有可重複使用的內容片段的多個範本檔產生。
  2. 在 Document Studio 應用程式中,建立文件範本
  3. 將資料來源綱目新增至文件範本。 對於 Rational Rhapsody,您可以輸入應用程式的基本 URL,來探索資料來源綱目。
    1. 在 Document Studio 中,按一下資料 > 綱目探索 > REST 綱目探索
    2. 輸入資料來源的名稱
    3. 輸入資料來源的說明
    4. 指定資源的基本 URL Rational Rhapsody 的基本 URL 是:https://server:port/Rational/Rhapsody/fields.xsd

      您也可以使用 Rational Rhapsody 安裝架構隨附的資料來源綱目。Rational Rhapsody 綱目的預設位置是 %Rational_Rhapsody_HOME%\RPE\Schemas。當從套用了設定檔的模型和新詞彙來探索綱目時,請確定已將含有設定檔的模型和新詞彙載入到 Rational Rhapsody 中。

    5. 從清單中選取鑑別類型 如果您沒有選取類型,則會測試每一種類型,直到找到正確的類型,但這可能增加文件產生時間。
    6. 如果資源位於安全伺服器,請指定使用者名稱。
    7. 如果資源位於安全伺服器,請指定密碼
    8. 下一步 您輸入的基本 URL 中會自動附加 ?metadata=schema。 範例:https://server:port/Rational/Rhapsody/fields.xsd?metadata=schema
    9. 按一下完成 您選取的資料來源綱目會顯示在「資料來源綱目」視圖中。
  4. 將元素新增至範本。 Rational Publishing Engine 有一組綜合性的範本元素,可供您用來建立文件結構。您可以將元素拖曳到範本內容編輯器中。例如,您可以新增「儲存器」元素,來保留數個段落。每一個段落可能由一個測試條件控制,且該測試條件只讓它與特定的資料產生關聯。如需相關資訊,請參閱「選用區」視圖中的範本元素新增元素至範本
  5. 利用查詢屬性變數,將資料新增到範本中。這些項目指定要在報告中產生的資訊片段。
  6. 格式化和樣式新增至元素,來控制如何在輸出中顯示它們。
  7. 建立過濾器,來縮小要取出到報告的資料。 您可以利用過濾器(一般資料來源 URI 的詳細版本)來指向特定的資料子集,以免 Rational Publishing Engine 在產生報告期間嘗試從資料來源擷取非必要的資訊。 這些過濾器必須範圍夠大,足以擷取範本所參照的所有必要資料,否則,產生的報告無法包括完整的資料。 Rational Rhapsody 支援在原生過濾器中使用「可報告的 REST 第 1 版」資料來源。 在「可報告的 REST 第 1 版」原生過濾器中,您只需在方括弧 [] 之間輸入文字。過濾器的其餘部分由 Rational Publishing Engine 產生。 如需相關資訊,請參閱Reportable REST 第 1 版 另請參閱REST 原生過濾器支援的過濾器條件,以取得相關資訊。
  8. 您可以利用強制轉型查詢過濾器來修正查詢結果。 類型強制轉型特性可作為資料來源元素的替代過濾器,請參閱類型強制轉型,以取得詳細資料。
  9. 建立排序,來組織您報告中的資料。

意見