Выпадающий список

Назначение

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

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

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

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

Свойства

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

Наименование свойства	Назначение свойства	Принимаемые значения
Подсказка	позволяет создать подсказку, расположенную внутри элемента.	пример возможного значения: Выберите район
Надпись	позволяет задать наименование поля, которое будет отображаться на странице	пример возможного значения: Район
Зависит от (parentControl)	позволяет указать объект (родителя), например Выпадающий список, по идентификатору которого будут отображаться сведения в текущем зависимом элементе
Значение	позволяет задать значение поля по умолчанию. При указании значения, компонентом будет осуществляться поиск соответствия между этим значением и содержимым колонки, указанной в параметре “Возвращать дополнительно из”. После успешного сопоставления пользователю будет отображаться значение из колонки, указанной в параметре “Показывать пользователю”.	пример возможного значения: В свойстве компоненты “Возвращать дополнительно из” функции “Подгрузка данных” указана колонка базы данных, содержащее в себе значение кода записи. При открытии страницы с Выпадающим списком по умолчанию, при отсутствии иного значения подгруженного из базы данных (через функцию Выпадающийсписок. Сохранение значения), в него автоматически будет выставлено значение из таблицы базы данных с кодом НУ и отображаться значение из колонки “Показывать пользователю”, в данном случае это Наименование статуса (name)
Прикрепить значение (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

Свойство компоненты: Выпадающий список. Подгрузка данных

позволяет задать источник подгрузки/сохранения данных в компоненту из/в объекта базы данных (таблицы или представления) с указанием следующих дополнительных настроек:

Граф сущностей элемента настраивается в соответствии с п. Настройка Графа сущностей. Является обязательным к заполнению и настройке.
Возвращать значение дополнительно из - по умолчанию компонента возвращает идентификатор записи выбранной из справочника значений. Настройка данного параметра позволяет указать компоненте, какое значение необходимо дополнительно считать и вернуть, кроме значения идентификатора выбранной пользователем записи.
Тип отображения (Display Type) - это свойство,позволяющее выбрать тип для отображения значения в поле:
- Из одной колонки - значение по умолчанию
- Из нескольких колонок - позволяет указать перечень колонок, значения которых будут склеиваться в одну строку при отображении на странице с определяемым разделителем значений (точка, запятая, пробел и другие)
Разделитель - символ или пробел, который будет разделять между собой значения из разных колонок таблиц(ы) приводимых в одну строку (доступно для настройки при Тип колонки - Из нескольких колонок)
Порядок сортировки (Sort Order) - позволяет задать порядок сортировки отображаемых значений в списке для выбора, принимает значения:
- по возрастанию - значения будут сортироваться от меньшего к большему
- по убыванию - значения будут сортироваться от большего к меньшему
Показывать пользователю - позволяет задать элемент базы данных, значение которого будет отображено пользователю в Выпадающем списке(доступно для настройки при Тип колонки - Из одной колонки)
Связаны по - позволяет указать колонку компоненты указанной в свойстве “Зависит от”, обеспечивающую связь между родительской и текущей компонентами
Активировать фильтрацию по - позволяет задать колонку, по которой можно будет динамически активировать фильтр при использовании метода “Задать фильтр” (Set_Filter) в компоненте Обработка Событий в отношении настраиваемой компоненты
Datasource Jndi Name - позволяет задать иной источник (базу данных) для выполнения запроса, заданного с помощью элементов базы данных в редакторе Графа сущностей элемента. Значение данного свойства может быть задано следующим образом:java:/webbpm/AppRepDS, а сам адрес базы данных, логин и пароль для подключения должен быть указан в файлеstandalone.xml(аналогично тому, как указывается, например, подключение к базе данных безопасности) (рис.1)

рис.1 Настройка файла standalone.xml

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

Пример возможной настройки:

Свойство Выпадающий список. Сохранение значения

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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