Модуль «Множественный выбор»

Преднастроенный Angular модуль «Множественный выбор» дает возможность пользователям на странице записи установить несколько значений для одного поля. Значениями поля со множественным выбором могут быть записи любых объектов BPMSoft, например, справочников и разделов. Выбранные значения отображаются в виде тегов, которыми пользователь может управлять.

Рисунок 1 — Модуль «Множественный выбор» на странице записи

Для выбора значений нажмите на поле и в выпадающем списке отметьте нужные варианты. Чтобы найти определенное значение, введите в поле несколько символов, и соответствующие значения отобразятся в выпадающем списке. Также вы можете выбрать значения из всплывающего окна, нажав кнопку .

Рисунок 2 — Множественный выбор справочных значений из выпадающего списка

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

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

Рисунок 3 — Переход на страницу записи

Примечание. Все изменения в модуле «Множественный выбор» сохраняются автоматически, без необходимости сохранять страницу. Например, если в модуле удалить ранее выбранное значение, то и в объекте хранения данных автоматически удалится соответствующая запись.

Если название значения длинное и не помещается в тег, то наведите на него курсор, чтобы просмотреть полное название.

Рисунок 4 — Отображение полного названия значения

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

Рисунок 5 — Просмотр всех выбранных значений

Настройка параметров модуля

Для настройки экземпляра модуля «Множественный выбор» заполните поля, которые отображаются во всплывающем окне при добавлении модуля на страницу.

Рисунок 6 — Параметры настройки модуля «Множественный выбор»

Параметр «Наименование экземпляра»

В поле «Наименование экземпляра» укажите название экземпляра модуля. Поле обязательно для заполнения. Значение генерируется автоматически, измените его при необходимости.

На странице раздела можно отобразить несколько полей со множественным выбором. При этом для каждого экземпляра модуля должен быть указан свой объект хранения данных.

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

Параметр «Заголовок»

В поле «Заголовок» укажите название поля со множественным выбором, которое будет отображаться как заголовок поля на странице записи. Если параметр не задан, то элемент на странице отображается без названия.

Рисунок 7 — Пример отображения модуля с заголовком

Параметр «Объект хранения данных»

В поле «Объект хранения данных» укажите объект, в котором будут храниться значения модуля. Поле обязательно для заполнения. Объект хранения данных реализует связь «многие ко многим» между таблицами баз данных.

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

• Объект содержит две колонки с типом «Справочник»:
• Источником данных одной из колонок является справочник, из которого будут выбираться значения в модуле. Данная колонка указывается в параметре «Колонка объекта справочника» при настройке экземпляра модуля;
• Источником данных другой колонки является объект, на страницу которого будет добавлен экземпляр модуля «Множественный выбор». Данная колонка указывается в параметре «Колонка объекта связи» при настройке экземпляра модуля;
• Все колонки объекта, кроме колонок объекта справочника и объекта связи, не являются обязательными (в настройках колонок признак «Обязательное» не установлен).

Пример. На странице контрагента необходимо реализовать возможность выбора нескольких городов одновременно.

Перед добавлением экземпляра модуля «Множественный выбор» на страницу раздела «Контрагенты» создадим и настроим новый объект BPMSoft, в котором будут храниться выбранные значения городов по контрагентам. Для этого:

1. Добавим новый объект в BPMSoft, например, «Объект хранения данных (Города контрагента)». Подробнее о добавлении нового объекта смотрите в статье Разработка конфигурационных элементов.
2. В созданный объект хранения данных добавим две колонки с типом «Справочник»:
• Колонка с заголовком «Город», источником данных которой является объект «Город» (City). Записи этого справочника будут использоваться в качестве значений модуля «Множественный выбор»;
• Колонка с заголовком «Контрагент», источником данных которой является объект «Контрагент» (Account). На страницу этого раздела будет добавлен экземпляр модуля «Множественный выбор».
3. Для добавленных колонок определим значение поля «При удалении значения справочника»:
• «Блокировать удаление, если есть связанные записи в текущем объекте с этим значением» — при попытке удаления записи справочника удаление будет заблокировано, и BPMSoft выдаст предупреждение;
• «Удалять записи из текущего объекта с этим значением» — при удалении записи справочника связанные записи объекта хранения данных также будут удалены.
4. Снимем признак «Обязательное» со всех существующих обязательных колонок объекта.
5. Сохраним изменения.

В результате создан и настроен объект хранения данных, который далее будет использоваться в настройке экземпляра модуля «Множественный выбор» при добавлении на страницу контрагента.

Параметр «Колонка объекта справочника»

В поле «Колонка объекта справочника» укажите колонку из объекта хранения данных. Источником данных этой колонки должен быть объект, записи которого будут использоваться в экземпляре модуля «Множественный выбор». Поле обязательно для заполнения.

Например, для множественного выбора городов на странице контрагента из объекта «Объект хранения данных (Города)» выберите колонку «Город». Источником данных этой колонки является объект «Город» (City). Подробнее о примере настройки объекта хранения данных смотрите в Параметр «Объект хранения данных».

Параметр «Колонка объекта связи»

В поле «Колонка объекта связи» выберите колонку из объекта хранения данных. Источником данных этой колонки должен быть объект, на страницу которого добавляется экземпляр модуля «Множественный выбор». Поле обязательно для заполнения.

Например, для множественного выбора городов на странице контрагента из объекта «Объект хранения данных (Города)» выберите колонку «Контрагент». Источником данных этой колонки является объект «Контрагент» (Account). Подробнее о примере настройки объекта хранения данных смотрите в Параметр «Объект хранения данных».

Параметр «Отображаемая колонка справочника»

В поле «Отображаемая колонка справочника» выберите колонку объекта, который указан в параметре «Колонка объекта справочника». Значения выбранной колонки будут отображаться в поле со множественным выбором. Для корректной работы модуля рекомендуется использовать колонку с типом «Строка». Поле обязательно для заполнения.

Например, чтобы в списке значений модуля отображались названия городов, такие как «Москва», «Новосибирск» и т. д., из объекта справочника «Город» выберите колонку «Название».

Рекомендуем изучить

Добавление Angular модуля на страницу
Модуль «Слайдер»
Модуль «Ссылка»
Модуль «Кнопка»