從 CLM 應用程式中使用 POX 設定檔來建立可追蹤性文件

現在從 CLM 應用程式建立可追蹤性文件更為容易。您可以配置 OSLC URL,這樣一來,只要在要求中使用 POX (Plain Old XML) 來包含特殊標頭,就會傳回「可報告的 REST」表示法資料。

開始之前

必須已安裝 Rational® Publishing Engine 2.1.0 或更新版本, 以及 Rational solution for CLM 6.0.2 或更新版本。

關於這項作業

以前,很難建立可追蹤性文件,因為某些應用程式(例如 Rational Quality ManagerRational Team Concert)會使用 OSLC URL,而 Rational Publishing Engine 需要可報告的 REST URL。這使範本設計更加複雜,因為必須將 URL 從 OSLC 轉換為可報告的 REST。有時,構件的 OSLC 表示法未包含產生文件(例如 Rich Text 文件)所需的足夠資訊。

POX 設定檔可讓您將 OSLC URL 當成可報告的 REST API 來使用。您可以在 Rational Publishing Engine 中使用 POX 設定檔,藉由提供額外的標頭,來直接要求和接收可報告的 REST 資料。不需再轉換 URL 或執行複製要求。只要存在該標頭,文件產生服務就會傳回其他 XML。

範例:建立從 Rational DOORS Next GenerationDesign Management 的可追蹤性文件

程序

  1. 在 Document Studio 中,新增 Rational DOORS Next Generation 綱目
  2. 建立範本元素,以列印來自構件的資訊。
    DNG 元素
  3. 反覆運算需求中的鏈結資訊。
    DNG 鏈結
  4. Design Management 中,按一下瀏覽途徑中的顯示永久鏈結圖示,以複製該構件的 URL。
  5. 在 Document Studio 中,開啟「新增資料來源綱目」精靈。
  6. (New) 綱目欄位中貼上該 URL,並將 &?metadata=schema 附加至 URL 尾端。
  7. (新增)額外標頭欄位中,選取 POX 設定檔標頭
    新增具有 POX 設定檔的 DM 綱目
  8. 下一步,然後按一下完成
  9. 在範本中建立範本元素,以遵循鏈結回到 Rational DOORS Next Generation。在「內容」視圖中開啟「資料來源配置」,然後按一下「動態配置」標籤:
    1. (新增)在 URI 欄位中,輸入來自 Rational DOORS Next Generation 的 href。
    2. (新增)在接受標頭欄位中,輸入 application/xml
    3. (新增)在額外標頭欄位中,選取 POX 設定檔鏈結。 「額外標頭」欄位是告訴應用程式即使使用 OSLC URL, 仍以可報告的 REST 資訊回應。
      POX 設定檔的資料來源配置
  10. 建立範本元素,以列印 Design Management 資訊。
    DM 元素
  11. 切換至 RPE Launcher,以產生文件。
  12. 在「文件規格」視圖中,用滑鼠右鍵按一下 Rational DOORS Next Generation 資料來源,然後選取 配置資料來源
    1. URL:輸入來自 Rational DOORS Next Generation 的永久鏈結。
    2. 必要的話,請輸入使用者名稱與密碼。
    3. 鑑別:選取 OAuth
    4. 接受標頭:輸入 application/xml
    5. (新增)額外標頭:選取 POX 設定檔鏈結, 以便向 Rational DOORS Next Generation 要求可報告的 REST 資料。
  13. 從主工具列,按一下產生文件 在「主控台」視圖中,您可以看到 Rational Publishing Engine 利用 OSLC URL 向 Design ManagementRational DOORS Next Generation 要求資料。Design ManagementRational DOORS Next Generation 會重新導向至可報告的 REST URL。 輸出文件含有來自 Rational DOORS Next Generation 的需求, 以及來自 Design Management 的相關聯模型資料。
    顯示 DNG 資料和 DM 資料的結果