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.
Query | Results | Attributes |
---|---|---|
Module | A single entity, the module specified in the data source configuration |
|
Module/Attribute | The list of module-level attributes for the module |
|
Module/Discussion | The list of discussions for the module | Not applicable |
Module/Discussion/Attribute | The list of attributes for a discussion |
|
Module/Discussion/Comment | The list of comments for a discussion |
|
Module/View | A single result, the view defined for each Rational DOORS data source in the document specification |
|
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.
|
|
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.
|
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. |
|
Module/Object/Column | The column data from the selected view for the current object |
|
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. |
|
Module/Object/External Link | A collection of external links for the object |
|
Module/Object/Link | A list of Rational DOORS links for the object | Not applicable |
Module/Object/Link/Attribute | The attribute list for the link |
|
Module/Object/Link/Linked Object | The list of linked objects | Not applicable |
Images are extracted from a Rational DOORS module with the values for the attribute. You cannot query for the images only.
Action | Result |
---|---|
Select the entire document content and use the Update fields function in Microsoft Word. | The OLE objects are displayed in the document. The document is not self-contained. |
Use the updateFields macro provided by Rational Publishing Engine. | The OLE objects are displayed in the document. The document is not self-contained. |
Use the insertOLEs macro provided by Rational Publishing Engine. | The OLE objects are displayed in the document. The document is self-contained. |
Use the rpe or insertOLEs macros provided by Rational Publishing Engine. | The OLE objects are displayed in the document. The document is self-contained. |
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.
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
The Module/Object/External Link query retrieves information related to Rational DOORS links. The information consists of the URL of the external entity and a set of other attributes defined for the external link.
Use queries to retrieve information related to Rational DOORS inner links. The inner links create a link between related information. For example, create a link from a user requirement to the design features. You can query on object links or linked objects.
To follow Rational DOORS links recursively, set Recursive Level property to a non-zero value in the Properties view. This follows the links from the initial object and from all its linked objects up to the specified recursive level.
You can define native filters on link queries. Using these filters reduces the number of links to be processed and thus reduces the time to generate the document.
The syntax for filtering all the in links or out links is:
Link direction in|outThe syntax for filtering all the links through a link module is: Link module link_module_path_and_name
The filter is case-sensitive.
The following example filters all links from a Link Module 1:
Link module /Demo/Car/Link Module 1The syntax for filtering all links to or from a specified module is: Link analyze module target_module_path_and_name
The following example filters all links between the analyze module and system requirement module: Link analyze module /Demo/Car/System Requirements
Link direction out.
Link analyze module /Demo/Car/System Requirements.