Текстовое поле

Назначение

Текстовое поле - это компонента, которая используется для отображения и ввода однострочного текста на форме страницы.

В зависимости от настройкисвойств, включенных по умолчанию в состав компоненты, компонента Текстовое поле может использоваться для:

Для сохранения введенной информации в базу данных и отображения значения из базы данных (в данном случае, функция компоненты Текстовое поле. Сохранение значения должна быть включена) (рис.2)
Для отображения текста, который был введен пользователем приложения или является константой, определённой в логике приложения (в данном случае, функция компоненты Текстовое поле. Сохранение значения должна быть выключена или удалена через настройки функции по кнопке) (рис.3)

Компонента Текстовое поле находится в разделе Компоненты - Поля - Текстовое поле.

Свойства

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

Наименование свойства	Назначение свойства	Принимаемые значения
Подсказка	позволяет создать подсказку, расположенную внутри элемента	пример возможного значения: Введите название организации
Надпись	позволяет задать наименование поля, которое будет отображаться на странице	пример возможного значения: Наименование организации
Значение	позволяет задать значение поля по умолчанию	пример возможного значения: ООО “Форт”
Максимальная длина	задаёт максимальное количество вводимых символов в поле	пример возможного значения: 10
Минимальная длина (Min length)	задаёт минимальное количество вводимых символов в поле
allowMoreSymbols	при true позволяет пользователю ввести больше символов, чем значение максимальной длины, но при этом поле станет невалидным и будет отображено сообщение об ошибке maxLengthErrorMsg (см. документацию)	логическое значение (true, false)
Оперировать немаскированным значением	указывает системе порядок обработки символов маски при сохранении значения поля в базу данных	значение не определено - по умолчанию активно - сохранять без форматирования маской пустое - сохранять с форматированием маской Значение, отформатированное маской в поле ввода как “+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АА, где А - латинская буква.
Регистр	позволяет задать вид регистра вводимого текста:	в верхнем регистре - заглавные (прописные) буквы в нижнем регистре - строчные (маленькие) буквы первая буква каждого слова заглавная только первая буква текста заглавная, остальные строчные первая буква текста заглавная
Тип	позволяет задать тип вводимого текста:	обычный текст пароль (заполнитель - звездочки) электронная почта URL
Регулярное выражение или 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]+$
patterErrorMsg, maxLengthErrorMsg, minLengthErrorMsg, emailErrorMsg, urlErrorMsg	позволяют задать пользовательское сообщение о соответствующих ошибках валидации	строка

Свойство Текстовое поле. Сохранение значения

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

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

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

Базовые функции

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

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

Дополнительные функции

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

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

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

Настройка

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

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

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

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

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

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

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

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

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

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

Вопрос	Ответ
Чем отличается компонента Текстовое поле от компоненты Текст?	Компонента текст используются для отображения статического текста на странице, текстовое поле используется для отображения и ввода текста.
Все ли свойства компоненты обязательны для заполнения?	Нет. Свойства компоненты определяются в зависимости от решаемой задачи.
Возникнет ли ошибка при запуске приложения, если оставить незаполненным свойство Текстовое поле. Сохранение значения?	Да. В случае, если функция “Текстовое поле. Сохранения значения” включена у элемента и не заполнены ее параметры, то при валидации проекта возникнет ошибка. Если по условию задачи данное поле не должно подгружаться и сохраняться в базу данных, данную функцию в компоненте необходимо либо отключить либо удалить.
Чем отличается регулярное выражение от маски?	Маска даёт простое и наглядное представление правила ввода с подстановкой дополнительных символов, а регулярное выражение позволяет задать более сложный шаблон с дополнительными условиями. Необходимо отметить, что поля, для которых не выполняются условия заданных регулярных выражений, при сохранении записи подсвечиваются красным оттенком и операция отменяется.
Если удалить базовые функции, которые включены в компоненту по умолчанию, например, “Заполнить значением по умолчанию” можно ли будет вновь их добавить?	Да. Если удалить какую-то базовую функцию компоненты, то по кнопке “Добавить функцию” она будет доступна для выбора.
Все ли типы переменных можно записать в текстовое поле?	Нет. Вслучае с текстовым полем, используется строковый тип переменной (string).
Какую функцию необходимо добавить, чтобы сохранить значение из текстовогополя в переменную процесса?	Для того чтобы сохранить значение из текстового поля в переменную процесса необходимо по кнопке “Добавить функцию” выбрать в списке функцию “Сохранить значение в переменную процесса любого типа”, выбрав в настройке добавленной функции необходимую переменную строкового типа (string).
Обязательно ли наличие Формы на странице для сохранения значения из текстового поля в переменную процесса?	Нет, наличие Формы на странице необязательно для сохранения значения из текстового поля в переменную процесса. При переходе по процессу со страницы, где расположено текстовое поле, например, по Кнопке навигации, осуществится сохранение значения в переменную процесса при условии, что на текстовое поле добавлена функция “Сохранить значение в переменную процесса любого типа” и указана необходимая переменная процесса.