Поле ввода с подбором значения

Назначение

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

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

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

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

Свойства

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

Наименование свойства	Назначение свойства	Принимаемые значения
Надпись	позволяет задать наименование поля, которое будет отображаться на странице	пример возможного значения: Район
Зависит от	позволяет указать объект (родителя), например Выпадающий список, по идентификатору которого будут отображаться сведения в текущем зависимом элементе
Начать подбор вариантов после ввода	позволяет задать количество символов, после ввода которых пользователем, компонента начинает подбор и вывод вариантов, соответствующих уже введенной пользователем подстроке	пример возможного значения: 3
Прикрепить значение (Scroll Gravity)	позволяет задать расположение уже выбранного значения при отображении в выпадающем списке доступных значений позволяет задать расположение уже выбранного значения при отображении в выпадающем списке доступных значений	По умолчанию (DEFAULT) - выбранное значение отображается в порядке своего следования в списке доступных значений для выбора По центру (CENTER) - выбранное значение отображается по центру в выпадающем списке доступных значений для выбора В верхней части (TOP)- выбранное значение отображается в верхней части выпадающего списка доступных значений для выбора В нижней части (BOTTOM) - выбранное значение отображается в нижней части выпадающего списка доступных значений для выбора
Исключить условия графа	данное свойство позволяет подгружать для отображения значения в поле минуя условия (ограничения), заданные в Графе сущностей компоненты	Не активно - в данном состоянии, при подгрузке значений отсекаются значения не соответствующие условиям, заданным в Графе сущностей компоненты Активно - в данном состоянии, при подгрузке значений допускается отображение значений, не соответствующих условиям, заданным в Графе сущностей компоненты, но без возможности их повторного выбора в выпадающем списке
Помечать невалидным (Mark invalid if not Satisfy)	данное свойство доступно для управления при активации значении свойства Exclude Graph Conditions и позволяет визуально помечать поле как невалидное на странице, в случае если в него было подгружено значение, не соответствующие условиям Графа сущностей элемента	Не активно - в данном значении, поле не помечается на странице как невалидное и отображается стандартным образом Активно - в данном значении, убрав фокус с поля, оно помечается на странице как невалидное
Css class if not Satisfy	данное свойство доступно для управления при активном значении свойства Exclude Graph Conditions и позволяет задать CSS-класс, который будет применяться, в случае если в поле было подгружено значение, не соответствующие условиям Графа сущностей элемента
Tooltip if not Satisfy	позволяет отображать всплывающую подсказку,в случае если в поле было подгружено значение, не соответствующие условиям Графа сущностей элемента. Данное свойство доступно для управления при: активном значении свойства Exclude Graph Conditions и заданному значению в поле Css Class If Not Satisfy	пример возможного значения: not_valid

Свойство компоненты: Поле ввода с подбором значения. Сохранение значения

указывается поле таблицы базы данных, куда будет сохраняться и откуда будет подгружаться введенное значение

Функции

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Метод “Получить значение” возвращает первичный ключ и тип такого значения зависит от типа колонки первичного ключа в базе данных (обычно целочисленный bigint).

Метод"Задать значение" выставляет в компоненте значение, соответствующее значению в колонке с первичным ключом.

Метод “Получить значение BusinessId” возвращает значение колонки, заданной в параметре компоненты “Возвращать значение доп.колонки(BusinessId)” и определяется типом этой колонки в базе данных.

Метод “Задать значение поBusinessId” выставляет в компонентезначение, соответствующее значению в колонке, указанной в параметре компоненты"Возвращать значение доп.колонки(BusinessId)".

В этом примере функции “Получить значение” и “Задать значение” работаю следующим образом:

Функция в обработчике событий	Пример использования
Получить значение BusinessId	Пользователь выбрал значение на форме из справочника Для выбранной пользователем записи значение из колонки, которая указана в параметре Возвращать значение доп. колонки (BusinessId), возвращается значение Пример: Для справочника статусов задачи для BusinessId указана дополнительная колонка CODE. Значение этой колонки будет возвращено этой функцией при выборе пользователя.
Получить значение	Пользователь выбрал значение на форме из справочника Для выбранной пользователем записи значение из колонки, которая указана как первичный ключ, возвращается значение Пример: Для справочника статусов задачи для первичного ключа указана колонка STATUS_ID. Значение этой колонки будет возвращено этой функцией при выборе пользователя.
Задать значение BusinessId	Аналитик выбрал значение из справочника для отображения в поле по умолчанию. Выбор выполнен через дополнительное поле BusinessId, а точнее с помощью CODE. Для этого с помощью функции Задать значение указывается квалификатор (статичное), тип значения (строка) и само значение (например, “ЗАДАЧА ЗАВЕРШЕНА”) Обработчик события загрузки формы вызывает функцию задания значения Поле ввода автоматически по заданному CODE = “ЗАДАЧА ЗАВЕРШЕНА”; находит единственную запись в справочнике и отображает пользователю как значение по умолчанию
Задать значение	Аналитик выбрал значение из справочника для отображения в поле по умолчанию. Выбор выполнен через первичный ключ, а точнее с помощью STATUS_ID. Для этого с помощью функции “Задать значение” указывается квалификатор (статичное), тип значения (целое число) и само значение (например, “123”) Обработчик события загрузки формы вызывает функцию задания значения Поле ввода автоматически по заданному STATUS_ID = 123 находит единственную запись в справочнике и отображает пользователю как значение по умолчанию

Дополнительная функция “Сконвертировать значение в целочисленный тип” как раз используется для явной конвертации возвращаемого компонентой неопределенного типа (ANY) в явно желаемый Integer (например, при присвоении идентификатора строки выбранного в компоненте значения какой-либо переменной целого типа на странице).