Query Syntax

By default Voyager searches over all text (including metadata) for matching items. Results that match the title or path are ranked above results matching any other text. To customize the default field weights, see Query Settings

In addition to the default behavior, Voyager supports explicit operators and field selection

Operators

OR

The OR operator is the default search operator. This means that if there is no operator between two terms in a search, the OR operator is used. The OR operator links two terms and finds a matching document if either of the terms exist in a document.

For example, to search for documents that contain either "Florida highways" or just "highways" use the query:

or

AND

The AND operator matches documents where both terms exist anywhere in the text of a single document.

For example, to search for documents that contain "rivers" and "lakes" use the query:

Fields

Voyager supports fielded data. When performing a search you can either specify a field name, or use the default search which uses many fields.
You can search any field by typing the field name in lowercase followed by a colon ":" and then the term you are looking for.
Searching by field names only produces results that match the particular field specified.

For example, to search for  any documents with "Rivers" in the name field and "Florida" in the path field, use the query:

Note: The field is only valid for the term that it directly precedes, so the query

Will only find "major" in the name field. It will find "cities" using the default search which uses many fields.

To search for 2 or more terms in a field name, quotes around the text are required. For example, to search the name field for "major cities", use the query:

Search by path

Paths in voyager can either be searched for using the standard field selection operator ":", or a special "=" operator that matches folders explicitly.

Using the standard "path:" syntax, the query is looking for words in the path. For example:

Will return items with "Desktop" in the path.

Using the "=" operator will find files explicitly in a folder. For example:

Will find all results under this folder. Aditionally, the path= syntax triggers a special Path Navigation UI.

Wildcards

Voyager supports single and multiple character wildcard searches within single terms.

To perform a single character wildcard search use the "?" symbol.

To perform a multiple character wildcard search use the "*" symbol.

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

Multiple character wildcard searches looks for 0 or more characters. For example, to search for counties or countries, you can use the search:

Escaping Special Characters

Voyager 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 (1+1):2 use the query:

Lucene Query Syntax

Text searches in Voyager are based on Lucene style syntax. So users can use operators, specific field names or wildcards to produce the results they require.

For more information about Lucene style syntax please refer to the following link: http://lucene.apache.org/java/3_0_1/queryparsersyntax.html