Числовое поле
Назначение
Числовое поле - это компонента, которая используется для отображения и ввода чисел на форме страницы.
В зависимости от настройки свойств, включенных по умолчанию в состав компоненты, компонента Числовое поле может использоваться для:
- Для сохранения введенной информации в базу данных и отображения значения из базы данных (в данном случае, функция компоненты Числовое поле. Сохранение значения должна быть включена)
- Для отображения числа, которые было введено пользователем приложения или является константой, определённой в логике приложения(в данном случае, функция компоненты Числовое поле. Сохранение значения должна быть выключена или удалена через настройки функции по кнопке)
Компонента Числовое поле находится в разделе Компоненты - Поля - Числовое поле.
Свойства
Компонента имеет набор общих свойств. Ниже отображены свойства, специфичные только для данной компоненты.
| Наименование свойства | Назначение свойства | Принимаемые значения |
|---|---|---|
| Подсказка | позволяет создать подсказку, расположенную внутри элемента | пример возможного значения: Введите год |
| Надпись | позволяет задать наименование поля, которое будет отображаться на странице | пример возможного значения: Год |
| Значение по умолчанию | позволяет задать значение поля по умолчанию, которое будет отображаться на странице | пример возможного значения: 100 |
| Минимальное возможное значение | позволяет задать минимально возможное значение числа, меньше которого пользователь ввести не сможет | пример возможного значения: 0 |
| Максимальное возможное значение | позволяет задать максимально возможное значение числа, больше которого пользователь ввести не сможет | пример возможного значения: 2999 |
| Шаг увеличения | позволяет задать шаг увеличения значения числа | пример возможного значения: 1 |
| maxValueErrorMsg, minValueErrorMsg, numberErrorMsg | позволяют задать пользовательское сообщение о соответствующих ошибках валидации | строка |
Свойство Числового поля: Сохранение значения
В случае если значение в числовом поле необходимо сохранить или подгрузить из БД, указывается поле таблицы базы данных, куда будет сохраняться и откуда будет подгружаться введенное значение. Если же числовое поле не требуется сохранять в БД или подгружать из БД, то данное свойство удаляется. Данный вариант может быть необходим, когдачисловое поле используется для отображения текста,который был введен пользователем приложенияили является константой, определённой в логике приложения.
Базовые функции
Заполнить значением по умолчанию
Заполнить значением из переменной процесса
Дополнительные функции
В ходе настройки свойств компоненты (заданных по умолчанию) может оказаться недостаточно для выполнения поставленной задачи и получения необходимого результата.
Для каждой компоненты предусмотрен перечень функций, расширяющих её базовую функциональность, которые можно добавить нажатием кнопки Добавить скрипт.
Вследствие технических особенностей реализации функций (функции, которые выполняются удаленно на сервере приложений, функции, которые выполняются в браузере пользователя), они имеют разные иконки, но это никак не влияет на их функциональность или предпочтительность использования.
Определить права текущего пользователя
Определить роли текущего пользователя
Включить вычисление математических операций
Включить конвертирование значений
TODO desribe function
Функция, которая не имеет настраиваемых аналитиком параметров, но будучи задействованной, позволяет осуществить преобразование значения в исходном компоненте из текущего типа (чаще всего, в компоненте Поле ввода с подбором значенияиз типа данных ANY) в целочисленный тип данных.
Она относится к той группе функций, чья функциональность применяетсяи может быть полезной не сразу после добавленияв исходную компоненту, а только при последующем использовании в компоненте “Обработка событий”, когда у исходной компоненты появляется нескольконовых доступных методов при конструировании алгоритма обработки событий на web-странице. Например, для такого паттерна обработки: ‘ЕСЛИ в компоненте Поле ввода с подбором значения выбрано (изменилось) значение, ТО в компоненту числовое поле вывести идентификатор(первичный ключ) этого значения’
Рис.1 Активация функции на компоненте Поле ввода с подбором значения
Рис.2 Числовое поле, в которое будем записывать идентификатор значения из компонента Поле ввода с подбором значения
Рис. 3 Пример алгоритма заполнения числового поля идентификатором значения, выбранного в поле с Постановщиком задачи, при условии расширения функциональности исходной компоненты Поле ввода с подбором значения функцией Сконвертировать значение в целочисленный тип; (появился новый метод Сконвертировать в число; у исходной компоненты)
Рис.4 Пример невозможности построения алгоритма из-за отсутствия необходимого метода Сконвертировать в число, вследствие удаления функции Сконвертировать значение в целочисленный тип из исходной компоненты Поле ввода с подбором значения Постановщик задачи (пропал метод Сконвертировать в число у исходной компоненты)
После запуска web-приложения (in runtime mode) выбираем в компоненте Список с поиском одно из значений (например, постановщика задачи с фамилией Дякин), после этого значение идентификатора (первичный ключ сотрудника по фамилии Дякин в справочнике) переносится в поле"Идентификатор постановщика", а в консоли браузера можно наблюдать сообщение о срабатывании компоненты Обработка событий, которое показывает выполненное функцией действие.
Рис 5.Выбираем Постановщика задачи
Рис.6 Функция заполняет числовое поле идентификатором
Сохранить значение в переменную процесса
Сохранить значение в переменную процесса любого типа
Методические рекомендации по применению
Пошаговые инструкции по применению компонента в типовых задачах Вы можете найти в разделах:
- Как добавить числовое поле на страницу?
- Как сохранить идентификатор связанной таблицы используя скрытое числовое поле?
TODO
Часто задаваемые вопросы
| Вопрос | Ответ |
|---|---|
| В каком случае используется числовое поле, а в каком текстовое? | Использование того или иного компонента зависит от типа поля в базе данных, в которую предполагается сохранение данных. Например, если поле в базе данных текстовое (text, char и т.п.), то используется компонента - текстовое поле. |
| Можно ли в числовое поле вводить отрицательные числа? | Да, можно. |
| Можно ли в числовое поле вводить нецелые числа? | Да, например, 3,25. |