Results Browser Filter

The Results Browser contains several ways to filter results data to display specific entities in the browser.

The Find/Filter option is located on the Toolbars tab in the Browser Configuration window. This opens a field in the browser where you can enter in a search string to find and filter entities.


Figure 1.

Enter Search String Field

You can enter your search criteria in the Enter Search String... field.
Tip: Use AND, OR, <, >, operators to refine your search.
After you enter your string in the search field, the Results Browser will only be updated with your search results when you:
  • Press the Enter key.
  • Click the magnifying glass .
  • Use the Add as Filter option in the Entity Editor.

Clear Search String Field

The search string can be cleared in the following ways:
  • Click x on the right side of the search string field.
  • Highlight the search string and press Delete or Backspace on the keyboard.
  • Click .

Clearing the search string field displays the full browser tree.

Filter Syntax

All entity conditions/properties can be easily inserted into the search string field via the Add as Filter context menu in the Entity Editor.

Using this feature also allows for the correct usage of double quotes and the escape sequences in the filter syntax.

Filter for a property

<keyword>:<value>

Filter for all entities with the color red:

color:2

Supported logical operators: AND, OR and NOT

Note: These operators must be upper case by default; AND will be inserted if multiple keywords are used for filtering.
Filter for all components with a label containing the word ENGINE:
type:Components AND label:ENGINE

Parentheses can be used to build more complex filter strings

Filter for all components with a label containing either the word ENGINE or SOLID:
type:Components AND (label:ENGINE OR label:SOLID)

Filtering for labels with blanks requires double quotes

Filter for all entities which have the complete label as shown below:
label:"SOLID: BRAKE-ASSEMBLY-FR.1"

Filtering for labels that contain special characters, such as double quotes and parentheses, requires the escape sequence

Filter for a note that contains a Templex expression:
text:/"{entity.id} {entity.label}/"

The wildcard "*" for any number of characters and "?" for exactly one character are supported

If no wildcard is added at the beginning or the end of the filter string, it will be used as if the wildcard "*" is added at both ends. If at one end a wildcard is added, the other end is treated like it is the beginning or end of the filter string.

Filter for all entities that contain the string TORSO in their label:
label:"*TORSO*"
Filter for all entities that begin with TORSO:
label:"TORSO*"

Use Add as Filter to Define Search Parameters

To apply a filter, right-click on a property in the Entity Editor and select Add as Filter.


Figure 2.

The filter is added to the search field in the browser. If you add more than one filter type, it will be added to the search field, with the word AND.

If you want to change search criteria (part color for example), you can backspace to remove the number from the search field and a context sensitive menu is displayed containing the color palette.


Figure 3.
Selecting a new part color automatically adds the number equivalent to the search field.