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

Предыдущая статья курса: Задание 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. Настройка вычисления полей