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

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

開始之前

提示: Rational® Publishing Engine 安裝架構包含一組範例報告。在您開始發佈文件之前,您可以探索這個範例文件產生實務。請參閱建立 Rational DOORS® 範例範本
請檢查您想要使用的 Rational DOORS 模組及其內容。 如果要尋找您的 Rational DOORS 版本的資訊中心,請參閱關於 Rational DOORS 資訊中心

您可以使用模組中所儲存的模組內容、物件屬性及視圖的組合。 請檢閱模組中可用於計算直欄(也可能用於「佈置 DXL」直欄)的視圖,其中包括可追蹤性視圖。 這些視圖並未對應於 Rational DOORS 屬性,但有可能是您會想併入報告中的東西。

程序

  1. 如需範本開發程序的概觀,請檢閱設計文件範本 開始規劃您文件的結構以及可能包含的資料。 舉例來說,決定最終文件要從一個範本產生,或是從各含有可重複使用的內容片段的多個範本檔產生。
  2. 在 Document Studio 應用程式中,建立文件範本
  3. 識別資料來源中的資料來源綱目。 您可以使用 Rational DOORSRational DOORS Web Access。

    若為 Rational DOORS

    1. 在 Document Studio 中,按一下資料 > 綱目探索 > DOORS 綱目探索
    2. 指定連線詳細資料:
      • 如果要使用執行中的 Rational DOORS 實例,請選取使用執行中的 DOORS 實例
      • 如果要在背景中執行 Rational DOORS,請選取執行新的背景 DOORS 程序。指定使用者名稱、密碼、資料庫和 doors.exe 路徑。
    3. 選取一個視圖:
      • 「資料庫」視圖
      • 「專案」視圖
    4. 下一步
    5. 選取屬性類型:
      • 如果要新增屬性到主要物件 Module/Object 綱目元素中,請選取模組和物件屬性
      • 如果要新增鏈結物件 Module/Object/Link/Linked 綱目元素的屬性,請選取鏈結物件的屬性
    6. 在「DOORS 模組選項」視窗,從 Rational DOORS 資料庫結構中選取一個模組,然後按下一步
    7. 在「DOORS 基準線」視窗中,選取模組的基準線。您選取的基準線決定了要用的屬性集。
    8. 在「DOORS 屬性」視窗中,會顯示下列屬性資訊:
      • 屬性名稱:列出所選基準線中可用的屬性。
      • 範圍:以模組或物件來顯示屬性的範圍。
      • 提升名稱:提升的屬性名稱是 Script 表示式中所用的名稱。 有效的名稱是從 Rational DOORS 屬性名稱產生,以防止輸入無效的值。 提升屬性可供直接從 Module/Object 環境定義中存取這個屬性值。 非提升屬性值只能從 Module/Object/Attribute 環境定義取得。

      請選取一個勾選框來指定屬性,或選取全選,以選取所有屬性。 取消全選會清除所有屬性。按下一步

    9. 在「DOORS 視圖和直欄」視窗中,選取視圖。然後選取某直欄名稱的勾選框來選取直欄,或選取全選,以選取所有直欄名稱。按下一步
      註: 直欄的提升名稱會顯示在提升名稱直欄中。 您可以從任意數量的視圖中提升直欄。您可以稍後在設計範本時,再提升這些屬性。在一般預先定義的關鍵字之外,屬性會新增宣告資訊到元素中。 使用者定義的 Rational DOORS 屬性只能透過標準 Rational DOORS 綱目檔中的 Attribute 節點來存取。 如果要使用這些屬性,您可以利用 XML 綱目探索精靈,將屬性值提升為 XML 屬性。 屬性有可能只出現一次,例如,模組名稱前次修改時間內容。 屬性可能適用於某一個物件,但可能會出現多次,例如物件標題物件文字
    10. 在「選取綱目選項」視窗中,輸入下列欄位的詳細資料:
      • 選取綱目位置:按一下瀏覽,選取資料來源綱目的儲存位置。
      • 資料來源綱目 ID:輸入資料來源綱目的 ID。
      • 選取將資料來源綱目新增至現行範本勾選框,將這個綱目新增到開啟的範本中。按下一步
      • 將綱目儲存起來,以便在其他範本中,無需重新執行「綱目探索精靈」,就能夠重複使用它們。
    11. 檢閱摘要視窗中的資訊,然後按一下完成
  4. 使用屬性。 您可以探索哪些物件屬性會出現在「Rational DOORS 模組」中,然後評量它們是否必須出現在您的 Rational Publishing Engine 報告中。請利用編輯 > 屬性功能表選項,來存取模組所包含的屬性清單。
  5. 將元素新增至範本。 Rational Publishing Engine 有一組綜合性的範本元素,可供您用來建立文件結構。您可以將元素拖曳到範本內容編輯器中。例如,您可以新增「儲存器」元素,來保留數個段落。每一個段落可能由一個測試條件控制,且該測試條件只讓它與特定的資料產生關聯。如需相關資訊,請參閱「選用區」視圖中的範本元素新增元素至範本
    儲存器元素
    您可以利用儲存器元素來取代 1x1 表格中所包含的「Rational DOORS 分析師」圖表的表格。
    影像元素
    影像及其屬性值是擷取自 Rational DOORS 模組。您無法只查詢影像。
    如果要配置所擷取影像的大小,請指定影像最大寬度影像最大高度內容。這些內容可以在下列兩處指定:
    • 元素格式資訊是定義該範本元素中所包含的影像大小。僅適用於文字範本元素。
    • 文件規格 meta 資料是定義所有範本中的影像大小。元素格式值會置換這些廣域值。
    表格元素
    您在 Rational Publishing Engine 中重新產生的 Rational DOORS 表格與 Rational DOORS 中的表格可能不會完全相同; 您可以使用可用的 Rational DOORS 表格屬性並產生新表格。
    請利用 Rational DOORS 綱目精靈來擷取 Rational DOORS 表格的相關資訊。 範例:TableCellWidth資料格寬度(螢幕像素)。您可以利用兩種方式,從 Rational DOORS 中擷取直欄資訊:
    • 利用 module/object/column 來取得物件查詢中的直欄名稱和值。當 Rational DOORS 資料是依物件來進行反覆運算時,這很有用。
    • 利用 module/view/column,從用來產生文件的 Rational DOORS 視圖中取得直欄名稱。 當需要現行視圖所定義的直欄及其內容時,「依視圖反覆運算」很有用。 您可以利用 Rational Publishing Engine 範例範本來測試這些方法。
      註: 如果要存取直欄資料,請在查詢中使用 module/object/column/(@Column Text)

    如果您的 Rational DOORS 表格中有資料格跨越多列,Rational Publishing Engine 會產生第一個資料格,並移除跨越的其餘資料格。

    請參閱新增表格元素,以取得表格的相關資訊。

  6. 利用查詢屬性變數,將資料新增到範本中。這些項目指定要在報告中產生的資訊片段。 IBM® Rational DOORS 中的查詢起自根元素(模組),接下來是其子元素(物件),然後是物件的子屬性。例如,Module/Object/Attribute/Name。請參閱 Rational DOORS 綱目,以取得相關資訊。
  7. 格式化和樣式新增至元素,來控制如何在輸出中顯示它們。
  8. 建立過濾器,來縮小要取出到報告的資料。 您可以利用過濾器(一般資料來源 URI 的詳細版本)來指向特定的資料子集,以免 Rational Publishing Engine 在產生報告期間嘗試從資料來源擷取非必要的資訊。 這些過濾器必須範圍夠大,足以擷取範本所參照的所有必要資料,否則,產生的報告無法包括完整的資料。 您可以在鏈結查詢中定義原生過濾器。請參閱範例:Rational DOORS 原生過濾器,以取得相關資訊。
  9. 建立排序,來組織您報告中的資料。 對於 Rational DOORS,原生排序文字必須使用 Rational DOORS 排序格式。請參閱範例:Rational DOORS 中的原生排序,以取得相關資訊。

下一步

如果您從 Document Studio 應用程式預覽資料,會使用預設基準線和視圖來擷取資料。

意見