Создание Портала

Этот раздел содержит описание процедур для создания Портала.

Для создания Портала:

  1. Откройте ЦН.

  2. Перейдите в раздел Сервисы.

  3. В разделе Сервисы нажмите на кнопку +.

  4. На вкладке Основные введите Название и Имя Портала; в разделе Настройка сервисов оставьте выбор без изменений.

  5. Перейдите на вкладку Параметры сервиса и введите вместо строки

    "$type":
  "DT.ConfigurationRepository.Configuration.ModuleConfiguration.Config, DT_ConfigurationRepository"

    строку

    "$type":
  "DT.ConfigurationRepository.Configuration.ModuleConfiguration.MdmPortalConfig, DT_ConfigurationRepository"

  6. Нажмите на кнопку сохранения. Будет создан новый сервис.

  7. После сохранения нового сервиса необходимо настроить его конфигурацию. Укажите порт, по которому будет работать Портал в поле port.

  8. Для запуска Портала необходимо применить созданную конфигурацию. Для этого нажмите на кнопку применения конфигурации.

  9. После успешного применения конфигурации откройте ЦМ и дождитесь запуска Портала. Информация о запущенных сервисах располагается в разделе Сервисы.

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

  11. В открывшемся окне разверните подраздел Параметры Портала. В нем будет указан Адрес публикации Портала.

  12. Перейдите по гиперссылке в строке Адрес публикации для запуска Портала в отдельной вкладке браузера.

Портал успешно создан и запущен.

Для изменения названия стартовой страницы Портала добавьте параметр portalHeader и задайте собственное наименование.

Пример конфигурации: задано наименование для стартовой страницы Портала, параметр portalHeader

{
        "$type": "DT.ConfigurationRepository.Configuration.ModuleConfiguration.MdmPortalConfig, DT_ConfigurationRepository",
        "options": {
                "$type": "DT.ClusterConfiguration.BlazorPortalOptionConfig, DT_Core",
                "userMenu": [],
                "dashBoardContent": {
                        "$type": "DT.ClusterConfiguration.ContentOption, DT_Core",
                        "layouts": [],
                        "singleSwitcherSettings": true,
                        "contentType": "SolidLayout",
                        "entityId": "5fbf45b5-8a09-4d5e-bf04-88161c208be7",
                        "name": "Кандидаты"
                },
                "dataSources": []
        },
        "periodUpdateMenuIndicatorsInSeconds": 30,
        "portalHeader": "MDM: Кандидаты",
        "delayRefreshOwnerUIElementAfterProcessingMSec": 500,
        "periodUpdateUserRolesSec": 30,
        "showNavIfMenuEmptyOn": true,
        "port": 10000,
        "useHttps": true,
        "auth": {
                "$type": "DT.ClusterConfiguration.AuthenticationConfig, DT_Core",
                "enabled": true,
                "usePasswordHash": false
        },
        "replyStoreTime": 0,
        "timeout": 10000
}

Основные параметры:

  • options: разметка раздела меню.

  • userMenu (array): список элементов пользовательского меню.

  • dashBoardContent (object): настройки дашборда.

  • layouts (array): массив слоёв дашборда.

  • singleSwitcherSettings (boolean): системное поле, не применимо для редактирования.

  • contentType (string): тип содержимого дашборда.

  • entityId (string): идентификатор дашборда.

  • name (string): название дашборда.

  • dataSources (array): список источников данных, доступных для отображения на дашборде.

  • periodUpdateMenuIndicatorsInSeconds (integer): период обновления индикаторов меню в секундах. По умолчанию 30.

  • portalHeader (string): название стартовой страницы Портала.

  • delayRefreshOwnerUIElementAfterProcessingMSec (integer): задержка (в миллисекундах) обновления UI-элементов после обработки бизнес-процесса. По умолчанию 500 (мс).

  • periodUpdateUserRolesSec (integer): период запроса ролей пользователей из модуля учетных записей в секундах. По умолчанию 30.

  • showNavIfMenuEmptyOn (boolean): флаг отображения навигации с пустым меню. По умолчанию true (доступно пустое меню).

  • port (integer): порт, по которому будет работать Портал.

  • useHttps (boolean): флаг использования HTTPS при работе Портала. По умолчанию false.

  • auth (object): настройки авторизации.

  • enabled (boolean): флаг включения аутентификации у внешней системы. По умолчанию флаг включен (true).

  • usePasswordHash (boolean): флаг включения передачи пароля или только хеш от него (SHA256 в шестнадцатеричном формате). По умолчанию флаг выключен (false) - используется пароль.

  • replyStoreTime (integer): системное поле, не применимо для редактирования.

  • timeout (integer): таймаут для ожидания изменения состояния, указывается в миллисекундах. По умолчанию установлено 10000 миллисекунды (мс).

Отображение на Портале

../../../_images/port1.png

Для включения шифрования страниц Портала в параметре useHttps установите значение True.

Авторизация

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

"auth": {

"$type": "DT.ClusterConfiguration.AuthenticationConfig, DT_Core",

"enabled": false,

"usePasswordHash": false

}

Пример конфигурации Портала с включенной авторизацией:

../../../_images/port29.png

При включенной авторизации система запрашивает ввод логина и пароля при входе на Портал.

../../../_images/port26.png

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

Для завершения сессии пользователя нажмите на соответствующую кнопку.

../../../_images/port6.png

В ЦМ в сервисе Управление пользователями фиксируются события создания и завершения сессии пользователя, попытки ввода неверного пароля или логина и т.д. Данные события регистрируются в разделе Контроль доступа.