Фильтр по полю многострочного ввода

Назначение

Фильтр по полю многострочного ввода - это видоизмененная компонента Многострочное поле, дополненная функцией поиска в связанной с ней компоненте Таблица по введенному пользователем значению. Иерархически обязательно должна быть расположена внутри компоненты Набор фильтров, в качестве параметра содержит указание на колонку таблицы, по которой осуществляется поиск. В зависимости от настроек родительской компоненты Набор фильтров в запущенном приложении выполняет поиск либо только после нажатия соответствующей кнопки (компонента Кнопка для фильтрации), либо по мере ввода пользователем искомого значения (так называемый, “живой поиск”).

Компонента Фильтр по полю многострочного ввода находится в разделе Фильтры - Фильтр по полю многострочного ввода.

Свойства

Компонента имеет набор общих свойств. Ниже отображены свойства, специфичные только для данной компоненты.

Наименование свойства Назначение свойства Принимаемые значения
Подсказка позволяет создать подсказку, расположенную внутри элемента пример возможного значения: Введите название организации
Надпись позволяет задать наименование поля, которое будет отображаться на странице пример возможного значения: Наименование организации
Значение позволяет задать значение поля по умолчанию пример возможного значения: ООО “Форт”
Максимальная длина задаёт максимальное количество вводимых символов в поле пример возможного значения: 10
Маска ограничивающая ввод позволяет задать маску, в соответствии с которой пользователь будет осуществлять ввод текста выставление маски не может обеспечить выполнение требования обязательности ввода, маска только внешне отфильтровывает и форматирует последовательность вводимых пользователем символов заранее заданным образом (например, ввод тел. номера “+ 7 (917) - 101 - 02 - 03” вместо “8917010203” или не допустит такого ввода “89170102АЯ”). См. ниже
Оперировать немаскированными данными указывает системе порядок обработки символов маски при сохранении значения поля в базу данных
  • значение не определено - по умолчанию
  • сохранять без форматирования маской
  • сохранять с форматированием маской
Значение, отформатированное маской в поле ввода как “+7~(917)-922-33-44”, может быть сохранено в поле таблицы базы данных как “+7~(917)-922-33-44” (если флажок снят) или как “9179223344” (если флажок выставлен)
Регистр позволяет задать вид регистра вводимого текста
  • в верхнем регистре - заглавные (прописные) буквы
  • в нижнем регистре - строчные (маленькие) буквы
  • первая буква - заглавная
Тип позволяет задать тип вводимого текста
  • обычный текст
  • пароль (заполнитель - звездочки)
  • электронная почта
регулярное выражение позволяет задать проверку вводимого текста с помощью регулярных выражений См. ниже
Операция позволяет задать условие, по которому будет осуществляться фильтрация данных по введенному пользователем значению
Фильтровать по … В данном свойстве выбирается таблица и колонка к которой будет применяться фильтрация. Выбор таблице в данном свойстве будет доступен после заполнения свойства “Применить к…” у Набор фильтрации

Примеры масок:

Например, необходимо задать форматирование ввода маской для значения Й456QЬ. В данном случае маска будет выглядеть следующим образом: А999АА, где А - латинская буква.

Некоторые типовые регулярные выражения:

Например, чтобы ограничить возможность ввода и сохранения текста латиницей, можно использовать регулярное выражение^[А-Яа-яЁё\s]+$

Функции

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

Для каждой компоненты предусмотрен перечень функций, расширяющих её базовую функциональность, которые можно добавить нажатием кнопки Добавить скрипт.

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

Сохранить значение в переменную процесса

Сохранить значение в переменную процесса

Заполнить значением из переменной процесса

Заполнить значением из переменной

Заполнить значением по умолчанию

Заполнить значением по умолчанию

Склеить несколько значений

Склеить несколько значений

Определить права текущего пользователя

Определить права текущего пользователя

Определить роли текущего пользователя

Определить роли текущего пользователя

Методические рекомендации по применению

Часто задаваемые вопросы

Вопрос Ответ
Можно ли ввести число в Фильтр по полю многострочного ввода Да, можно.
Как можно ограничить количество ввода символов в поле? Для этого необходимо заполнить свойство "Максимальная длина
Как можно расширить поиск вфильтрациипо полю многострочного ввода из приложения Поиск можно расширить с помощью проставлениязнака "%"рядом с вводимым значением в поле фильтрации. Пример приведен в статье по фильтрации по текстовому полю