報告設計者可以使用 Document Studio 來匯入資料來源綱目,並建置報告範本。
開始之前
請檢查您想要使用的
Rational DOORS 模組及其內容。
如果要尋找您的
Rational DOORS 版本的資訊中心,請參閱
關於 Rational DOORS 資訊中心。
您可以使用模組中所儲存的模組內容、物件屬性及視圖的組合。
請檢閱模組中可用於計算直欄(也可能用於「佈置 DXL」直欄)的視圖,其中包括可追蹤性視圖。
這些視圖並未對應於 Rational DOORS 屬性,但有可能是您會想併入報告中的東西。
程序
- 如需範本開發程序的概觀,請檢閱設計文件範本。 開始規劃您文件的結構以及可能包含的資料。 舉例來說,決定最終文件要從一個範本產生,或是從各含有可重複使用的內容片段的多個範本檔產生。
- 在 Document Studio 應用程式中,建立文件範本。
- 識別資料來源中的資料來源綱目。 您可以使用 Rational DOORS 或 Rational DOORS Web Access。
若為 Rational DOORS:
- 在 Document Studio 中,按一下。
- 指定連線詳細資料:
- 如果要使用執行中的 Rational DOORS 實例,請選取使用執行中的 DOORS 實例。
- 如果要在背景中執行 Rational DOORS,請選取執行新的背景 DOORS 程序。指定使用者名稱、密碼、資料庫和 doors.exe 路徑。
- 選取一個視圖:
- 按下一步。
- 選取屬性類型:
- 如果要新增屬性到主要物件 Module/Object 綱目元素中,請選取模組和物件屬性。
- 如果要新增鏈結物件 Module/Object/Link/Linked 綱目元素的屬性,請選取鏈結物件的屬性。
- 在「DOORS 模組選項」視窗,從 Rational DOORS 資料庫結構中選取一個模組,然後按下一步。
- 在「DOORS 基準線」視窗中,選取模組的基準線。您選取的基準線決定了要用的屬性集。
- 在「DOORS 屬性」視窗中,會顯示下列屬性資訊:
- 屬性名稱:列出所選基準線中可用的屬性。
- 範圍:以模組或物件來顯示屬性的範圍。
- 提升名稱:提升的屬性名稱是 Script 表示式中所用的名稱。
有效的名稱是從 Rational DOORS 屬性名稱產生,以防止輸入無效的值。
提升屬性可供直接從 Module/Object 環境定義中存取這個屬性值。
非提升屬性值只能從 Module/Object/Attribute 環境定義取得。
請選取一個勾選框來指定屬性,或選取全選,以選取所有屬性。
取消全選會清除所有屬性。按下一步。
- 在「DOORS 視圖和直欄」視窗中,選取視圖。然後選取某直欄名稱的勾選框來選取直欄,或選取全選,以選取所有直欄名稱。按下一步。
註: 直欄的提升名稱會顯示在提升名稱直欄中。
您可以從任意數量的視圖中提升直欄。您可以稍後在設計範本時,再提升這些屬性。在一般預先定義的關鍵字之外,屬性會新增宣告資訊到元素中。
使用者定義的 Rational DOORS 屬性只能透過標準 Rational DOORS 綱目檔中的 Attribute 節點來存取。
如果要使用這些屬性,您可以利用 XML 綱目探索精靈,將屬性值提升為 XML 屬性。
屬性有可能只出現一次,例如,模組名稱和前次修改時間內容。
屬性可能適用於某一個物件,但可能會出現多次,例如物件標題和物件文字。
- 在「選取綱目選項」視窗中,輸入下列欄位的詳細資料:
- 選取綱目位置:按一下瀏覽,選取資料來源綱目的儲存位置。
- 資料來源綱目 ID:輸入資料來源綱目的 ID。
- 選取將資料來源綱目新增至現行範本勾選框,將這個綱目新增到開啟的範本中。按下一步。
- 將綱目儲存起來,以便在其他範本中,無需重新執行「綱目探索精靈」,就能夠重複使用它們。
- 檢閱摘要視窗中的資訊,然後按一下完成。
- 使用屬性。 您可以探索哪些物件屬性會出現在「Rational DOORS 模組」中,然後評量它們是否必須出現在您的 Rational Publishing Engine 報告中。請利用功能表選項,來存取模組所包含的屬性清單。
- 將元素新增至範本。 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 中擷取直欄資訊:
如果您的 Rational DOORS 表格中有資料格跨越多列,Rational Publishing Engine 會產生第一個資料格,並移除跨越的其餘資料格。
請參閱新增表格元素,以取得表格的相關資訊。
- 利用查詢、屬性和變數,將資料新增到範本中。這些項目指定要在報告中產生的資訊片段。 IBM® Rational DOORS 中的查詢起自根元素(模組),接下來是其子元素(物件),然後是物件的子屬性。例如,Module/Object/Attribute/Name。請參閱 Rational DOORS 綱目,以取得相關資訊。
- 將格式化和樣式新增至元素,來控制如何在輸出中顯示它們。
- 建立過濾器,來縮小要取出到報告的資料。 您可以利用過濾器(一般資料來源 URI 的詳細版本)來指向特定的資料子集,以免 Rational Publishing Engine 在產生報告期間嘗試從資料來源擷取非必要的資訊。
這些過濾器必須範圍夠大,足以擷取範本所參照的所有必要資料,否則,產生的報告無法包括完整的資料。 您可以在鏈結查詢中定義原生過濾器。請參閱範例:Rational DOORS 原生過濾器,以取得相關資訊。
- 建立排序,來組織您報告中的資料。 對於 Rational DOORS,原生排序文字必須使用 Rational DOORS 排序格式。請參閱範例:Rational DOORS 中的原生排序,以取得相關資訊。
下一步
如果您從 Document Studio 應用程式
預覽資料,會使用預設基準線和視圖來擷取資料。