From the search engine, you can search for elements. You
can customize your searches in the Search window.
You can enter single terms or phrases to search for an element.
When you search, the following rules apply:
- A phrase is a group of words that is surrounded by double quotation
marks, such as "view element".
- The default search operator is "AND". For example, if you search
for module view, only elements that contain
both view and module are listed in the results.
- When you search for a single term, you can use wildcards. A question
mark (?) denotes a single character; an asterisk (*) denotes multiple
characters. For example, if you search for te?t,
the results might include text and test.
If you search for test*, your results might
include test, tests, and testing.
Note: - You must enable the lucene.allowleadingwildcard in SQL for wild
card search in the beginning of strings. This is done by setting lucene.allowleadingwildcard
to true using the following sql command: update projectsetting
set value='true' where pid=-2 and name = 'lucene.allowleadingwildcard'.
This option is not available by default. Searching with leading wildcards
might be an expensive operation, as it requires scanning the list
of tokens in the entire index for a pattern that matches the search
string.
- Wildcard searches are not applicable in Chinese and Japanese because
in those languages, each character is considered to be a single term.
Boolean operators
Note: Boolean operators must
be written in uppercase.
Operator |
Symbol |
Example |
Finds |
OR |
|| |
view OR module |
All elements that contain either view or module |
AND |
&& |
view AND module |
All elements that contain both view and module.
AND is the default operator. |
NOT |
! |
view NOT module |
All elements that contain view, but do not contain module. Tip: The hyphen (-) can also denote NOT.
|
Search settings
After you enter a term or
phrase in the Search field and press Enter,
a window opens in which you can customize your search.
Tip: If you cannot find a recently added element,
the search index has not updated to include the new element. New data
is automatically added to the search index, but when many data are
affected, the search index might take a long time to update.
Escaping special characters
If a search term
contains special characters that are part of the query syntax, they
can be escaped. The special characters are: + - && || ! ()
{} [] ^ " ~ * ? : \
To escape these characters, type a backslash
(\) before the character. For example, to search for (1+1):2, use
the query: "\(1\+1\)\:2"
Advanced searches
Grouping searches:
You can combine multiple terms with Boolean operators to form a more
complex query by using parentheses. For example, if you search for (module
OR element) AND workspace, the results include all the
elements that contain workspace, and that also include
either module or element.
Fuzzy
searches: To complete a fuzzy search, enter a tilde (~) at the
end of a single word term. For example, to search for a term that
is spelled like roam, enter roam~.
Proximity
searches: A search can also find words that are within a specific
distance from each other. To complete a proximity search, enter a
tilde (~) at the end of a phrase. For example, to search for module and element within
three words of each other in an element, use the search "module
element" ~3