ZCatalog - searchResults: specifying parameters for a search query

The searchResults() method of the ZCatalog accepts parameters that define a query to be made on that catalog. A query can either be passed as keyword argument to searchResults(), as a mapping, or as part of a Zope REQUEST object, typically from HTML forms.

The index of the catalog to query is either the name of the keyword argument, a key in a mapping, or an attribute of a record object.

Attributes of record objects

query
either a sequence of objects or a single value to be passed as query to the index (mandatory)
operator
specifies the combination of search results when query is a sequence of values. (optional, default: or).
Allowed values:
and, or
for Keyword Indexes and Path Indexes
and, or, andnot, near
for Text Indexes
range
defines a range search on a Field Index (optional, default: not set).
Allowed values:
min
Searches for all objects with values larger than the minimum of the values passed in the query parameter.
max
Searches for all objects with values smaller than the maximum of the values passed in the query parameter.
minmax
Searches for all objects with values smaller than the maximum of the values passed in the query parameter and larger than the minimum of the values passwd in the query parameter.
level
only applies to Path Index. Specifies the directory level to start searching. (optional, default: 0)

Parameters for searchResults():

optimize
ZCatalog performs a query optimization for queries not passed through the web (either as dictionary or mapping). To disable this optimization set optimize to 0 (optional, default: 1). Optimization is disabled for searches through the web.