Действия для коллекции¶

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

Такие действия можно создавать для каждой существующей коллекции. Для создания действия необходимо выполнить следующее:

В карточке коллекции в блоке Действия нажать кнопку .
Из списка выбрать значение «Добавить действие».

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

3. Если действие создается вручную, в открывшейся форме заполнить поля.

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

Поля Наименование и Описание заполняются вручную.

Для каждого действия в коллекции предусмотрена иконка, источником которых является универсальная библиотека стороннего сервиса Vuetify. Для просмотра полного списка используемых иконок необходимо перейти на официальный сайт Material Design Icons. В поле Название иконки указывается префикс mdi-, после которого через дефис идет такое же наименование иконки, какое указано в библиотеке Material Design Icons. Система автоматически определяет желаемую иконку по указанному наименованию и добавляет ее для создаваемого действия в коллекции.

Поле Код NLS заполняется вручную, выбором значения из выпадающего списка, который открывается по нажатию ЛКМ по строке, или автоматически по нажатию кнопки . При автоматической генерации поле заполняется в формате «actions.myAction», где «actions» – тип текущей сущности, «myAction» – ее код, если он был указан пользователем вручную.

Поле Порядок расположения заполняется вручную или выбором числового значения посредством переключения кнопок .

Активный тумблер Доступно только при выборе элементов коллекции делает текущее действие видимым только при выборе элементов текущей коллекции.

Активный тумблер Выполняет сразу при открытии активирует автоматическое срабатывание текущего действия при открытии коллекции.

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

Родительское действие выбирается в поле Родительское действие из списка, который открывается по нажатию ЛКМ на поле. Родительским может быть действие, для которого в поле Тип действия установлен признак «Группа действий». В блоке Действия такие действия группируются вместе.

Если в поле Тип действия выбрано значение «Внутренний запрос», то дополнительно необходимо выбрать один из сервисов Системы, а также класс объекта и тип эндпоинта в соответствующих полях. Данные поля будут скрыты, если в поле Тип действия выбраны значения «Внешний запрос» или «UI (без запроса)».

Блок HTTP запрос создаваемого действия для коллекции заполняется аналогично действию для формы (см. п. Действия для формы).

При выборе значения «UI (без запроса)» в поле Тип действия блок HTTP запрос исключается из формы создания действия.

При выборе значения «Конвейер» в поле Тип действия блок HTTP запрос заменяется кнопкой [Добавить шаг]. Шаги можно создавать вручную, а также копировать из форм или коллекций. Для этого необходимо после нажатия кнопки [Добавить шаг] выбрать из списка значение «Скопировать из формы» или «Скопировать из коллекции». При добавлении шага появляется строка с указанием наименования шага и типом действия.

Работа с конвейерами для коллекций аналогична работе для форм (см. п. Действия для формы).

Если в поле Тип действия выбрано значение «Слот», появится дополнительное поле Класс плагина для встраивания плагина. В поле Класс плагина нужно выбрать нужный класс и версию плагина. После выбора плагина ниже отобразятся его параметры.

При необходимости параметры можно переопределить и расширить. После сохранения плагин интегрируется и будет открываться при активации текущего действия для коллекции в пользовательском интерфейсе Системы на vue3.

4. Нажать кнопку [Сохранить].

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

Сама карточка действия обновится, в ней появятся дополнительные блоки:

Конвертеры данных;
Предварительные действия;
Завершающие действия.

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

После подтверждения Система сгенерирует и отобразит под тумблером разрешение в формате «actions-myAction», где «actions» – тип текущей сущности, «myAction» – ее уникальный код. Код может быть вручную прописан пользователем или сгенерирован автоматически на этапе создания действия. Разрешение можно отредактировать, нажав кнопку в конце его наименования. В открывшемся окне можно изменить его код вручную или с помощью автоматической генерации и добавить описание.

Конвертеры данных для действий создаются так же, что и для форм (см. п. Конвертеры данных для формы).