Search has special characters and a reserved word:
- * : Multiple character wildcard searches
- ? : Single character wildcard search
- " : Used for partial or exact search
- NOT : Capital letter NOT excludes the following term. If you want to search for "Not" use lowercase not.
Search for Wildcard Text Searches
Text fields allow for wildcard searches.
The single character wildcard search looks for terms that match that with the single character replaced. For example, to search for "text" or "test" you can use the search
te?t
Multiple character wildcard searches look for 0 or more characters. For example, to search for test, tests or tester, you can use the search:
tes*
You can also use the wildcard searches in the middle of a term.
te*t
Escaping Special Characters for text search
Lucene supports escaping special characters that are part of the query syntax. The current list special characters are
* ? \
To escape these character use the \ before the character. For example to search for Ab*Cd\xZ use the query: ab\\cd\*xz
Example
We have following assets and their names are
- Server alpha test
- Alpha server test
- App tester beta
When we search:
| Search keyword | Result | |
|---|---|---|
| te* | All assets match | add an asterisk at the end |
| test* | All assets match | |
| te | Nothing | |
| test |
| |
| server test |
| |
| "server test" |
| Query between double quotes |
| tester |
| |
| teste* |
| |
| tes? |
| Only one character matches for question mark, so "tester" does not return. |
- if you have an asset with name ab-x1 you can search for ab-*
Antoher example
We have following assets and their names are
- New York one
- New York two
New York two three
New York Not Here
When we search:
| Search keyword | Result | |
|---|---|---|
| New york | All assets match | |
| "New york one" |
| Exact search |
| "new york" NOT two |
| Must include "new york" but not two |
| "new york" NOT t* |
| Must include "new york" but not a have word start with t |
not here not |
| Lowercase not searches for "not", it is not an exclude operation |
Please refer to Lucene's official document for wildcard searches
Exact term search
When you surround text search terms with double quotes (i.ie "pandas and monkeys"), only exact matching results will be displayed.
| Search keyword | Matching attribute value | |
|---|---|---|
| "pandas and monkeys" | pandas and monkeys pandas and MONKEYS | Exactly must be the same. But not case sensitive |
| pandas and monkeys | pandas monkeys pandas monkeys monkeys pandas | any tokenized word will match |
Partial term search
Add a plus (+) sign before the terms with double quotes: +"new york"
This search matches all assets with "New York".
+"\"new york\"" wil matches "New york" is here