Rational® DOORS® supports
a proprietary API and the filter is expressed using the Rational DOORS View
syntax.
The following
Rational 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
Rational DOORS data
source:
- Open a Rational DOORS Module,
and then click .
- Create the filter syntax:
- Select the Attributes tab.
- For Attribute, select Object Text.
- For Condition, select Contains.
- 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
- Click Add. In the Advanced options section,
the rule syntax is created.
- Click Description and copy the full description.
You now have the Rational DOORS filter,
which is a DXL script.
To add the
Rational DOORS filter
to the
Rational Publishing Engine template
element:
- Select the template element that contains the query that is to
be filtered.
- In the Properties tab, expand Data.
- In the Filter field, click the ellipsis.
The Filter Editor window opens.
- In the Native Filter tab, paste the Rational 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 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.
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.