Class ecm.model.SearchCriterion


Extends ecm.model._ModelObject.
Represents a set of criteria that is joined by AND/OR in a search.
Defined in: <ecm\model\SearchCriteria.js>.

Constructor Summary

Constructor Attributes Constructor Name and Description
 
Constructs a search criteria object.

Field Summary

Field Attributes Field Name and Description
 
An array of values that can be assigned to the criterion.
 
An array of operators used for defining search criteria.
 
The cardinality (SINGLE or MULTIPLE).
 
An array of values, and their labels, that can be assigned to the criterion.
 
The data type of the values.
 
The default operator.
 
The default value or values.
 
The description of the attribute.
 
format 
The format applied to values.
 
Returns a human-readable description of the format pattern.
 
Indicates whether the criterion contains dependent attributes.
 
hidden 
Indicates whether the criterion is hidden.
 
itemId 
The criterion's identifier.
 
A P8 marking list for the attribute.
 
The maximum length allowed for a string value.
 
The maximum value allowed.
 
The minimum length allowed for a string value.
 
The minimum value allowed.
 
Indicates whether the attribute's value can be null.
 
A custom property editor widget class to use when creating an editor for the attribute within the ecm.widget.SinglePropertyEditorFactory.
 
Indicates whether the criterion is read-only.
 
The type of repository that is associated with this criterion.
 
The instance of ecm.model._SearchTemplateBase that contains this criterion.
 
The current operator.
 
Indicates whether the attribute is text-searchable.
 
Indicates whether the attribute uses a long column (FileNet P8 only).
 
value 
The sole value or the first value in the array of values assigned to this criterion.
 
Indicates whether the value is fixed (CMOD only).
 
Indicates whether the criterion requires a non-empty value.
 
values 
An array of values assigned to this criterion.
Fields borrowed from class ecm.model._ModelObject:
categorization, id, isRecurring, name, nameFilter, pane, status, type, userId

Method Summary

Method Attributes Method Name and Description
 
 
equals(searchCriterion)
Returns true if the other object is equal to this one.
 
An event that is triggered when the value is modified.
 
Restores the default operator and value.
 
Restores the default value.
 
setValues(values)
Sets the values of this criterion.
Methods borrowed from class ecm.model._ModelObject:
destroy, getSortCriteria, onChange, own, refresh, toString

Constructor Detail

ecm.model.SearchCriterion(properties)

Constructs a search criteria object.
Parameters:
properties
The properties for the search criteria object. The properties can be any of the public fields as defined below.
Since:
3.0.8

Field Detail

allowedValues

An array of values that can be assigned to the criterion.
Defined in: <ecm\model\SearchCriterion.js>.

availableOperators

An array of operators used for defining search criteria.
Defined in: <ecm\model\SearchCriterion.js>.

cardinality

The cardinality (SINGLE or MULTIPLE).
Defined in: <ecm\model\SearchCriterion.js>.

choiceList

An array of values, and their labels, that can be assigned to the criterion.
Defined in: <ecm\model\SearchCriterion.js>.

dataType

The data type of the values.
Defined in: <ecm\model\SearchCriterion.js>.

defaultOperator

The default operator.
Defined in: <ecm\model\SearchCriterion.js>.

defaultValue

The default value or values.
Defined in: <ecm\model\SearchCriterion.js>.

description

The description of the attribute.
Defined in: <ecm\model\SearchCriterion.js>.
Since:
2.0.2.3

format

The format applied to values.
Defined in: <ecm\model\SearchCriterion.js>.

formatDescription

Returns a human-readable description of the format pattern.
Defined in: <ecm\model\SearchCriterion.js>.
Since:
3.0

hasDependentAttributes

Indicates whether the criterion contains dependent attributes.
Defined in: <ecm\model\SearchCriterion.js>.

hidden

Indicates whether the criterion is hidden.
Defined in: <ecm\model\SearchCriterion.js>.

itemId

The criterion's identifier.
Defined in: <ecm\model\SearchCriterion.js>.

markingList

A P8 marking list for the attribute.
Defined in: <ecm\model\SearchCriterion.js>.

maxLength

The maximum length allowed for a string value.
Defined in: <ecm\model\SearchCriterion.js>.

maxValue

The maximum value allowed.
Defined in: <ecm\model\SearchCriterion.js>.

minLength

The minimum length allowed for a string value.
Defined in: <ecm\model\SearchCriterion.js>.
Since:
2.0.3

minValue

The minimum value allowed.
Defined in: <ecm\model\SearchCriterion.js>.

nullable

Indicates whether the attribute's value can be null.
Defined in: <ecm\model\SearchCriterion.js>.
Since:
2.0.3.1

propertyEditor

A custom property editor widget class to use when creating an editor for the attribute within the ecm.widget.SinglePropertyEditorFactory. For example: "mywidgets/MyPropertyEditor"
Defined in: <ecm\model\SearchCriterion.js>.
Since:
2.0.3.4

readOnly

Indicates whether the criterion is read-only.
Defined in: <ecm\model\SearchCriterion.js>.

repositoryType

The type of repository that is associated with this criterion.
Defined in: <ecm\model\SearchCriterion.js>.
Since:
2.0.2

searchTemplate

The instance of ecm.model._SearchTemplateBase that contains this criterion.
Defined in: <ecm\model\SearchCriterion.js>.
Since:
2.0.2

selectedOperator

The current operator.
Defined in: <ecm\model\SearchCriterion.js>.

textSearchable

Indicates whether the attribute is text-searchable.
Defined in: <ecm\model\SearchCriterion.js>.
Since:
2.0.3.1

usesLongColumn

Indicates whether the attribute uses a long column (FileNet P8 only).
Defined in: <ecm\model\SearchCriterion.js>.
Since:
2.0.3.1

value

The sole value or the first value in the array of values assigned to this criterion. This field should not be updated directly, use the setValues method instead.
Defined in: <ecm\model\SearchCriterion.js>.
Deprecated:
As of version 2.0.2. Use the first element of the values array, e.g., value = criterion.values && criterion.values.length ? criterion.values[0] : null.

valueFixed

Indicates whether the value is fixed (CMOD only).
Defined in: <ecm\model\SearchCriterion.js>.

valueRequired

Indicates whether the criterion requires a non-empty value.
Defined in: <ecm\model\SearchCriterion.js>.

values

An array of values assigned to this criterion. This field should not be updated directly, use the setValues method instead.
Defined in: <ecm\model\SearchCriterion.js>.

Method Detail

clone()


Defined in: <ecm\model\SearchCriterion.js>.

equals(searchCriterion)

Returns true if the other object is equal to this one.
Defined in: <ecm\model\SearchCriterion.js>.
Parameters:
searchCriterion
A ecm.model.SearchCriterion object

onValueChange()

An event that is triggered when the value is modified.
Defined in: <ecm\model\SearchCriterion.js>.
Since:
2.0.3

reset()

Restores the default operator and value.
Defined in: <ecm\model\SearchCriterion.js>.

resetValue()

Restores the default value.
Defined in: <ecm\model\SearchCriterion.js>.

setValues(values)

Sets the values of this criterion.
Defined in: <ecm\model\SearchCriterion.js>.
Parameters:
values
An array of values