Wildcard search

This page is about Assets & Inventory Plugin for Jira DC. Using Cloud? Click here.

This guide explains how to use wildcard characters for advanced searches in Asset Navigator. Wildcards allow you to find assets that match specific patterns within their names or descriptions. This functionality is especially helpful when you're unsure of the exact wording but have a good idea of what you're looking for.

These features are updated at AIP v7.0.3. Wildcards search with * and ? works for older versions also.

Supported wildcards

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 wildcard searches in the middle of a term.	`te*t`

Escaping special characters for text search

Lucene, the search engine behind Asset Navigator, uses some characters for its own purposes. It supports escaping special characters that are part of the query syntax. The current list of special characters are: *, ?, \,

To escape these characters, use the \ before the character. For example, to search for Ab\Cd*xZ, use the query: ab\\cd\*xz.

Example 1:

We have the 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
*est	Server alpha test Alpha sever test	Matches all words end with est. (Leading wildcard is allowed at version 7.0.3)
t*t	Server alpha test Alpha sever test	Matches all words starts with t and ends with t.
es	Server alpha test Alpha sever test	Matches all words with es.
test	Alpha sever test Server alpha test
server test	Alpha sever test Server alpha test
"server test"	Alpha sever test	Query between double quotes.
tester	App tester beta
teste*	App tester beta
tes?	Alpha sever test Server alpha test	Only one character matches for question mark, so "tester" does not return.

If you have an asset with the name ab-x1, you can search for ab-*
To search for words starting with ", use query: \"*

Example 2:

We have the 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"	New York one	Exact search
"new york" NOT two	New York one New York Not Here	Must include "new york" but not two
"new york" NOT t*	New York one New York Not Here	Must include "new york" but not a have word start with t
not here not	New York Not Here	Lowercase not searches for "not", it is not an exclude operation
* NOT two	New York one New York Not Here	All assets but not includes two

Exact term search

When you surround text search terms with double quotes (for example, "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. It’s not case-sensitive.

pandas and monkeys

pandas

monkeys

pandas monkeys

monkeys pandas

Any tokenized word will match.

Partial term search

Surround search term with double quotes and use it with other search terms: "new york" one matches having "new york" or one.

To search only a partial search, add a plus (+) sign before the terms with double quotes: +"new york". This search matches all assets with New York but not New Delhi.

Do not escape special characters if the search term includes them +"\"new york\"" wil match "New york" is here.