Общие сведения

АРМ—автоматизированное рабочее место. Элемент панели управления навигацией, представленной в главном окне. Обеспечивает доступ пользователя к выполнению различных операций (отображение Views, запуск Actions и д р.) в соответствии с его ролью.

АРМ в Win-приложении

АРМ в Win-приложении

 

АРМ в Web-приложении

АРМ в Web-приложении

Отличительные особенности модели АРМов

По сравнению с NavigationItems модель АРМов имеет ряд отличительных особенностей:

Атрибуты Navigation Item и АРМа

Атрибуты Navigation Item и АРМа

  1. привязка АРМов к ролям пользователей, изменение структуры АРМов в зависимости от вхождения пользователя в роли

    Атрибут Role

    Атрибут Role

  2. описание шаблонов АРМов и их повторное использование в АРМах

    Узел шаблонов

    Узел шаблонов

  3. возможность выполнения различных операций при выборе элемента АРМа: отображение View, выполнение действий (Action), запуск отчетов и пр.

    Элементы АРМа

    Элементы АРМа

Использование модели АРМов в Win приложении

Для использования модели АРМов необходимо:

  1. подключить к приложению модули Xafari.Arms и Xafari.Arms.Win
  2. создать собственные шаблон для Главного окна и добавить в него контейнер действий (ActionContainer) Xafari.Arms.Win.ArmItemsActionContainer
  3. настроить модель АРМов в редакторе модели

Xafari.Arms.Win уже содержит реализацию шаблонов приложения, использующих модель АРМов. Шаблон реализует интерфейс ISupportArms, который является признаком использования АРМов.
Для переключения между панелями АРМ и NavigationItems следует использовать атрибут EnableARMs узла ArmDesign модели приложения.

Представление АРМов в Win-приложении

Структура АРМов может иметь два представления:

  1. TreeListViewArmsAction - отображаются все имеющиеся АРМы в виде дерева
  2. NavBarViewArmsAction – отображается лишь один активный АРМ, остальные АРМы представлены списком иконок
Представления АРМов

Представления АРМов

Настроить способ представления можно в модели приложения, установив свойству ValueViewArmsAction значение TreeListViewArmsAction или NavBarViewArmsAction.

Настройка способа представления АРМа

Настройка способа представления АРМа

Представление АРМов в Web-приложении

Представление АРМов в Web-приложении реализуется на уровне макета

Возможные представления АРМов в Web-приложении

Возможные представления АРМов в Web-приложении

Настройка АРМов в редакторе модели

Редактирование модели АРМов производится в модели приложения. АРМы в модели приложения состоят из:

  1. папок (ArmFolder)
  2. шаблонов (ArmTemplate)
  3. ссылок на шаблоны (ArmTemplateLink)
  4. различных конечных элементов, список которых может быть расширен по мере необходимости (например, запуск отчетов):
    • отображение View (ArmViewItem)
    • выполнение действия (ArmActionItem)
Состав АРМа

Состав АРМа

Правила формирования АРМов

  1. АРМ (Arm) содержит папки, элементы, ссылки на шаблоны. Атрибуты:
    • ImageName
    • StartupItem - элемент АРМа, который активируется сразу после запуска приложения
    • Caption
    • id
    • Role - идентификатор роли пользователя, для которой создан АРМ
    • ToolTip - всплывающая подсказка
  2. Папка (ArmFolder) - узловой элемент в структуре АРМа, содержит папки, элементы, ссылки на шаблоны
  3. Шаблон (ArmTemplate) - содержит описание некоторого подузла АРМа и может быть многократно использован для построения различных АРМов, хранится отдельно в узле Templates, содержит папки, элементы, ссылки на другие шаблоны
  4. Элемент View (ArmViewItem) - отображает ListView и DetailView, во время исполнения доступны только те View, для объектов которых есть доступ на чтение у пользователя. Атрибуты:
    • View - идентификатор View для отображения
    • ObjectKey - значение ключевого поля объекта для отображения DetailView
    • BackFilterCriteria - дополнительный фильтр для отображения ListView
  5. Элемент действие (ArmActionItem) выполняет действия, которые удовлетворяют следующим условиям:
  • Контроллер действия назначен для MainView
  • Действие является наследником SimpleAction, PopupWindowShowAction, SingleChoiceAction
  • Во время исполнения доступны только активные (Active) и доступные (Enabled) действия.

Атрибуты:

  • Action – идентификатор действия для выполнения