Content Management Interoperability Services (CMIS) Version 1.1

Usage:
This is a predicate function that encapsulates the full-text search capability that MAY be provided
by a repository. See the optional capability attribute capabilityQuery.
• If the repository's value for the capabilityQuery attribute is fulltextonly, then only
queries that filter based on the full-text content of documents can be fulfilled. Specifically,
only the CONTAINS() predicate function can be included in the WHERE clause.
• If the repository's value for the capabilityQuery attribute is bothseparate, then the
repository can fulfill queries that filter EITHER on the full-text content of documents OR on
their properties, but NOT if both types of filters are included in the same query.
• If the repository's value for the capabilityQuery attribute is bothcombined, then the
repository can fulfill queries that filter on both the full-text content of documents and their
properties in the same query.
Inputs:
The value of this optional parameter MUST be the name of one of the virtual tables
listed in the FROM clause for the query.
• If specified, then the predicate SHOULD only be applied to objects in the specified
virtual table, but a repository MAY ignore the value of the parameter.
• If not specified, applies to the single virtual table. If the query is a join, a server SHOULD
throw an exception if the qualifier is not specified.
The parameter MUST be a character string,
specifying the full-text search criteria.
• The Text Search Expression may be a set of terms or phrases with an optional '-' to
signal negation. A phrase is defined as a word or group of words. A group of words
must be surrounded by double quotes to be considered a single phrase.
• Terms may contain wildcards. The wildcard '*' substitutes for zero or more characters.
The wildcard '' substitutes for exactly one character. The characters '%' and '_', which
are wildcards in LIKE expressions are not considered wildcards in text serach terms.
• Terms separated by whitespace are AND'ed together.
• Terms separated by "OR" are OR'ed together.
• Implicit "AND" has higher precedence than "OR".
• Within a word or phrase, each (single-)quote must also be escaped by a preceding
backslash '\'. Using double single-quotes (") as a SQL-92 way to escape a literal singlequote
(') character SHOULD BE supported as an allowable alternative to the double
character '.
Return value:
The predicate returns a Boolean value.
• The predicate MUST return TRUE if the object is considered by the repository as "relevant"
with respect to the given parameter.
• The predicate MUST return FALSE if the object is considered by the repository as not "relevant"
with respect to the given parameter.
Constraints:
• At most one CONTAINS() function MUST be included in a single query statement. The
repository MUST throw an exception if more than one CONTAINS() function is found.
• The return value of the CONTAINS() function MAY only be included conjunctively (ANDed)
with the aggregate of all other predicates, if there is any, in the WHERE clause.
CMIS-v1.1-csprd01
Standards Track Work Product
Copyright © OASIS Open 2012. All Rights Reserved.
18 August 2012
Page 109 of 331