Rational DOORS 綱目

Rational® DOORS® 綱目密切符合 Rational DOORS 模組結構。

您可以使用預先定義的綱目,這是通用且適用於所有的 Rational DOORS 正式模組。如果您使用整個視圖,或者使用視圖的預先定義屬性,而不需要所擷取的使用者定義屬性,請使用這個預先定義的綱目。如果需要使用者定義的屬性,請在 Document Studio 中使用綱目探索精靈,來建立 Rational DOORS 綱目。

預先定義的綱目中的查詢和屬性

預先定義的綱目中含有下列查詢和屬性。
表 1. 查詢和屬性
查詢 結果 屬性
Module 單一實體,資料來源配置中指定的模組
  • 名稱:模組名稱
  • 說明:模組說明
  • 基準線:模組版本
Module/Attribute 模組的模組層次屬性清單
  • 名稱:屬性名稱
  • _value:屬性值
Module/Discussion 模組的討論清單 不適用
Module/Discussion/Attribute 討論的屬性清單
  • 名稱:屬性名稱
  • _value:屬性值
Module/Discussion/Comment 討論的註解清單
  • 狀態
  • 文字
  • 已變更的狀態
  • 建立時間
Module/View 單一結果,在文件規格中為每一個 Rational DOORS 資料來源所定義的視圖
  • 名稱:視圖的名稱
Module/View/Column 所選視圖的直欄標頭名稱清單
註: 藉由這項查詢,可直接取得視圖的結構(例如:直欄資訊),而不需取回視圖資料本身。如需直欄資料的相關資訊,請參閱 Module/Object/Column
  • 直欄文字:如果在範本中使用這個屬性,會在輸出中產生 <data attribute not found> 訊息。
  • 主要:該直欄是否為主要直欄
  • 名稱:直欄的名稱
  • 屬性:直欄的屬性並不是該直欄所依據的 Rational DOORS 屬性,而是一項 Rational Publishing Engine 建構。在執行時期會在屬性中填入單一直欄文字值。您無法從屬性擷取關於直欄的基礎屬性或 DXL 的資訊。
  • _value:空的
Module/Object 使用指定模組版本的所有物件清單,並且已依選取的視圖加以過濾和排序。 使用者在綱目探索精靈中所提升的任何屬性,其會將構件當成資料來源綱目元素來直接提供。
  • 物件 ID
  • 物件文字
  • 物件標題
  • 絕對數字
  • 物件層次
Module/Object/Attribute 如果查詢是在 module/object 查詢環境定義中,則此為物件的屬性清單。否則,會包含模組中所有物件的所有屬性清單。
  • 名稱:屬性名稱
  • _value:屬性值
Module/Object/Column 現行物件之所選視圖中的直欄資料
  • 直欄文字:直欄中的資料
  • 主要:該直欄是否為主要直欄
  • 名稱:直欄的名稱
  • 屬性:直欄的屬性並不是該直欄所依據的 Rational DOORS 屬性,而是一項 Rational Publishing Engine 建構。在執行時期會在屬性中填入單一直欄文字值。您無法從屬性擷取關於直欄的基礎屬性或 DXL 的資訊。
  • _value:空的
Module/Object/Table 如果物件是表格標頭,則此為單一結果(Rational DOORS 表格)。如果現行物件不是 Rational DOORS 表格,則不包含任何結果。 不適用
Module/Object/Table/Row 表格列 不適用
Module/Object/Table/Row/object 物件集合;現行列的資料格。可用的屬性清單與 module/object 查詢的屬性清單相同。
  • 物件 ID
  • 物件文字
  • 物件標題
  • 絕對數字
  • 物件層次
Module/Object/External Link 物件的外部鏈結集合
  • URLRational DOORS 中所定義的外部鏈結實體 URL 與其他屬性
Module/Object/Link 物件的 Rational DOORS 鏈結清單 不適用
Module/Object/Link/Attribute 鏈結的屬性清單
  • 名稱:屬性名稱
  • _value:空的
Module/Object/Link/Linked Object 鏈結的物件清單 不適用

影像

影像及其屬性值是擷取自 Rational DOORS 模組。您無法只查詢影像。

如果要配置所擷取影像的大小,請指定影像最大寬度影像最大高度內容。這些內容可以在下列兩處指定:
  • 元素格式資訊是定義該範本元素中所包含的影像大小。僅適用於文字範本元素。
  • 文件規格 meta 資料是定義所有範本中的影像大小。元素格式值會置換這些廣域值。

OLE 物件

您可以從 Rational DOORS 資料來源中的「模組」或「物件」屬性,擷取內嵌物件,例如:物件鏈結與內嵌(OLE 物件)。

表格

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

不會自動擷取 Rational DOORS 表格;您必須明確查詢它們。這種手動方式更能細部控制表格格式。只會針對啟動表格的 Rational DOORS 物件建立表格。

用來擷取表格的查詢範例:

Container DOORS 1 $1 Module/Object
Paragraph
Text
Module/Object/Object/Text
Table DOORS 1 $2 Module/Object/Table
Row DOORS 1 $3 Module/Object/Table/Row
Cell DOORS 1 $4 Module/Object/Table/Row/Object
Text
Module/Object/Table/Row/Object/Object Text

註:Rational DOORS 綱目中,表格資料格沒有專用類型。如果要擷取資料格內容,請使用 Module/Object/Table/Row/Object 查詢。 作為表格資料格的物件具有 Object Text 屬性,其結合了 Object HeadingObject Text

外部鏈結

Module/Object/External Link 查詢會擷取 Rational DOORS 鏈結的相關資訊。資訊由外部實體的 URL 和定義給該外部鏈結的一組其他屬性組成。

內部鏈結

使用查詢來擷取 Rational DOORS 內部鏈結的相關資訊。內部鏈結會在相關資訊之間建立鏈結。舉例來說,建立從使用者需求到設計特性的鏈結。您可以查詢物件鏈結或鏈結的物件。

遞迴擷取

如果要遞迴地遵循 Rational DOORS 鏈結,請在「內容」視圖中,將遞迴層次內容設為非零的值。這會從起始物件及其所有鏈結的物件開始,一直遵循鏈結到指定的遞迴層次。

註: 遵循鏈結是一項耗時的程序。由於每一個物件通常會有許多鏈結,所處理的物件數目會隨每一個層次呈指數增加。為了節省時間,請使用原生過濾器來減少所遵循的鏈結數量。

原生過濾

您可以在鏈結查詢中定義原生過濾器。利用這些過濾器,可減少要處理的鏈結數目,從而縮短產生文件的時間。

依方向過濾

過濾所有導入鏈結或導出鏈結的語法如下:

Link direction in|out

依鏈結模組過濾

過濾經由鏈結模組的所有鏈結的語法如下:Link module link_module_path_and_name

過濾器有區分大小寫。

下列範例是過濾來自 Link Module 1 的所有鏈結:

Link module /Demo/Car/Link Module 1

依目標模組過濾

過濾指向或來自指定模組的所有鏈結的語法如下:Link analyze module target_module_path_and_name

下列範例是過濾 analyze 模組和 system requirement 模組之間的所有鏈結:Link analyze module /Demo/Car/System Requirements

合併原生鏈結過濾

您可以合併原生過濾器標籤中的過濾器。每一個過濾器必須各佔一行。
例如,在「原生過濾器」標籤中,將過濾器輸入為:

Link direction out.
Link analyze module /Demo/Car/System Requirements.

哪些無法擷取

Rational Publishing Engine 中,是利用 module、baseline、view 來定義 Rational DOORS 資料來源。您無法查詢模組的基準線清單或視圖清單。Rational DOORS 資料來源是利用 module、baseline、view 來定義。如果要從多個模組、基準線或視圖擷取資料,可使用下列其中一種方法:

意見