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

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

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

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

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

  3. В разделе Сервисы нажмите на кнопку + над таблицей сервисов. В рабочей области страницы отобразится интерфейс создания / редактирования сервиса, содержащий две вкладки: Основные и Параметры сервиса. Вкладка Конфигурация сервиса появится после выбора Портал в Настройке сервисов (вкладка Основные).

  4. На вкладке Основные заполните следующие поля:

  • Название: произвольное название Портала, обязательно для заполнения.

  • Имя: уникальное имя Портала, необязательно для заполнения. При присвоении имени необходимо учитывать перечень зарезервированных имен.

  • Комментарий: описание сервиса, необязательно для заполнения, поддерживается многострочный ввод.

  • Включен: для активации сервиса необходимо установить флаг.

  • Правило обработки очередей: выбор настроенного Правила обработки очередей в разделе ЦН Обработка данных.

  • Настройка сервисов: для создания Портала необходимо выбрать вариант Портал.

../../../_images/create_portal_1.png

  1. На вкладке Параметры сервиса заполните значения:

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

  • Https: необходимость использования Https.

  • Порт для публикации веб-интерфейса: укажите порт, по которому будет работать Портал.

  1. Вкладка Конфигурация сервиса содержит конфигурацию отображаемых на Портале объектов в формате JSON. Настройка конфигурации объектов Портала описана в разделе Настройка портала.

После первого сохранения сервиса во вкладке Конфигурация сервиса появится кнопка Центр разработки. При нажатии на кнопку Центр разработки в новой вкладке произойдет переход в Центр разработки для дальнейшей настройки Портала.

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

  2. Нажмите на кнопку Применить конфигурацию.

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

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

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

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

../../../_images/create_portal_2.png

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

Пример конфигурации:

{
    "$type": "DT.ClusterConfiguration.NodeModule, DT_Core",
    "config": {
        "$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
        },
        "timeout": 10000
    },
    "isActive": true,
    "folderId": "942a54f6-5ab2-40ab-8eeb-df63f4b184f4",
    "entityId": "a5226dcd-8d0a-4f84-b371-ccc3ca725f13",
    "clusterId": "c6902c75-3d6e-480a-a022-a90d840d610b",
    "name": "ПорталТест",
    "description": "Портал Тест",
    "comment": "",
    "version": 2,
    "tagsCollection": [],
    "fieldsFromGlobalBusiness": {
        "$type ": " System.Collections.Generic.Dictionary `2[[System.String, System.Private.CoreLib],[System.String, System.Private.CoreLib]], System.Private.CoreLib"
                         },
                         "className": "MDM UI",
                         "classNameStr": "Портал"
        }

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

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

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

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

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

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

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

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

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

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

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

  • portalHeader (string): название стартовой страницы Портала. Название также может использоваться как заголовок вкладки браузера для Портала, заголовок формируется по правилам:

  • Если в Портале выбрана какая-либо страница, в заголовке отображается название этой страницы.

  • Если ни одна страница Портала не выбрана и portalHeader заполнен значением, в заголовке отображается значение portalHeader.

  • Если ни одна страница Портала не выбрана и portalHeader пустой («») или не задан, в заголовке отображается Название (description) сервиса Портал.

  • 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) - используется пароль.

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

  • isActive (boolean): UI настройка Включен (Основные).

  • folderId (string): ID папки.

  • entityId (string): ID Сервиса, присваивается системно.

  • clusterId (string): ID Кластера, присваивается системно.

  • name (string): UI настройка Имя (Основные).

  • description (string): UI настройка Название (Основные).

  • comment (string): UI настройка Комментарий (Основные).

  • version (integer): номер версии конфигурации.

  • tagsCollection (array): набор тегов, массив.

  • className (enum): тип сервиса.

  • classNameStr (enum): наименование типа сервиса.