Фильтр по полю многострочного ввода
Назначение
Фильтр по полю многострочного ввода - это видоизмененная компонента Многострочное поле, дополненная функцией поиска в связанной с ней компоненте Таблица по введенному пользователем значению. Иерархически обязательно должна быть расположена внутри компоненты Набор фильтров, в качестве параметра содержит указание на колонку таблицы, по которой осуществляется поиск. В зависимости от настроек родительской компоненты Набор фильтров в запущенном приложении выполняет поиск либо только после нажатия соответствующей кнопки (компонента Кнопка для фильтрации), либо по мере ввода пользователем искомого значения (так называемый, “живой поиск”).
Компонента Фильтр по полю многострочного ввода находится в разделе Фильтры - Фильтр по полю многострочного ввода.
Свойства
Компонента имеет набор общих свойств. Ниже отображены свойства, специфичные только для данной компоненты.
| Наименование свойства | Назначение свойства | Принимаемые значения |
|---|---|---|
| Подсказка | позволяет создать подсказку, расположенную внутри элемента | пример возможного значения: Введите название организации |
| Надпись | позволяет задать наименование поля, которое будет отображаться на странице | пример возможного значения: Наименование организации |
| Значение | позволяет задать значение поля по умолчанию | пример возможного значения: ООО “Форт” |
| Максимальная длина | задаёт максимальное количество вводимых символов в поле | пример возможного значения: 10 |
| Маска ограничивающая ввод | позволяет задать маску, в соответствии с которой пользователь будет осуществлять ввод текста | выставление маски не может обеспечить выполнение требования обязательности ввода, маска только внешне отфильтровывает и форматирует последовательность вводимых пользователем символов заранее заданным образом (например, ввод тел. номера “+ 7 (917) - 101 - 02 - 03” вместо “8917010203” или не допустит такого ввода “89170102АЯ”). См. ниже |
| Оперировать немаскированными данными | указывает системе порядок обработки символов маски при сохранении значения поля в базу данных |
|
| Регистр | позволяет задать вид регистра вводимого текста |
|
| Тип | позволяет задать тип вводимого текста |
|
| регулярное выражение | позволяет задать проверку вводимого текста с помощью регулярных выражений | См. ниже |
| Операция | позволяет задать условие, по которому будет осуществляться фильтрация данных по введенному пользователем значению | |
| Фильтровать по … | В данном свойстве выбирается таблица и колонка к которой будет применяться фильтрация. Выбор таблице в данном свойстве будет доступен после заполнения свойства “Применить к…” у Набор фильтрации |
Примеры масок:
- A (буква, латинская, регистр не имеет значения) в маске - позволит ввести в поле одну любую букву любого алфавита
- Б (буква, русская, в верхнем регистре) в маске - позволит ввести в поле одну любую букву русского алфавита
- 9 (цифра) в маске - позволит ввести в поле одну любую цифру
- * (символ) в маске - позволит ввести в поле одну любую цифру или букву
- R (буква, латинская, в верхнем регистре) в маске - позволит ввести в поле одну римскую цифру
- ? (символ) в маске - позволит ввести или опустить при вводе в поле один необязательный символ (букву, цифру) ,например 999?9; под эту маску подходит как 123, так и 1234
Например, необходимо задать форматирование ввода маской для значения Й456QЬ. В данном случае маска будет выглядеть следующим образом: А999АА, где А - латинская буква.
Некоторые типовые регулярные выражения:
- \d [0-9]- одна цифра от 0 до 9
- \D [^0-9]- любой символ кроме цифры
- \s- пробел
- [A-Z]- только заглавная латинская буква
- [A-Za-z]- только латинская буква в любом регистре
- [А-Яа-яЁё]- только русская буква в любом регистре
- [A-Za-zА-Яа-яЁё]- любая буква русского и латинского алфавита
- [0-9]{3}- три цифры
- [A-Za-z]{6,}- не менее шести латинских букв
- [0-9]{,3}- не более трёх цифр
- [0-9]{5,10}- от пяти до десяти цифр
- ^[a-zA-Z]+$- любое слово на латинице
- ^[А-Яа-яЁё\s]+$- любое слово на русском включая пробелы
- ^[ 0-9]+$- любое число
Например, чтобы ограничить возможность ввода и сохранения текста латиницей, можно использовать регулярное выражение^[А-Яа-яЁё\s]+$
Функции
В ходе настройки свойств компоненты (заданных по умолчанию) может оказаться недостаточно для выполнения поставленной задачи и получения необходимого результата.
Для каждой компоненты предусмотрен перечень функций, расширяющих её базовую функциональность, которые можно добавить нажатием кнопки Добавить скрипт.
Вследствие технических особенностей реализации функций (функции, которые выполняются удаленно на сервере приложений, функции, которые выполняются в браузере пользователя), они имеют разные иконки, но это никак не влияет на их функциональность или предпочтительность использования.
Сохранить значение в переменную процесса
Заполнить значением из переменной процесса
Заполнить значением по умолчанию
Склеить несколько значений
Определить права текущего пользователя
Определить роли текущего пользователя
Определить роли текущего пользователя
Методические рекомендации по применению
Часто задаваемые вопросы
| Вопрос | Ответ |
|---|---|
| Можно ли ввести число в Фильтр по полю многострочного ввода | Да, можно. |
| Как можно ограничить количество ввода символов в поле? | Для этого необходимо заполнить свойство "Максимальная длина |
| Как можно расширить поиск вфильтрациипо полю многострочного ввода из приложения | Поиск можно расширить с помощью проставлениязнака "%"рядом с вводимым значением в поле фильтрации. Пример приведен в статье по фильтрации по текстовому полю |