Текстовое поле (фильтр)

Назначение

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

Компонента Текстовое поле (фильтр) находится в разделе Фильтры - Текстовое поле (фильтр).

Свойства

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

Наименование свойства	Назначение свойства	Принимаемые значения
Подсказка	позволяет создать подсказку, расположенную внутри элемента	пример возможного значения: Введите название организации
Надпись	позволяет задать наименование поля, которое будет отображаться на странице	пример возможного значения: Наименование организации
Значение	позволяет задать значение поля по умолчанию	пример возможного значения: ООО “Форт”
Максимальная длина	задаёт максимальное количество вводимых символов в поле	пример возможного значения: 10
Оперировать немаскированными	указывает системе порядок обработки символов маски при сохранении значения поля в базу данных	значение не определено- по умолчанию сохранять без форматирования маской сохранять с форматированием маской Значение, отформатированное маской в поле ввода как “+7~(917)-922-33-44”, может быть сохранено в поле таблицы базы данных как “+7~(917)-922-33-44” (если флажок снят) или как “9179223344” (если флажок выставлен)
Маска, ограничивающая ввод	позволяет задать маску, в соответствии с которой пользователь будет осуществлять ввод текста	выставление маски не может обеспечить выполнение требования обязательности ввода, маска только внешне отфильтровывает и форматирует последовательность вводимых пользователем символов заранее заданным образом (например, ввод тел. номера “+ 7 (917) - 101 - 02 - 03” вместо “8917010203” или не допустит такого ввода “89170102АЯ”). Примеры масок: A (буква, латинская, регистр не имеет значения) в маске - позволит ввести в поле одну любую букву любого алфавита Б (буква, русская, в верхнем регистре) в маске - позволит ввести в поле одну любую букву русского алфавита 9 (цифра) в маске - позволит ввести в поле одну любую цифру * (символ) в маске - позволит ввести в поле одну любую цифру или букву R (буква, латинская, в верхнем регистре) в маске - позволит ввести в поле одну римскую цифру [ ] (внутри квадратных скобок) в маске - позволит ввести или опустить при вводе в поле один или несколько необязательных символов (букву, цифру), например 999[9]; под эту маску подходит как 123, так и 1234 Например, необходимо задать форматирование ввода маской для значения Й456QЬ. В данном случае маска может выглядеть следующим образом: Б999АА, где А - латинская буква.
Регистр	позволяет задать вид регистра вводимого текста:	В верхнем регистре - заглавные (прописные) буквы. В нижнем регистре - строчные (маленькие) буквы. Первая буква - заглавная
тип	позволяет задать тип вводимого текста	обычный текст. Пароль (заполнитель - звездочки). Электронная почта
Регулярное выражение или Pattern	позволяет задать проверку вводимого текста с помощью регулярных выражений поля, для которых не выполняются условия заданных регулярных выражений, при сохранении записи подсвечиваются красным оттенком и операция отменяется.	Некоторые типовые регулярные выражения: \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]+$
Операция	позволяет задать условие, по которому будет осуществляться фильтрация данных по введенному пользователем значению
Фильтровать по…	позволяет указать таблицу и колонку базы данных, к которой будет применяться фильтрация	выбор таблицы и колонки базы данных в данном свойстве будет доступен только после заполнения свойства “Применить к…” у Набора фильтрации

Функции

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

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

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

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

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

Добавить строку к значению в текущем поле

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

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

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

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

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

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

Как добавить элемент Фильтр по текстовому полю на страницу?

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

Вопрос	Ответ
В каких случаях необходимо использовать Фильтр по текстовому полю, а в каких случаях Фильтр по числовому полю?	В зависимости от типа значений, по которым происходит фильтрация определяется соответствующий тип Фильтра: если значения в колонке таблицы имеют строковый тип данных, то используется Фильтр по текстовому полю, если числовой - Фильтр по числовому полю.
Можно ли ввести число в Текстовое поле (фильтр)?	Да, можно.