Версия от 22:16, 19 января 2025

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

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

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

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

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

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

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

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

При создании приложения, все контролы необходимых классов добавляются в коллекцию 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

Имя параметра	Комментарий
kind	Тип элемента. Возможные типы: control folder
caption
icon
expanded
controlName
badgeCode
roles

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

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

@@ Строка 18: / Строка 18: @@
 Элементом Toolbox может служить как контрол, так и папка, в массиве items которой, будет свой список контролов или других папок. Таким образом, имеется возможность организации сложных  древовидных меню. Полный перечень параметров элементов коллекции Toolbox будет рассмотрен позже в данной статье.
+При выборе какого-либо элемента в меню Toolbox в пользователськом интерфейсе, в основной части окна (на прикрепленной картинке выделена желтым) открывается настроенный для данного пункта меню Toolbox
 = Параметры приложения =
+[[Файл:Параметры приложения.png|мини|Параметры приложения]]
+{| class="wikitable"
+|'''Имя параметра'''
+|'''Описание'''
+|-
+|package
+|Пакет, в котором содержится приложение
+|-
+|name
+|Наименование приложения
+|-
+|fullName
+|Полное имя (пакет и наименование)
+|-
+|caption
+|Заголовок (отображается на рабочем столе рядом с пиктограммой)
+|-
+|description
+|Описание (отображается на рабочем столе под заголовком)
+|-
+|icon
+|Пиктограмма (отображается на рабочем столе)
+|-
+|order
+|Порядок следования (определяет очередность приложений на рабочем столе)
+|-
+|title
+|Заголовок (отображается в левом верхнем углу приложения)
+|-
+|canClose
+|Отображать ли крестик для закрытия приложения рядом с заголовком
+|-
+|tabCount
+|Максимальное количество вкладок (0 – использовать параметр системы)
+|-
+|mainControlName
+|Полное имя главного элемента управления (определяет общую верстку приложения со статическим и динамическим контентом). ''Используется только при необходимости разработки собственных контролов для приложений.''
+|-
+|mainToolBarControlName
+|Полное имя верхней панели инструментов (отображается всегда независимо от текущего элемента управления). ''Используется только при необходимости разработки собственных контролов для приложений.''
+|-
+|defaultRoute
+|Элемент управления по умолчанию (отображается при открытии приложения, если не задан – первый элемент управления из главного меню). Используется fullName контрола.
+|-
+|roles
+|Список ролей, обладателям которых доступно приложение
+|-
+|services
+|Список клиентских сервисов, которые запускаются при открытии приложения. ''Например, сервис по автоматическому открытию карточки, получению данных для отображения из сторонней системы и т.д.''
+|-
+|parentApplication
+|Родительское приложение (его главное меню будет пронаследовано)
+|-
+|enabled
+|Отключенные приложения не будут отображаться на рабочем столе
+|}
+[[Файл:Элемент Toolbox.png|мини|Элемент Toolbox]]
 = Параметры элемента Toolbox =
+{| class="wikitable"
+!Имя параметра
+!Комментарий
+|-
+|kind
+|Тип элемента. Возможные типы:
+* control
+* folder
+|-
+|caption
+|
+|-
+|icon
+|
+|-
+|expanded
+|
+|-
+|controlName
+|
+|-
+|badgeCode
+|
+|-
+|roles
+|
+|}
   Следующая статья курса: [[Задание 2. Настройка приложения]]
   Предыдущая статья курса: [[Задание 1. Создание класса]]
 [[Категория:Курс "Разработка приложений"]]