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