Свойство AddWhere – дополнительные ограничения в критерии поиска
Contents
Синтаксис:
rw property AddWhere: WideString; |
Описание:
Свойство предоставляет доступ к дополнительным ограничениям в критерии поиска. Свойство следует задавать в формате where-условия SQL-запроса:
{(<Условие1>) [and/or/xor (<Условие2>)]}[,...n]
Условие1, Условие2 – простые условия, формируемые по следующему формату:
[not ]<Имя поля> {<Оператор> <Значение>}|{is null}|{like <Значение>}|[between <Значение1> and <Значение2>}|{in ({<Значение>}[,...n])}
где
| • | Имя поля – имя или псевдоним поля набора данных. Если для поля не указан псевдоним и имя поля неуникально, то перед именем поля следует указывать имя или псевдоним таблицы в формате <Имя таблицы>.<Имя поля>. В условии можно использовать поля таблиц, указанных в разделе from. Имена и псевдонимы полей и таблиц можно получить с помощью свойств: |
| • | Псевдоним поля - IRequisite.FieldName; |
| • | Имя поля - IField.SQLFieldName, IRequisite.SQLFieldName; |
| • | Псевдоним таблицы - IObject.TableName, IDataSet.TableName; |
| • | Имя таблицы - IObject.SQLTableName, IDataSet.SQLTableName; |
| • | Оператор - один из следующих операторов: =, <, >, <=, >=, <>; |
| • | Значение - значение соответствующего типа. |
Для формирования параметра удобно использовать функцию Format.
При установке свойства добавляемое условие объединяется с уже имеющимися условиями при помощи операции «and».
Перенос строки является разделителем условий. В SQL-запросе условия объединяются с помощью and.
Примечание
При записи свойства не из ISBL-вычислений или из ISBL-вычислений с подключением к системе DIRECTUM, отличной от текущей, значение параметра должно строго соответствовать формату. В противном случае будет сгенерировано исключение.
Пример:
// Поиск заданий, исполнителем которых является текущий пользователь.
CurrentUserID = Sender.Application.EDocumentFactory.CurrentUser.ID
Sender.SearchCriteria.AddWhere = Sender.SearchCriteria.AddWhere & CR & "Jobs.Executor = " & CurrentUserID
Свойство AddFrom Свойство IDataSet.SQLTableName Свойство IDataSet.TableName Свойство IObject.SQLTableName Свойство IObject.TableName Свойство IRequisite.SQLFieldName |
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |