Настройки запуска программы DVWebTool

Поведение программы по умолчанию: программа запускается при загрузке системы и не закрывается после выполнения действия. Данное поведение можно изменить в конфигурационном файле Web-клиента, расположенном по пути: /usr/lib/docsvision/webclient/appsettings.json. Настройки располагаются в группе: Docsvision WebClient SettingGroups SettingGroup Name="WebClient".

Программа DVWebTool необходима для выполнения сканирования документов и открытия файлов в офисном редакторе в ОС Microsoft Windows.

Программа DVWebTool работает только в ОС Microsoft Windows. Для работы требуется установить ASP.NET Core Runtime версии 8.0.

Чтобы установить "DVWebTool":

Для установки DVWebTool необходимо создать образ утилиты. Для этого откройте Панель управления Web-клиентом на Windows.
На главной странице Панели управления нажмите кнопку Собрать DVWebTool.
В появившемся окне проверьте указанный порт (по умолчанию 5413) и адрес сервера Web-клиента. Нажмите ОК.

Рисунок 1. Успешное завершение сборки

После завершения сборки появится окно об успешном завершении операции. При нажатии на кнопку ОК будет открыт каталог в файловой системе с собранными файлами DVWebTool.
Перейдите в каталог C:\Program Files (x86)\Docsvision\WebClient\Site\Content\Tools.
Скопируйте каталог DVWebTool на сервер Linux по пути /lib/docsvision/webclient/Content/Tools (если каталог отсутствует, создайте его самостоятельно).
Убедитесь, что в конфигурационном файле /usr/lib/docsvision/webclient/appsettings.json, в параметре "DVWebToolInstallerUri": указан адрес каталога: Content\\Tools\\DVWebTool\\DocsVision.DVWebTool.application.
Перезапустите службу dvwebclient.
DVWebTool будет установлена при первом открытии файла из карточки в ОС Windows. Программу также можно установить вручную из Профиля пользователя Установки Установить DVWebTool.

После завершения установки программа DVWebTool будет запущена автоматически, а в области уведомлений Windows появится значок программы ().

Программа устанавливается только для текущего пользователя. Если на компьютере работает несколько пользователей (несколько профилей Windows), программу нужно установить каждому пользователю.
Программа DVWebTool автоматически запускается при входе пользователя в ОС. Программу можно запустить вручную из меню Пуск Программы Docsvision Docsvision Web tool.

В одной ОС утилита DVWebTool может быть запущена одновременно только от одного пользователя.

Поведение DVWebTool при запуске настраивается в конфигурационном файле Web-клиента:

DvWebToolAppShutDown — закрывать DVWebTool после выполнения действия. Значение по умолчанию: false — не закрывать.
DvWebToolStartUpLaunch — отвечает за автоматический запуск DVWebTool. Значение по умолчанию: true — утилита запускается автоматически при загрузке системы.

Чтобы настройки вступили в действие после изменения, необходимо повторно собрать инсталлятор DVWebTool — запустите Панель управления Web-клиентом и нажмите на кнопку Собрать DVWebTool.

Рисунок 2. Параметры DVWebTool

При нажатии на кнопку Собрать DVWebTool откроется окно Параметры DVWebTool со следующими параметрами:

Адрес сервера Web-клиента: укажите адрес сервера Web-клиента.
Порт DVWebTool: укажите порт DVWebTool. По умолчанию 5413.
Автозапуск: параметр имеет приоритет над параметром DvWebToolStartUpLaunch в конфигурационном файле Web-клиента. Если в конфигурационном файле Web-клиента параметр true, но утилита собрана со снятым флагом Автозапуск, автозапуск не сработает.

Настройки запуска DVSupService

Служба DVSupService необходима для открытия файлов в офисном редакторе в ОС Linux.

Служба DVSupService работает только в ОС Linux. Для работы требуется установить ASP.NET Core Runtime версии 8.0.

Чтобы установить "DVSupService":

Выполните следующую команду:
- Astra Linux / ALT Linux
- РЕД ОС / SberLinux
$ sudo apt install docsvision-dvsupservice
$ sudo dnf install docsvision-dvsupservice
Служба будет установлена в каталог /lib/docsvision/dvsupservice от имени суперпользователя. Если на компьютере работает несколько пользователей, службу нужно установить один раз.

В конфигурационном файле службы по адресу /usr/lib/docsvision/dvsupservice/appsettings.json можно указать настройку WebClientAddress (по умолчанию null). Если для этой настройки указать адрес сервера (например http://docsvision.server.com:5004), служба будет принимать запросы на открытие только с указанного адреса. При необходимости можно указать несколько адресов.

Запустите службу следующей командой:

$ sudo systemctl start dvsupservice

Рисунок 3. Диалог сохранения в Р7-Офис

При работе DVSupService с Р7-Офис может появляться диалог сохранения. В таком случае необходимо, не изменяя директорию, нажать Да.

Посмотреть журнал работы можно по адресу /var/log/docsvision/dvsupservice/$ДД-ММ-ГГГГ_DvSupService.log.
Путь по умолчанию может быть изменён в конфигурационном файле службы:
```
{
"fileName": "/var/log/docsvision/dvsupservice/${shortdate}_DvSupService.log"
}
```
Чтобы просмотреть информацию о службе, выполните команду:
- Astra Linux / ALT Linux
- РЕД ОС / SberLinux
$ apt list docsvision-dvsupservice
$ dnf list docsvision-dvsupservice
Обновить службу можно, выполнив следующие команды:
- Astra Linux / ALT Linux
- РЕД ОС / SberLinux
sudo apt-get update sudo apt-get install docsvision-dvsupservice
$ sudo dnf update docsvision-dvsupservice
Удалить службу можно с помощью следующей команды:
- Astra Linux / ALT Linux
- РЕД ОС / SberLinux
$ sudo apt-get purge --autoremove docsvision-dvsupservice
$ sudo dnf remove package docsvision-dvsupservice

Запуск DVSupService

По умолчанию служба DVSupService запускается от имени пользователя ROOT.

Чтобы запустить службу от имени другого пользователя, необходимо выполнить следующую команду:
```
sudo systemctl edit dvsupservice
```
Записать следующее содержимое в появившемся окне:
```
[Service]
User=user
Group=user
```
В примере выше user — пользователь, от имени которого необходимо запускать DVSupService.

Чтобы запустить службу DVSupService, выполните следующую команду:

$ sudo systemctl start dvsupservice

Настроить автоматический запуск и иное поведение можно при помощи системных средств, см. подробнее руководство по работе с программным пакетом systemd в ОС Linux.