Установка и конфигурация сервера Web-клиента

Пользователь, выполняющий настройку Docsvision, должен являться локальным администратором (быть указанным в файле sudoers).

Если в Web-клиенте планируется работать с функциями модуля Управление архивом, установите серверную часть модуля Управление архивом на компьютер с сервером Docsvision перед установкой серверного расширения Web-клиента.

Если Web-клиент уже установлен и планируется дополнительно установить модуль Управление архивом выполните следующие действия:

Установите сначала модуль Управление архивом.
Затем обновите Web-клиент с установкой компонентов управления архивом.

Работа с модулем Управление архивом версии 6.1 поддерживается в модуле Web-клиент версии 6.1, сборка 522 и выше.
Работа с модулем Управление архивом версии 6.2 поддерживается в модуле Web-клиент 6.1, сборка 713 и выше.

Установка на Linux

Установите серверные компоненты Web-клиента следующей командой, предварительно обновив индекс пакетов:
- Astra Linux / ALT Linux
- РЕД ОС / SberLinux
sudo apt-get update sudo apt-get install docsvision-webclient
sudo dnf install docsvision-webclient

Все настройки Web-клиента хранятся в конфигурационном файле appsettings.json. Конфигурационный файл может быть изменён в любом текстовом редакторе, например nano.

sudo nano /usr/lib/docsvision/webclient/appsettings.json

Основные настройки, которые нужно сделать:

{
  "Docsvision": {
    "WebClient": {
      "Authentication": {
        "DefaultDomain": "DOMAIN.COM" (1)
      },
      "Server": {
        "SessionManagerConnection": {
          "ConnectionAddress": "http://dvserver.domain.com:5000"  (2)
        }
      }
    }
  },
  "Ldap": { (3)
    "AuthType": "Basic", (4)
    "Credential": {
      "UserName": "account@domain.com", (5)
      "Password": "password" (6)
    }
  },
  "DataProtectCertificateThumbprint": "thumbprint", (7)
  "SystemUserAccount": "account@domain.com", (8)
  "SystemUserPassword": "password", (9)
}

1	`DefaultDomain` — домен по умолчанию в формате FQDN.
2	`ConnectionAddress` — адрес сервера Docsvision.
3	`Ldap` — имя и пароль учётной записи, под которой процесс обращается к ActiveDirectory. Пароль можно указывать в открытом или в зашифрованном виде, см. подробнее о шифровании в документации по установке системы, раздел "Защита системной учётной записи"
4	`AuthType` — тип аутентификации: `Basic` — аутентификация через LDAP (подробнее см. в документации модуля Платформа Настройка работы с несколькими доменами), `Oauth` — аутентификация через ЕСИА или Azure.
5	`UserName` — логин пользователя модуля для аутентификации LDAP.
6	`Password` — пароль учётной записи пользователя для аутентификации LDAP.
7	`DataProtectCertificateThumbprint` — отпечаток закрытого ключа шифрования SHA1. Указывается без двоеточия, например, `D8602179888DC8402B393F11DCA16A3376DDF879`, см. подробнее в документации по установке системы, раздел "Защита системной учётной записи". Если шифровать пароль системной учётной записи не планируется, параметр можно удалить.
8	`SystemUserAccount` — имя системной учётной записи Docsvision в формате UPN.
9	`SystemUserPassword` — пароль системной учётной записи рекомендуется хранить в зашифрованном виде. Подробнее про шифрование см. в документации по установке системы, раздел "Защита системной учётной записи".

Запустите службу модуля:
```
sudo systemctl start dvwebclient
```
Служба запускается от имени УЗ Docsvision и не требует ROOT-привилегий.

Установка серверного расширения на Windows

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

Чтобы установить серверное расширение Web-клиент:

Запустите пакет установки Docsvision web-client server extension.msi.
Примите условия лицензионного соглашения, чтобы продолжить установку.

Рисунок 1. Условия лицензионного соглашения
Если требуется, измените каталог установки Расширения.

Рисунок 2. Каталог установки Расширения
Выберите необходимые компоненты установки.

Рисунок 3. Выбор компонентов
- Компоненты Web-клиента — компоненты, необходимые для работы Web-клиента. Обязательны к установке, неотключаемы.
- Компоненты Управления Архивом — компоненты, открывающие возможность работы с функциями модуля Управление архивом в Web-клиенте. Обязательны к установке, если планируется работа с модулем Управление архивом. Компоненты недоступны для установки, если не установлен модуль Управление архивом.
  
  Работа с модулем Управление архивом поддерживается в модуле Web-клиент версии 6.1, сборка 522 и выше.
- Компоненты модуля интеграции с операторами ЭДО — компоненты Web-клиента, необходимые для работы с модулем Модуль интеграции с операторами ЭДО.
  
  Компоненты отображаются только если установлен Модуль интеграции с операторами ЭДО версии 5.5.3158.0 и выше.
Нажмите на кнопку Установить и дождитесь завершения установки Расширения.

Рисунок 4. Установка Расширения
Нажмите кнопку Готово для завершения работы мастера установки.
Обновите БД через Консоль настройки Docsvision, подробнее процесс описан в документации модуля Платформа, раздел "Обновить базу данных".

Установка программ Конструктор Web-разметок и Панель управления

Системные требования приведены в пункте Требования отдельной установки программы Конструктор Web-разметок.

Конструктор Web-разметок и Панель управления Web-клиентом устанавливаются из пакета установки Web-клиента.

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

Чтобы установить Конструктор Web-разметок:

Добавьте данные системной учётной записи Docsvision в переменные окружения (если это не было выполнено ранее).
Под этой учётной записью Панель управления Web-клиентом будет подключаться к серверу Docsvision.
```
setx DV_SystemUserAccount account@domain.com
setx DV_SystemUserPassword password
```
Запустите пакет установки Docsvision web-client.msi.
Примите условия лицензионного соглашения, чтобы продолжить установку.
Если требуется, измените каталог установки.

Рисунок 5. Каталог установки Web-клиента
Выберите для установки все компоненты Web-клиента.

Рисунок 6. Устанавливаемые компоненты модуля Web-клиент
Нажмите кнопку Установить и дождитесь завершения установки Web-клиента.

В меню Пуск в группу Docsvision будут добавлены ярлыки: Конструктор Web-разметок и Панель управления Web-клиентом.

Укажите адрес подключения к серверу Docsvision в файлах конфигурации:

Обратите внимание, указанные ниже файлы конфигурации расположены в ОС Windows.

WebClientAdminConsole.appsettings.json — конфигурация программы Панель управления Web-клиентом.

WebLayoutsDesigner.appsettings.json — конфигурация программы Конструктор Web-разметок.

{
  "Docsvision": {
    "WebClient": {
      "Server": {
        "SessionManagerConnection": {
          "ConnectionAddress": "http://dvserver.domain.com:5000", (1)
          "BaseName": "alias" (2)
        }
      }
    }
  }
}

1	Адрес сервера Docsvision.
2	Псевдоним БД, от имени которой будут запускаться программы Панель управления Web-клиентом и Конструктор Web-разметок.

Откройте Панель управления Web-клиентом на вкладке Решения и выполните импорт стандартных решений для корректной работы Web-клиента.

Дополнительные параметры конфигурационного файла

В конфигурационном файле могут отображаться дополнительные параметры: ServiceId, ConnectionString, ApiKey. На данный момент они не используются, их не требуется заполнять.

{
  "Docsvision": {
    "ServiceId": "00000000-0000-0000-0000-000000000000", (1)
    "SettingsService": {
      "ConnectionString": "http://localhost:5200/api", (2)
      "ApiKey": "anything" (3)
    },
}

1	`ServiceId` — уникальный идентификатор данного экземпляра модуля, генерируется и записывается автоматически.
2	`ConnectionString` — полный адрес Сервиса настроек.
3	`ApiKey` — API-ключ для подключения к Сервису настроек, можно оставить значение по умолчанию или изменить, главное условие, чтобы значения в конфигурации модулей Сервис настроек и Платформа были одинаковые. Адрес и API-ключ требуется указать, если планируется переходить в Консоль управления Docsvision из карточек Web-клиента и Windows-клиента.