A filter consists of one more field expressions combined with Boolean operators — for example,
AND,
OR, and
NOT — and other grouping operators. Each field expression specifies which
field is searched and the
field value being searched on. The field also has a particular type which dictates how the field value will be interpreted by Model Manager — see
Field Types.
with <field-name> equal to the name of one of the available fields in
Table 3-1, and
<field-value> equal to the value being filtered on. Write, for example,
to find all versions whose title contain the word busbar. To match on several search words, enclose the words with parentheses. Write
A space between two search words is automatically interpreted as a Boolean AND in the Model Manager search syntax. The previous expression is thus equivalent to:
You can enter a custom filter query either directly in the search field in the Open,
Select File,
Select Model, and
Model Manager windows, or apply it as a separate filter in
Applied Filter Pills by first clicking the
Customize filter query button (
) from
The Filter Dialog Box.
and matches on all versions with a title, description, filename, or assigned tags containing the words electrical and
busbar, and that has a description containing the word
example. The following is not valid:
A Boolean AND takes precedence over a Boolean
OR in the Model Manager search syntax. The filter
matches versions whose title either contains both electrical and
busbar, or whose title contain both
tuning and
fork. You can override this operator precedence with parentheses. Write
to match all versions whose title contain electrical, and either the single word
busbar or the two words
tuning and
fork.
You can use an asterisk character as a wildcard symbol that matches on zero or more arbitrary characters. The filter
You can match on versions that have any value set for a field by using a single wildcard symbol. Write
to match on versions whose title contains electrical followed by
heating. You can also combine phrase search with ordinary search. Write
to find all versions whose title does not contain the word
busbar. The
NOT symbol takes precedence over both
AND and
OR, although you can override this precedence with parentheses. Write
A filter on a Date Field, a
Numeric Field, and a
File Size Field can be written as inclusive ranges. Write
Ranges are also supported for a Text Field or
Keyword Field filter and corresponds to matching in between two boundary words when ordering search words lexicographically. The usefulness of this, however, is rather limited.
Some characters serve special purposes in the Model Manager search syntax and are therefore considered as reserved characters. If you want to search on words that contain such characters, precede them by a backslash. Write
to match all items assigned the tag with title [In Progress]. The enclosing parentheses are necessary as there are two search words, [
In and
Progress].
to match versions with filename electrical heating busbar.mph. Parentheses are not necessary here because the field value is considered as one search word as the two space characters have been escaped.