Открыть меню
Платформа Эра. Документация
Toggle preferences menu
Открыть персональное меню
Вы не представились системе
Your IP address will be publicly visible if you make any edits.

Операции над данными. Действия

Материал из Платформа Эра. Документации
Предыдущая статья курса: Задание 8. Настройка вычисления полей

Общая информация

Редактор действия класса

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

Действие может выполняться в двух режимах (actionTarget):

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

Так же, действия могут выполняться в серверном или клиентском контексте (actionKind):

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


Визуально, действия класса отображаются в реестре объектов класса. Если для действия выбран actionTarget=entity, то действие будет отображаться только при выбранном объекте. Если же выбран actionTarget=none, оно будет всегда доступно для запуска из реестра, не важно, выбран ли какой либо объект.

Параметры действий

Редактор параметра действия

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

Запуск действия с указанием параметров

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

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

Для каждого параметра можно задать следующие настройки:

Настройки параметров
Название настройки Значение по-умолчанию Комментарий
name Имя параметра, для передачи в метод операции
caption Заголовок параметра, для отображения пользователю
dataType Тип данных параметра
multi Позволяет выбрать несколько значений в одном параметре. Доступно только для ссылочных типов данных
required Признак обязательности данного параметра для запуска действия
defaultValue JSON-описание значения по умолчанию
showInToolbar JSON-объект, описывающий параметры отображения параметра в панели инструментов
showInDialog Отображать параметр в модальном окне при старте действия (true / false)
editor Переопределение редактора для значения параметра

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

TODO////

Настройка отображения действий

Роли и скрытие действий

Следующая статья курса: Диалоги и уведомления
Предыдущая статья курса: Задание 8. Настройка вычисления полей