Общие сведения

Расширенные фильтры служат для фильтрации данных датасета в пределах какой-либо сущности приложения, использующей этот датасет. Например это такие сущности, как компоненты проекта виджет, таблица, HTML-объект, SVG-объект. Когда используется расширенный фильтр, при работе с сущностью доступны только данные, удовлетворяющие фильтру.

Расширенный фильтр представляет собой список правил. Правило фильтра состоит из колонки датасета, условия проверки и проверяемого значения. Когда правил в списке больше одного, они связываются логическими операторами «AND» и «OR». Количество правил в фильтре не ограничено. Запись датасета удовлетворяет фильтру, когда она удовлетворяет какому-либо правилу или связке правил.

Расширенный фильтр автоматически очищается при смене используемого сущностью приложения датасета.








Оператор «AND» имеет приоритет над оператором «OR». Сначала проверяются все правила, связанные оператором «AND», затем – оператором «OR».



Чтобы изменить порядок проверки правил, их следует поместить в группу. Группа правил может содержать вложенные группы. Количество групп и уровней вложений не ограничивается. Проверка правил начинается с самого нижнего уровня вложенности. Результат проверки группы правил используется так же, как результат проверки правила.



Настройка расширенного фильтра доступна из окна настройки сущности, в блоке «Фильтры». Когда фильтр не содержит правил, в блоке отображается кнопка «Добавить фильтр», иначе отображается кнопка «Редактировать фильтр».


Создание правил и групп

Когда фильтр для сущности пустой (не содержит правил), окно настройки фильтра предлагает создать правило или группу правил, нажав соответствующую кнопку.



Когда в фильтре есть правило или группа, последующие правила и группы можно создавать:

  • нажимая соответствующие кнопки в блоке «Создать» под последним правилом или группой – правило или группа создается в конце списка;
  • нажимая кнопку «+» слева от правила или группы и выбирая соответствующие варианты в выпадающем меню – для правила создается правило или группа под этим правилом, для группы создается правило или группа в этой группе.




Удаление правил и групп, очистка фильтра

Удалить правило или группу из фильтра можно, нажав кнопку  для правила или группы. При этом при удалении группы запрашивается подтверждение.



Полностью очистить фильтр от правил и групп можно нажатием кнопки «Очистить» в нижнем левом углу окна настройки фильтра. При очистке фильтра всегда запрашивается подтверждение.

Настройка правила

Когда правило добавлено, его необходимо настроить – выбрать колонку датасета, по которой следует выполнять проверку, выбрать условие проверки и задать проверяемое условием значение.

Все поля правила должны быть заполнены.



Выпадающий список набора условий проверки зависит от типа данных выбранной ранее колонки датасета.

СтрокаЧислоДатаБулево
  • Равно;

  • Не равно;

  • Принадлежит множеству;

  • Не принадлежит множеству;

  • Содержит (с учетом регистра);
  • Содержит (без учета регистра);

  • Не содержит (с учетом регистра);
  • Не содержит (без учета регистра);

  • Начинается с (с учетом регистра);

  • Начинается с (без учета регистра);
  • Не начинается с (с учетом регистра);

  • Не начинается с (без учета регистра);

  • Заканчивается на (с учетом регистра);

  • Заканчивается на (без учета регистра);
  • Заканчивается не на (с учетом регистра);

  • Заканчивается не на (без учета регистра)

  • Равно;
  • Не равно;
  • Больше;
  • Меньше;
  • Больше или равно;
  • Меньше или равно;
  • Принадлежит к множеству;

  • Не принадлежит к множеству;

  • Входит в диапазон;
  • Не входит в диапазон
  • Равно;

  • Не равно;

  • Больше;

  • Меньше;
  • Больше или равно;
  • Меньше или равно;

  • Принадлежит к множеству;

  • Не принадлежит к множеству;

  • Входит в период;

  • Не входит в период.

  • Равно;
  • Не равно;
  • Принадлежит к множеству;
  • Не принадлежит к множеству



Формат поля для задания проверяемого значения зависит от выбранного условия проверки.

СтрокаЧислоДатаБулево
УсловиеФормат поляУсловиеФормат поляУсловиеФормат поляУсловиеФормат поля
  • Равно;

  • Не равно

Селект

  • Входит в диапазон;
  • Не входит в диапазон

Поля ввода

  • Входит в период;
  • Не входит в период

Поля ввода с
календарем
  • Равно;
  • Не равно
Селект
  • Содержит (с учетом регистра);
  • Содержит (без учета регистра);

  • Не содержит (с учетом регистра);
  • Не содержит (без учета регистра);

  • Начинается с (с учетом регистра);

  • Начинается с (без учета регистра);
  • Не начинается с (с учетом регистра);

  • Не начинается с (без учета регистра);

  • Заканчивается на (с учетом регистра);

  • Заканчивается на (без учета регистра);
  • Заканчивается не на (с учетом регистра);

  • Заканчивается не на (без учета регистра)

Поле ввода

  • Равно;
  • Не равно;
  • Больше;
  • Меньше;
  • Больше или равно;
  • Меньше или равно
Поле ввода
  • Равно;

  • Не равно;

  • Больше;

  • Меньше;
  • Больше или равно;
  • Меньше или равно

Поле ввода с
календарем

  • Принадлежит к множеству;

  • Не принадлежит к множеству

Мультиселект

  • Принадлежит к множеству;

  • Не принадлежит к множеству

Мультиселект

  • Принадлежит к множеству;

  • Не принадлежит к множеству

Мультиселект

  • Принадлежит к множеству;
  • Не принадлежит к множеству
Мультиселект


Null и нуль

Правило «не равно 0» исключает как строку со значением 0, так и строку со значением null. Чтобы исключить строки со значением 0 и включить строки с null, используйте следующее сочетание правил.


Группировка

Чтобы группировать правила и группы, созданные вне группы, захватывайте их за элемент  и перетаскивайте в группу или на группу. Чтобы создавать в группе новые правила или группы, используйте кнопку «+» для этой группы.

Группа должна содержать хотя бы одно правило или группу.





Вы можете сворачивать и разворачивать группы в процессе редактирования фильтра. По открытию окна настройки фильтра состояние всех групп по умолчанию развернутое.

Настройка логического оператора

Кнопка логического оператора автоматически отображается у всех правил и групп в списке, кроме последнего элемента списка. По умолчанию используется логический оператор «AND». Нажимайте кнопку оператора, чтобы переключаться между операторами «AND» и «OR».

Сохранение фильтра

Чтобы сохранить сделанные изменения, нажмите кнопку «Сохранить» в нижнем правом углу окна настройки фильтра. По нажатию кнопки правила и группы валидируются, и не прошедшие валидацию элементы выделяются красным.