Nuxeo documents can be searched using full-text queries; the standard way to do so is to use the top-right "quick search" box in the Nuxeo Platform. Search queries are expressed in a Nuxeo-defined syntax, described below.
Nuxeo Full-Text Query Syntax
A full-text query is a sequence of space-separated words. In addition:
- Words are implicitly
- A word can start with
-to signify negation (the word must not be present).
- A word can end with
*to signify prefix search (the word must start with this prefix). Ending a word with
*for prefix search is also supported for historical reasons
- You can use
ORbetween words (it has a lower precedence than the implicit
- You can enclose several words in double quotes
"for a phrase search (the words must exactly follow each other).
Documents containing both
world and which do not contain
hello world -smurf
hello and a word starting with
Documents containing both
world, or documents containing
smurf but not containing
hello world OR smurf -black
hello followed by
world and also containing
"hello world" smurf
Important Notes and Limitations
The following limitations apply:
- A query term (sequence of
AND-ed words without an
OR) containing only negations will not match anything.
- Depending on the back-end database and its configuration, different word stemming strategies may be used, which means that
universal(for instance) may or may not be considered the same word. Check your database configuration for more on this, and the "analyzer" parameter used in the Nuxeo configuration for your database.
- Phrase search using a PostgreSQL back-end database is supported and cannot use word stemming (i.e. a query of
"hello worlds"will not match a document containing just
hello worldwithout a final
s). This is due to way this feature is implemented, which is detailed at NXP-6720.
- MongoDB does not support prefix matching, so a query for
hel*will not match
Using Full-Text Queries in NXQL
In NXQL the full-text query is part of a WHERE clause that can contain other matches on metadata. Inside the WHERE clause, a full-text query for "something" (as described in the previous section) can be expressed in several ways:
ecm:fulltext = 'something'
ecm:fulltext_someindex = 'something'if an index called "someindex" is configured in the Repository configuration
ecm:fulltext.somefield = 'something'to search a field called "somefield", using full-text if the VCS configuration contains a single index for it, or if not using fallback to a standard SQL ILIKE query:
somefield ILIKE '%something%'(ILIKE is a case-independent LIKE). Note that this will have a serious performance impact if no full-text is used, and is provided only to help migrations from earlier versions.
ecm:fulltext LIKE 'something'is deprecated but identical to
ecm:fulltext = 'something'.
With an Elasticsearch page provider, the full-text syntax used is the Elasticsearch simple query string syntax. It is recommended to use the prefix
es: when making such use of the syntax, as in the future it might be mandatory. Further more, any full-text request made with an
es: prefix will be doing an "OR" between each word (vs AND otherwise). You can refer to the Elasticsearch documentation page for more details on the syntax that can be used.