Назначение:

•событие «Выполнение» определяет логику, которая будет выполнена при вызове действия;

•событие «Возможность выполнения» определяет, при каких условиях действие будет доступно. Возвращаемые значения:

•True. Действие доступно. Значение по умолчанию;

•False. Действие недоступно.

Важно. В обработчике события Возможность выполнения не рекомендуется вызывать серверные функции (с атрибутом Remote) и использовать логику, которая будет долго обрабатываться. Данный обработчик выполняется часто. Поэтому, если в нем есть серверные функции, то на веб-сервер отправляется большое количество запросов, что, в свою очередь, влияет на быстродействие системы.

Аргументы событий:

•_obj – определяет:

•сущность, карточка которой открыта, если действие относится к карточке сущности;

•выбранную сущность, если действие относится к списку сущностей;

•выбранную запись, если действие относится к свойству-коллекции.

•e.Entity – сущность, для которой выполняется действие. Если действие относится к свойству-коллекции, то это дочерняя сущность;

•e.RootEntity – главная сущность, доступна для действий, у которых в поле *Доступно в выбрано значение Дочерней коллекции;

•e.CloseFormAfterAction – определяет необходимость закрытия окна после выполнения действия;

•e.FormType – определяет тип формы, из которой вызывается действие. Может принимать значения FormType.Card (карточка сущности) или FormType.Collection (список сущностей);

•e.IsToggled – определяет текущее состояние кнопки-переключателя. Возможные значения:

•True. Кнопка нажата;

•False. Кнопка не нажата;

•e.Action – информация о действии. Позволяет получить имя, иконку и описание действия;

•e.ClearMessageAfterAction – определение необходимости очистки сообщений валидации после выполнения действия;

•e.Validate – признак того, что сущность валидная. Проверяется заполненность обязательных полей, длина строк и т.д. Возможные значения:

•True. Сущность валидная (доступно выполнение действия);

•False. Сущность не валидная. При выполнении действия появится сообщение, заданное в AddError;

•e.AddError() – добавление сообщения об ошибке. Выполняемые операции не будут прерваны, их нужно прекратить вручную. Для этого в коде после валидации необходимо проверить состояние сущности с помощью метода Validate();

•e.AddInformation() – добавление информационного сообщения. Выполняемые операции не будут прерваны;

•e.AddWarning() – добавление предупреждения. Выполняемые операции не будут прерваны.

•e.Params – дополнительные параметры.

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

•если для действия установлен флажок Доступно для множественного выбора, имя свойства изменяется на _objs;

•если для действия установлен флажок Доступно при отсутствии выделенных сущностей, то из обработчика не будет доступа к сущности и списку сущностей;

•если действие относится к свойству-коллекции, то добавляется _all для обращения ко всем значениям коллекции.

Серверные события сущности

Клиентские события сущности

События свойств сущности

Параметр Params

Типы свойств

Валидация