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

 Предыдущая статья курса: [[Задание 8. Настройка вычисления полей]]

= Общая информация =
[[Файл:Редактор действия класса.png|мини|Редактор действия класса]]
Действия класса - это коллекция, определяющая набор пользовательских действий, которые могут быть запущены пользователем по кнопке в интерфейсе.

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

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

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

* '''client''' - действию доступны манпиуляции с контролом, введенными значениями свойств. При изменении значений свойств объекта в таком режиме, изменения не будут приняты до сохранения пользователем карточки объекта
* '''server''' - действию доступны все возможности серверного контекста, включая прямое изменение свойств объекта в хранилище. В таком случае все изменения над объектами будут мгновенно отражены в хранилище, а в интерфейсе пользователя они будут автоматически обновлены.
[[Файл:Действие в интерфейсе пользователя.png|центр|безрамки|667x667пкс]]



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

= Параметры действий =
[[Файл:Редактор параметра действия.png|мини|Редактор параметра действия]]
Для действия, можно задать список параметров, которые необходимо передать в него при запуске.
[[Файл:Запуск действия с указанием параметров.png|мини|Запуск действия с указанием параметров]]
Если для действия заданы параметры, то при запуске действия в интерфейсе пользователя будет отображено модальное окно с полями для ввода параметров.
[[Файл:Настройки параметра действия.png|мини|Настройки параметра действия]]
Для каждого параметра можно задать следующие настройки:
{| class="wikitable"
|+Настройки параметров
!Название настройки
!Значение по-умолчанию
!Комментарий
|-
|name
|
|Имя параметра, для передачи в метод операции
|-
|caption
|
|Заголовок параметра, для отображения пользователю
|-
|dataType
|
|Тип данных параметра
|-
|multi
|
|Позволяет выбрать несколько значений в одном параметре. Доступно только для ссылочных типов данных
|-
|required
|
|Признак обязательности данного параметра для запуска действия
|-
|defaultValue
|
|JSON-описание значения по умолчанию
|-
|showInToolbar
|
|JSON-объект, описывающий параметры отображения параметра в панели инструментов
|-
|showInDialog
|
|Отображать параметр в модальном окне при старте действия (true / false)
|-
|editor
|
|Переопределение редактора для значения параметра
|}

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

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

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

 Следующая статья курса: [[Диалоги и уведомления]]

 Предыдущая статья курса: [[Задание 8. Настройка вычисления полей]]
[[Категория:Курс "Разработка приложений"]]