Отображаемое наименование бизнес-операции. Значение атрибута используется в качестве значения поля Caption узла модели приложения, представляющего бизнес-операцию. Для контекстных бизнес-операций это значение используется в качестве наименования пункта меню, с помощью которого запускается на выполнение бизнес-операция. Если атрибут не указан, то в качестве наименования используется имя экземпляра типа класса бизнес-операции.
В атрибутах бизнес-операций помимо DisplayNameAttribute можно использовать атрибут XafDisplayName.
Текстовое описание бизнес-операции. Значение атрибута используется в качестве значения поля ToolTip узла модели приложения, представляющего бизнес-операцию. Для контекстных бизнес-операций это значение используется в качестве всплывающей подсказки пункта меню, с помощью которого запускается на выполнение бизнес-операция.
DefaultOperationServiceAttribute
Реализация «по умолчанию» бизнес-операции. В параметре атрибута передается экземпляр типа класса - реализации бизнес-операции. Значение атрибута используется в качестве значения поля DefaultImplementation узла модели приложения, представляющего бизнес-операцию. При выполнении методов Execute и Rollback бизнес-операция перенаправляет запросы экземпляру класса реализации, указанному в этом поле.
Строковое имя пиктограммы, используемое при отображении айтема, запускающего бизнес-операцию в пользовательском интерфейсе.
BusinessOperationCategoryAttribute
Позволяет задать одну или несколько категорий, к которым относится бизнес-операция. Применяется одноуровневая группировка бизнес-операций по категориям при отображении бизнес-операций в пользовательском интерфейсе (меню «Действия» и иерархический список бизнес-операций). Одна бизнес-операция может принадлежать нескольким категориям. Атрибут без параметров задает категорию «по умолчанию». Также, экземпляр такого атрибута можно получить через статическое свойство Default. Бизнес-операции этой категории отображаются в корне списка.
Указывает способ выполнения бизнес-операции, запущенной через пользовательский интерфейс. Доступны синхронный и асинхронный способы выполнения.
При синхронном способе выполнения бизнес-операция запускается в контексте управляемой операции и отображается диалог, показывающий ход выполнения длительной операции. По окончании выполнения и закрытии диалога отображаются результаты выполнения бизнес операции, если таковые были предусмотрены.
При асинхронном способе выдается только сообщение, что бизнес-операция запущена. Бизнес-операция запускается под контролем управляемой операции. Ожидание окончания выполнения не производится. Результат операции отдельным представлением не отображается. Всю информацию о процессе выполнения можно увидеть в списке управляемых (длительных) операций.
Позволяет определить альтернативный вариант Detail View для ввода параметров Бизнес-операции.
По умолчанию, если Бизнес-операция представлена в BOModel, то Detail View для ввода параметров генерируется с помощью Dynamic Properties Object (см. Динамические свойства). Недостатком может оказаться тот факт, что такое Detail View невозможно кастомизировать через Редактор Модели.
Если к классу Бизнес-операции применить DomainComponentAttribute, то фреймворк сгенерирует для класса Detail View. Оно будет автоматически использовано в качестве формы ввода параметров Бизнес-операции. Его можно кастомизировать через Редактор Модели.
Пример такого использования можно найти в демо приложении Nortwind.DC (см. Бизнес-операцию ChangeFreight):
- Запустите Nortwind.DC.Win
- Запустите Редактор Модели и перейдите к узлу Views|Xafari.Northwind.DC.BusinessOperations|ChangeFreight_DetailView. Измените какие-нибудь параметры (например Caption) и сохраните изменения. Закройте Редактор Модели.
- В приложении перейдите к пункту навигации Бизнес-операции|Изменение стоимости фрахта, запустите Бизнес-операцию и проанализируйте форму ввода.