Свойство Filter – локальный фильтр
Contents
Синтаксис:
rw property Filter: WideString; |
Описание:
Локальный фильтр позволяет упростить поиск и выборку записей. Свойство предоставляет возможность настраивать фильтр по значениям реквизитов набора данных. Текст фильтра содержит одно или несколько имен реквизитов, на которые накладываются ограничения с помощью операций, приведенных в таблице:
Операция |
Пример фильтра |
Комментарий |
||||
|---|---|---|---|---|---|---|
= |
Country = 'RU' |
|
||||
<> |
Country <> 'RU' |
|
||||
>= |
DateEntered >= '01.11.1998' |
|
||||
<= |
Total <= 100000 |
|
||||
> |
Percentile > 50 |
|
||||
< |
Summa < 100 |
|
||||
is null |
Date is null |
|
||||
is not null |
Date is not null |
|
||||
And |
Country = 'RU' and DateEntered >= '01.11.1998' |
|
||||
Or |
Country = 'RU' or Country = 'US' |
|
||||
Not |
not (Country = 'RU') |
|
||||
+ |
Total + 5 > 100 |
|
||||
– |
Summa - 7 <> 10 |
|
||||
* |
Discount * 100 > 20 |
|
||||
/ |
Discount > Total / 5 |
|
||||
In |
Day in (1,11,21) |
Проверяет, является ли значение первого аргумента одним из значений из списка значений второго аргумента |
||||
like |
Country like '%A_C%' |
Проверяет соответствие строки шаблону. В шаблоне используются следующие обозначения:
|
Чтобы применить фильтр по строке, содержащей апостроф, необходимо продублировать апостроф в строке, заключить строку в апострофы, а полный текст фильтра – в кавычки. Например, чтобы отфильтровать справочник Работники таким образом, чтобы найти записи, у которых в реквизите Наименование содержится строка «Самюэль Это'о Фис», необходимо установить фильтр:
"[Наименование] = 'Самюэль Это''о Фис'"
Применить фильтр по строке, содержащей кавычки, невозможно.
При сравнении строк регистр букв не учитывается, т.е. строки «ABCDEFG» и «AbCdEfG» равнозначны.
Чтобы применить фильтр к записям, установите свойство Filtered в True. Фильтр является локальным, т.е. применяется после открытия набора данных и не приводит к повторному выполнению запроса на SQL-сервере.
Примечание
Фильтр можно накладывать только на те реквизиты, которые были загружены с сервера при открытии набора данных. У таких реквизитов свойство IRequisite.Preloaded установлено в True. Если какой-либо реквизит необходимо включить в фильтр, то нужно убедиться, что он загружается по умолчанию, либо явно установить свойство IRequisite.Preloaded в True в событии «Набор данных. Открытие».
Пример:
// Фильтр записей справочника «Работники», у которых строка в реквизите
// «Наименование» начинается со слова «Иванов»
Employees = References.ReferenceFactory('РАБ').GetComponent
Employees.Open
Employees.Filter = '[Наименование] like "Иванов%"'
Employees.Filtered = TRUE
Employees.ComponentForm.ShowModal
Свойство Filtered |
| © Компания DIRECTUM, 2018 | Сообщество пользователей DIRECTUM |