Example of Engineering Requirements Management DOORS native filters

Edit online

This product supports a proprietary API and the filter is expressed using the DOORS View syntax.

The following DOORS native filter example filters objects that contain the word Documentation in the Object Text attribute. 
Attribute 'Object Text' contains 'Documentation' (case sensitive)
To generate the native filter text for a DOORS data source:
  1. Open a DOORS Module, and then click Tools > Filter > Define menu entry.
  2. Create the filter syntax:
    1. Select the Attributes tab.
    2. For Attribute, select Object Text.
    3. For Condition, select Contains.
    4. For Value, enter a specific value to filter on. For example, to filter only those objects that contain the word Documentation in the Object Text attribute, enter: Documentation
    5. Click Add. In the Advanced options section, the rule syntax is created.
  3. Click Description and copy the full description. You now have the DOORS filter, which is a DXL script.
To add the DOORS filter to the PUB template element:
  1. Select the template element that contains the query that is to be filtered.
  2. In the Properties tab, expand Data.
  3. In the Filter field, click the ellipsis. The Filter Editor window opens.
  4. In the Native Filter tab, paste the DOORS filter (DXL script) and click OK.

Filtering by direction

The syntax for filtering all the in links or out links is:

Link direction in|out

Filtering by link module

The 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 1

Filtering by target module

The 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

Combining native link filtering

You can combine the filters in a native filter tab. Each filter must be on its own line.

For example, in the native filter tab, type the filter as:

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

Recursive retrieval

To follow 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.

Note: Following links is a time-consuming process. Because each object typically has many links, the number of objects processed increases exponentially with each level. To save time, use the native filter to reduce the number of links that are followed.