Создание приложения¶

Для создания нового приложения необходимо выполнить следующие действия:

1. В разделе Приложения нажать кнопку .
2. В открывшейся форме создания приложения заполнить поля.

В поле Код можно указать свой уникальный код приложения, используя латинские буквы, цифры, дефисы и символы подчеркивания без пробелов. Заполнение данного поля не является обязательным; если его оставить пустым, код автоматически заполнится в момент создания приложения. После создания приложения поле Код становится недоступным для редактирования.

Поля Наименование, Название иконки, Описание и Дополнительные свойства заполняются вручную.

Наименование должно быть уникальным и обязательно включать в себя префикс dh- и постфикс -service – пользователю в данном поле необходимо только ввести его основное название. Например, dh-myapp-service. В наименовании приложения допустимо, но не рекомендуется использовать кавычки.

Источником иконок является универсальная библиотека стороннего сервиса Vuetify. Для просмотра полного списка используемых иконок в сервисе Vuetify необходимо перейти на официальный сайт Material Design Icons.

Название иконки в одноименном поле указывается через префикс mdi-, после которого через дефис идет такое же наименование иконки, какое указано в библиотеке Material Design Icons. Система автоматически определяет желаемую иконку по указанному наименованию и добавляет ее для создаваемого приложения.

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

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

В поле Описание необходимо вручную указать краткое описание создаваемого приложения.

Одним из условий отображения и доступности текущего приложения в вертикальном меню является активированный тумблер Приложение активно. Данный тумблер можно в любой момент отключить – при положении «выкл» приложение не будет отображаться в вертикальном меню, но будет доступно в разделе Приложения Системы. Вторым обязательным условием является привязка пользовательских ролей к разрешениям в карточке ресурса, который автоматически публикуется в сервисе «Права доступа» после создания приложения.

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

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

Для использования кастомного бандла необходимо выбрать тип конфигурации «Бандл», после чего появится дополнительное обязательное поле, в которое нужно загрузить свой собственный JavaScript бандл в формате JSON. Данный бандл интегрирует в интерфейс Системы кастомное приложение.

Кастомные бандлы – это независимые модули, которые могут быть разработаны независимо с использованием любого веб-фреймворка, такого как Vue или React. Кастомные бандлы предназначены для встраивания в родительское веб-приложение и расширения его функциональности, когда существующий функционал не удовлетворяет специфическим требованиям пользователя.

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

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

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

– удаление файла, нажатие которой возвращает исходный вид области загрузки файла.

Для использования плагина необходимо выбрать тип конфигурации «Плагин». В поле Класс плагина нажать кнопку и в открывшемся списке выбрать нужный класс плагина нажатием ЛКМ по строке и нужную версию плагина выбранного класса среди созданных в разделе Плагины.

После выбора плагина ниже отобразятся его настройки.

При необходимости их можно расширить. После сохранения формы создания плагин будет интегрирован в текущее приложение. С результатом такой интеграции можно работать в пользовательском интерфейсе Системы на vue3 – в динамическом приложении (сервисе) будет отображаться встроенный плагин и его вложения при наличии.

3. После заполнения обязательных полей нажать кнопку .

Карточка обновится, в правом нижнем углу появится уведомление, информирующее об успешном сохранении приложения.

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

К созданному приложению можно перейти, нажав на его иконку.

Для существующих приложений можно создавать формы (см. п. Формы), привязывать их к коллекциям (см. п. Коллекции). Осуществлять переход между коллекциями можно нажатием на пункты меню, созданные самостоятельно (см. п. Пункты меню). Также для существующего приложения можно создавать фреймы (см. п. Фреймы) а посредством создания значений NLS любой элемент пользовательского интерфейса можно перевести на доступный язык (см. п. Переводы). Все эти настройки можно осуществить в соответствующих блоках карточки приложения после его создания. Каждый блок раскрывается нажатием кнопки в конце строки наименования блока.

Если в блоках отсутствуют кнопки действий, необходимо в сервисе «Права доступа» создать ресурсы для сервиса «dh-facade-service и выдать разрешения текущему пользователю. Полный перечень разрешений представлен в документе «Перечень разрешений для микросервисов ЛДМ. Платформа контент-сервисов»

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

В сервисе «Права доступа» для каждого динамического приложения после создания автоматически публикуется ресурс, сервис которого дублирует наименование приложения, например, «myAppService». В окне такого ресурса по умолчанию заведено одно разрешение с действием «access».

Для того чтобы динамическое приложение отображалось у других пользователей, требуется к данному разрешению привязать роли. Для этого в блоке Связанные роли карточки разрешения нужно нажать кнопку , в открывшемся окне отметить чекбоксами нужные роли и нажать кнопку [Подтвердить].

В окне ресурса нажать кнопку [Обновить] – появится уведомление, информирующее об успешном обновлении.

Динамическое приложение будет доступно пользователям выбранных ролей.