Rational DOORS schema

The Rational® DOORS® schema closely matches the Rational DOORS module structure.

You can use a predefined schema which is generic and valid for all Rational DOORS formal modules. Use this predefined schema when you are working with either the entire view or with predefined attributes of the view that do not require extracted user-defined attributes. When user-defined attributes are required, use the schema discovery wizard in Document Studio to create a Rational DOORS schema.

Queries and attributes in the predefined schema

The following queries and attributes are in the predefined schema.
Table 1. Queries and attributes
Query Results Attributes
Module A single entity, the module specified in the data source configuration
  • Name: The module name
  • Description: The module description
  • Baseline: The module version
Module/Attribute The list of module-level attributes for the module
  • Name: The attribute name
  • _value: The attribute value
Module/Discussion The list of discussions for the module Not applicable
Module/Discussion/Attribute The list of attributes for a discussion
  • Name: The attribute name
  • _value: The attribute value
Module/Discussion/Comment The list of comments for a discussion
  • Status
  • Text
  • Changed Status
  • Created On
Module/View A single result, the view defined for each Rational DOORS data source in the document specification
  • Name: The name of the view
Module/View/Column The list of column header names for the selected view
Note: This query provides a way for getting the structure of the view, such as column information, without pulling in the view data itself. See Module/Object/Column for information on column data.
  • Column Text: Using this attribute in a template produces a <data attribute not found> message in the output
  • Main: If the column is the main column or not
  • Name: The name of the column
  • Attribute: The attribute of the column is not the Rational DOORS attribute on which that column is based, but an Rational Publishing Engine construct. The attribute is filled at run time with a single column text value. You cannot retrieve information about an underlying attribute or DXL for a column from the Attribute.
  • _value: Empty
Module/Object The list of all objects with the specified version of the modules that are filtered and sorted by the selected view. Any attribute elevated by the user in the schema discovery wizard, which makes the artifacts available directly as data source schema elements.
  • Object Identifier
  • Object Text
  • Object Heading
  • Absolute Number
  • Object Level
Module/Object/Attribute The list of attributes for the object if the query is in the context of a module/object query. Otherwise, the list of all attributes for all objects in the module are included.
  • Name: The attribute name
  • _value: The attribute value
Module/Object/Column The column data from the selected view for the current object
  • Column Text: The data from the column
  • Main: If the column is the main column or not
  • Name: The name of the column
  • Attribute: The attribute of the column is not the Rational DOORS attribute on which that column is based, but an Rational Publishing Engine construct. The attribute is filled at run time with a single column text value. You cannot retrieve information about an underlying attribute or DXL for a column from the Attribute.
  • _value: Empty
Module/Object/Table A single result (the Rational DOORS table) if the object is a table header. No results are included if the current object is not a Rational DOORS table. Not applicable
Module/Object/Table/Row The table rows Not applicable
Module/Object/Table/Row/object A collection of objects; the cells for the current row. Same attribute list available as for the module/object query.
  • Object Identifier
  • Object Text
  • Object Heading
  • Absolute Number
  • Object Level
Module/Object/External Link A collection of external links for the object. The information consists of the URL of the external entity and a set of other attributes defined for the external link.
  • URL: The URL of the external linked entity and other attributes as defined in Rational DOORS
Module/Object/Link A list of inner links for the object. For example, create a link from a user requirement to the design features. Not applicable
Module/Object/Link/Attribute The attribute list for the link
  • Name: The attribute name
  • _value: Empty
Module/Object/Link/Linked Object The list of linked objects. For example, create a link from a user requirement to the design features. Not applicable

What cannot be extracted

A Rational DOORS data source in Rational Publishing Engine is defined by module, baseline, view. You cannot query the baseline list or the list of views for the module. The Rational DOORS data source is defined by the module, baseline, view. Extracting data from more than one module, or baseline, or view can be done one of following ways:

OLE objects

You can extract embedded objects, such as Object linking and embedding (OLE objects), from either Module or Object attributes in a Rational DOORS data source.

Tables

Rational DOORS tables are not extracted automatically; you must explicitly query for them. This manual approach provides fine-grained control over the table format. The table is created only for Rational DOORS objects that start a table.

An example of a query that extracts a table:

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

Note: The table cells do not have a dedicated type in the Rational DOORS schema. To retrieve the cell content use the Module/Object/Table/Row/Object query. Objects that are table cells have an Object Text attribute that combines the Object Heading and Object Text.

Feedback