Пользовательский доступ к классам. Приложения

Предыдущая статья курса: Задание 1. Создание класса

Общая информация

Рабочий стол с приложениями Era

Приложение - это основной компонент пользовательского интерфейса платформы Эра. При входе в платформу, каждому пользователю отображается рабочий стол с доступными ему приложениями

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

Соответственно и приложение может объединять контролы из различных пакетов, включая базовые. Такой подход позволяет оперативно собирать "рабочие места" для пользователей, совмещая функционал из разных пакетов.

Так как при создании любого класса, для него автоматически создаётся новый контрол, то его можно сразу же добавить в приложение.

Каждое приложение определяется набором его параметров и коллекцией Toolbox.

Параметры приложения определяют его название, параметры наследования, иконку, порядок сортировки среди других приложений, настройки визуализации, список ролей, имеющих к нему доступ и т.д. Полный список параметров приложения будет рассмотрен позже в данной статье.

Layout приложения Эра

При создании приложения, все контролы необходимых классов добавляются в коллекцию Toolbox. Данная коллекция описывает древовидный список контролов с дополнительными параметрами - иконка контрола, заголовок, список ролей с доступом к контролу. На основании данной коллекции в пользователском интерфейсе строится бокове меню. Пример такого меню выделен зеленым цветом на прикрепленном скриншоте.

Элементом Toolbox может служить как контрол, так и папка, в массиве items которой, будет свой список контролов или других папок. Таким образом, имеется возможность организации сложных древовидных меню. Полный перечень параметров элементов коллекции Toolbox будет рассмотрен позже в данной статье.

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

Параметры приложения

Параметры приложения

Имя параметра	Описание
package	Пакет, в котором содержится приложение
name	Наименование приложения
fullName	Полное имя (пакет и наименование)
caption	Заголовок (отображается на рабочем столе рядом с пиктограммой)
description	Описание (отображается на рабочем столе под заголовком)
icon	Пиктограмма (отображается на рабочем столе)
order	Порядок следования (определяет очередность приложений на рабочем столе)
title	Заголовок (отображается в левом верхнем углу приложения)
canClose	Отображать ли крестик для закрытия приложения рядом с заголовком
tabCount	Максимальное количество вкладок (0 – использовать параметр системы)
mainControlName	Полное имя главного элемента управления (определяет общую верстку приложения со статическим и динамическим контентом). Используется только при необходимости разработки собственных контролов для приложений.
mainToolBarControlName	Полное имя верхней панели инструментов (отображается всегда независимо от текущего элемента управления). Используется только при необходимости разработки собственных контролов для приложений.
defaultRoute	Элемент управления по умолчанию (отображается при открытии приложения, если не задан – первый элемент управления из главного меню). Используется fullName контрола.
roles	Список ролей, обладателям которых доступно приложение
services	Список клиентских сервисов, которые запускаются при открытии приложения. Например, сервис по автоматическому открытию карточки, получению данных для отображения из сторонней системы и т.д.
parentApplication	Родительское приложение (его главное меню будет пронаследовано)
enabled	Отключенные приложения не будут отображаться на рабочем столе

Элемент Toolbox

Параметры элемента Toolbox

Имя параметра	Комментарий
kind	Тип элемента. Возможные типы: control folder Тип folder используется для создания древовидной структуры меню
caption	Заголовок, определяет название пункта меню
icon	Иконка, позволяет задать иконку пункта меню
expanded	Только для kind=folder. Определяет, развернута ли по-умолчанию папка
controlName	Ссылка на контрол для отображения при выборе пункта меню. Используется fullName контрола, например, creomate_test/contact_list/Contacts
badgeCode	Задает текст для отображения в бейдже пункта меню (например, может использоваться для отображения счётчика непрочитанных сообщений/уведомлений)
roles	Список ролей, которым отображается данный пункт меню
items	Только для kind=folder. Коллекция значений, повторяющая собой коллекцию Toolbox. Использовуется для построения древовидного меню

Следующая статья курса: Задание 2. Настройка приложения

Предыдущая статья курса: Задание 1. Создание класса