Разрешения в UI ресурсе

Вопрос: Чем отличается доступ по пути «/admin» от корневого пути «/»?

Ответ:

  • / (корневой домен) – обеспечивает вход в клиентский интерфейс. Для его работы требуется развертывание UI-сервиса ldm-base-ui.
  • /admin – обеспечивает вход в административный интерфейс dh-ui-base.

Вопрос: Как получить доступ к административному интерфейсу платформы?

Ответ: Для доступа к административному интерфейсу необходимо добавить сегмент /admin/ к базовому URL веб-интерфейса платформы в адресной строке браузера.

Вопрос: После установки клиентский интерфейс пуст, хотя административный работает корректно. Какие элементы должны в нем отображаться и есть ли правила их вывода?

Ответ: Клиентский интерфейс (виджет «Приложения») отображает только приложения, созданные в Конструкторе микрофронтов. Если модуль Конструктора не установлен или в нем не создано (и не активировано) ни одного приложения, то оно не будет отображаться в клиентском интерфейсе. Статические сервисы Платформы в клиентском интерфейсе не отображаются.

Вопрос: Как настроить цветовую палитру для интерфейса?

Ответ:

  1. В разделе «Конструктор микрофронтов» необходимо выбрать вкладку «Темы», в которой нужно создать новую тему и настроить для нее цветовую палитру.
  2. В меню «Информация о пользователе», расположенном в правом верхнем углу, необходимо выбрать пункт «Тема» и отметить в отобразившемся окне со списком тем нужную. Затем сохраните изменения для своего аккаунта.

Создание и применение тем подробно описано в документации: Темы

Вопрос: По каким причинам может не отображаться сервис или элементы интерфейса (кнопки, меню и т.д.)?

Ответ: Наиболее вероятно, проблема связана с отсутствием настроенных UI-разрешений в Сервисе прав доступа (Access Rights). Для исправления необходимо:

В разделе «Права доступа», вкладке «Ресурсы», необходимо отфильтровать ресурсы по наименованию сервиса.

Для каждого ресурса в разделе «Разрешения»:

  1. Завести в сервисе роль, идентичную роли пользователя в Keycloak (включая регистр) если она еще не заведена.
  2. Создать ресурсы (пермиссии) для необходимых элементов интерфейса. Список доступных разрешений размещен в документации: Перечень разрешений для микросервисов
  3. В разделе «Роли» назначить созданной роли соответствующие разрешения (пермиссии), отфильтровав их по наименованию ресурса. Добавление разрешений описано в документации в разделе Создание роли

Вопрос: Почему при настройке приложения в Конструкторе нельзя добавить пункты меню?

Ответ: Необходимо убедиться, что для роли пользователя в Сервисе прав доступа созданы и назначены разрешения на управление пунктами меню для сервиса «dh-facade-service»:

  • dh-facade-service menuItems – обновить список пунктов меню (refresh);
  • dh-facade-service menuItems – удалить пункт меню (delete);
  • dh-facade-service menuItems – изменить пункт меню (edit);
  • dh-facade-service menuItems – создать пункт меню (create).

Вопрос: Почему в сервисе «Связи» отсутствует кнопка «+» для создания связей, несмотря на наличие у роли всех необходимых ресурсов и разрешений?

Ответ: Кнопка «+» в данном сервисе не предусмотрена, так как его функция – только отображение уже существующих связей.

Создание связи требует шагов:

  1. Создание модели класса «Связи» в разделе «Модели данных» – требуется добавить новый класс связи, указав связываемые классы объектов. Подробно описано в документации: Создание класса объекта «Связь»
  2. Определение доступных классов в параметрах docshouse.application.relations.allowedSourceObjectClasses (источники) и docshouse.application.relations.allowedTargetObjectClasses (цели).
  3. Включение созданного класса связей в список docshouse.datamodel.starter.classes.
  4. Создание экземпляров объектов – необходимо убедиться, что в системе существуют конкретные объекты (экземпляры классов), которые требуется связать.
  5. Установление связи – связывание выполняется не в данном сервисе, а через карточки объектов в других модулях платформы (например, в сервисе «Документы»). После этого созданная связь автоматически отобразится в списке сервиса «Связи» (в данном разделе отображаются уже созданные сущности класса «Связи»).

Настройка сервиса «Связи» описана в документации: Настройки сервиса «Связи»