You can filter requirements from the current document by entering a condition in the Filter field, which is placed in the top right corner of the screen. To move quickly to the Filter field, press CtrlShiftF.
To display a list of suggestions for available filtering conditions, press ↓ or just start typing.
To activate or deactivate the current filter, click the icon, or press CtrlAltF.
Note: When the current filter is active, the Description column is not indented according to the section level.
To filter all objects with a given value of an enumeration (enum) custom attribute, choose attribute and then an enumeration value from the filter suggestions list.
Examples:
To filter all objects matching a given text condition in a text (int, real and date) attribute or in a Template Column, choose an attribute or template column item from the filter suggestions list, and choose a keyword from the list or enter a "substring" or a /regular expression/ condition.
Note: If you choose a keyword from the list without first specifying an attribute, the keyword is matched in all text attributes.
Examples:
To filter all objects with a given value of a Boolean (bool) attribute, choose an attribute item from the filter suggestions list.
Examples:
To filter all objects with a given value of a numeric (int, real and date) custom attribute or a template column displaying just a number or date, choose an attribute or template column item from the filter suggestions list and enter one of these <, >, <=, >=, = conditions.
Examples:
You can filter all objects with a null value of a numeric or text attribute. Choose attribute from the filter suggestions list and then choose ƒ IS NULL or press Enter without entering a value.
Example:
To filter all objects from the given section, choose Section from the filter suggestion list and enter a section number.
Example:
To filter all objects with outgoing or incoming links of a given type, choose link type or link type respectively from the filter suggestions list.
Similarly, you can filter all objects with a reference origin (see Copy Objects). Choose Origin or Copies item respectively from the filter suggestion list.
Optionally, to add condition that the given link type should have Suspect Link Flag set, choose Suspect link from the filter suggestion list before a link type.
To find all dangling links, choose Dangling link from the filter suggestion list.
Examples:
To filter all objects with a specific link, create a traceability column displaying all links of a given link type and filter text value.
Example:
You can use filters to find missing links. For example, to filter all functional requirements missing a satisfaction link combine filtering by object type and link type.
Example:
To filter all objects with history of attribute changes, choose Changed from the filter suggestions list.
Afterwards, you can choose a specific attribute from the filter suggestions list and/or enter a date in YYYY-MM-DD format to filter objects that were modified on or after that date. Press Enter to finalize the condition.
Note: The word “since” is added automatically when you enter a valid date.
Examples:
It is often useful to see comments of other users while reviewing a document, update commented requirements, and eventually delete resolved comments.
To filter all commented objects, choose Commented from the filter suggestions list.
Afterwards, you can enter a date in YYYY-MM-DD format to filter objects that were commented on or after that date. Press Enter to finalize the condition.
Note: The word “since” is added automatically when you enter a valid date.
Examples:
Note: Directly adjacent conditions (gray boxes) are implicitly joined by the AND logical operator. See below for explanation.
To filter a combination of several conditions, use AND, OR and NOT logical operators in disjunctive normal Form (DNF) according to the following rules:
Example: Filter all document objects with attribute type set to “User Story” AND attribute status set to “Verified”.
Example: Filter all user stories in which an editor can open or save, OR an architect can create.
To sort the current document, click on a chosen column heading. To change the sort order, click on the same column heading again. To reset to the default sorting with the natural document order, click on the Description column heading.
Note: You cannot sort by Custom Attributes, Discussion, and Links columns.
To navigate directly to the document object with a specific ID, click Document and select Go To, or press CtrlG. In the Go To dialog, enter the object ID, including the document ID prefix if the object is from a different document.
You can search for a keyword in the current document using the Search input field placed next to the Filter in the top right corner of the screen. To activate the Search field, click Document and select Search, click the icon, or press CtrlF.
When you enter a searched keyword in the Search field, all document objects containing the keyword in any of its string
or xhtml
attributes are highlighted. To navigate to the next or previous highlighted object, click on the icon on the right of the search input field or press F3 or ShiftF3 respectively.