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

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

Данная версия Web-клиента не поддерживает работу с модулем Управление архивом версии 5.5.1.

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

Установите службу Web-клиента следующей командой, предварительно обновив индекс пакетов:
```
sudo apt-get update
sudo apt-get 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
```

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

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

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

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

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

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

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

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

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

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

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

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

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

Добавьте данные системной учётной записи Docsvision в переменные окружения (если это не было выполнено ранее).
Под этой учётной записью Конструктор Web-разметок и Панель управления 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-клиента.