Объекты DIRECTUM > Работа с поисками >

ISimpleCriterion – критерий поиска со списком значений

Предыдущий раздел В начало Следующий раздел

ISearchCriterion

 |

ISimpleCriterion

Объект ISimpleCriterion предназначен для работы с критерием поиска, который может иметь несколько значений, объединенных логическими операторами. Задать значения критериев и способы объединения значений можно с помощью строки условия поиска. Условие поиска передается в методы SetSimpleValue, SetCompleteValue, возвращается свойством AsString. Условие поиска следует задавать в соответствии с определенным форматом. Ниже перечислены общие требования к формату, которые должны соблюдаться для критериев поиска всех типов. Специальные требования к формату, характерные  для конкретного типа критериев поиска, перечислены в описании объекта-критерия поиска соответствующего типа.

Значение условия поиска задается по следующим правилам:

· все используемые операторы нечувствительны к регистру, например, слова «РАВНО», «РаВНО» или «равно» будут интерпретированы одинаково;
· в строке условия поиска должны использоваться операторы с учетом текущего языка пользовательского интерфейса, например, в русскоязычной строке необходимо использовать оператор И, а в англоязычной – AND;
· значения критерия поиска можно объединять с помощью оператора И следующим образом:

<Значение1> И <Значение2> И … И <ЗначениеN>

<Значение1> AND <Значение2> AND … AND <ЗначениеN>;

· значения критерия поиска можно объединять с помощью оператора ИЛИ следующим образом:

<Значение1> ИЛИ <Значение2> ИЛИ … ИЛИ <ЗначениеN>

<Значение1> OR <Значение2> OR … OR <ЗначениеN>;

· значения критерия поиска можно объединять с помощью оператора ВСЕ КРОМЕ следующим образом:

ВСЕ КРОМЕ (<Значение1> ИЛИ <Значение2> ИЛИ … ИЛИ <ЗначениеN>)

ALL EXCEPT (<Значение1> OR <Значение2> OR … OR <ЗначениеN>);

Для текстовых значений критерия поиска может быть дополнительно указан постфикс «; C УЧЕТОМ СЛОВОФОРМ» или «; FOR FORMS OF WORDS».

Пример использования:

// Выполнить поиск документов.

SearchFactory = Application.SearchFactory

SearchDesciption = SearchFactory.Load('EDOCUMENT_SEARCH')

Criteria = SearchDesciption.SearchCriteria

EditorCriterion = Criteria.Add('ISBEDocEditor')

EditorCriterion.SetCompleteValue('Microsoft excel ИЛИ powerpoint')

CreatedCriterion = Criteria.Add('ISBEDocCreateDate')

CreatedCriterion.SetCompleteValue('ВСЕ КРОМЕ (С 01.11.2004 09:45:46 ИЛИ РАВНО 10.06.2007)')

TextCriterion = Criteria.Add('ISBVersionData')

TextCriterion.SetCompleteValue('ЛЮБОЕ СЛОВО (документы документооборот)')

SearchFactory.Show(SearchDesciption)

Если задать строку условия поиска в неверном формате, то данное значение критерия будет отброшено. Например, если для числового критерия поиска условие будет содержать значения «Ss и 22», то поиск будет выполняться только для значения 22.

 

Свойства:

ValueCount

Values

ValuesBuildType

Наследуемые от ISearchCriterion

AsString

ContentType

QueryValue

RequisiteName

RequisiteDescription

Методы:

BuildTypeSupported

Clear

Delete

RestoreValues

SetCompleteValue

SetSimpleValue

StoreValues

См. также

Объект IDateCriterion

Объект IIntegerCriterion

Объект INumericCriterion

Объект IPickCriterion

Объект IReferenceCriterion

Объект IStringCriterion

Объект ITextCriterion