Установка и настройка

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

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

Установка модуля на сервер под управлением Linux

Установите серверные компоненты модуля следующей командой, предварительно обновив индекс пакетов:
- Astra Linux / Альт Сервер
- РЕД ОС / SberLinux
sudo apt-get update sudo apt-get install docsvision-edi-server
sudo dnf makecache sudo dnf install docsvision-edi-server
При установке docsvision-edi-server предлагается установить также:
- docsvision-ext-edi-webc — если планируется работа через интерфейс Web-клиента, установите расширение Web-клиент для работы с модулем Модуль интеграции с операторами ЭДО.
- docsvision-edi-diadoc-server — дополнительный компонент модуля, добавляющий поддержку работы с оператором Диадок.
Если данный модуль устанавливается последним, запустите Консоль управления Docsvision и выполните обновление базы данных, следуя инструкции в документации по администрированию модуля "Консоль управления Docsvision":
- "Подключение существующей БД"
- "Создание БД"
Перезапустите службу Сервера Docsvision.

Дополнительные настройки выполнять не требуется.

Установка расширения Модуля интеграции с операторами ЭДО на сервер под управлением Linux

Если планируется работа через web-интерфейс и модуль Web-клиент не установлен, установите Web-клиент версии 6.1 сборки 1265 и выше, инструкция по установке приведена в документации модуля Web-клиент, раздел "Установка и конфигурация сервера Web-клиента".
На сервере Web-клиента установите Расширение Модуля интеграции с операторами ЭДО для Web-клиента:
- Astra Linux / Альт Сервер
- РЕД ОС / SberLinux
sudo apt-get update sudo apt-get install docsvision-ext-edi-webc
sudo dnf makecache sudo dnf install docsvision-ext-edi-webc

Установка модуля на сервер под управлением Windows

Запустите пакет установки Docsvision EDI Integration server.msi.

Рисунок 1. Мастер установки серверной части модуля
Примите условия лицензионного соглашения для продолжения установки. Нажмите Далее.

Рисунок 2. Условия лицензионного соглашения

Выберите компоненты, которые требуется установить, и нажмите Далее.

Рисунок 3. Выбор устанавливаемых компонентов

Общие компоненты

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

Серверные компоненты: Основные серверные компоненты Модуля интеграции с операторами ЭДО, обязательны для установки на сервер Docsvision.

Коннектор к Диадок

Обеспечивают взаимодействие с коннектором к Диадок, обязательны для установки на сервер Docsvision, если планируется работать с коннектором.

Серверные компоненты: Основные серверные компоненты коннектора к Диадок для работы в Web-клиенте, обязательны для установки на сервер Docsvision.

Кнопка Сброс

Сбрасывает выбор компонентов на стандартные.

Кнопка Использование диска

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

Выбирайте необходимые компоненты в зависимостми от настраиваемого сервера. На основном сервере Docsvision обязательно должны быть установлены "Серверные компоненты" модуля. Для работы модулей, устанавливаемых отдельно (например, Консоль управления Docsvision, Служба фоновых операций, Web-клиент и т.д.), достаточно устанавливать только расширения (при наличии) и общие компоненты. См. "Требования к системе Docsvision" в разделе "Необходимые ресурсы", чтобы определить связь с другими модулями.

Выбранные компоненты сохраняются при обновлении модуля, т.е. выбирать компоненты повторно при обновлении не потребуется. Если все модули установлены вместе, достаточно выбрать компоненты только при первой установке.

В следующем окне нажмите Установить и дождитесь завершения установки модуля.
Нажмите на кнопку Готово, чтобы закрыть мастер установки.
Установите расширение Модуля интеграции с операторами ЭДО на сервер под управлением Windows, подробнее см. ниже.
Если данный модуль устанавливается последним, запустите Консоль управления Docsvision и выполните обновление базы данных, следуя инструкции в документации по администрированию модуля "Консоль управления Docsvision":
- "Подключение существующей БД"
- "Создание БД"
Перезапустите службу Сервера Docsvision.

Установка расширения Модуля интеграции с операторами ЭДО на сервер под управлением Windows

На машину с Web-клиентом потребуется установить Общие компоненты Модуля интеграции с операторами ЭДО и Коннекторы, а также Расширение Модуля интеграции с операторами ЭДО.

Чтобы установить "Общие компоненты" модуля Модуль интеграции с операторами ЭДО:

Запустите пакет установки Docsvision EDI Integration server.msi.
Примите условия лицензионного соглашения, чтобы продолжить установку.
На шаге выбора компонентов выберите только Общие компоненты и нажмите Далее.

Рисунок 4. Выбор устанавливаемых компонентов
Нажмите на кнопку Готово, чтобы закрыть мастер установки.
Запустите пакет установки Docsvision EDI extension for Web-client.msi.
Примите условия лицензионного соглашения, чтобы продолжить установку.

На шаге выбора компонентов выберите необходимые компоненты и нажмите Далее.

Рисунок 5. Выбор устанавливаемых компонентов

Серверные компоненты: Web-разметки для работы в Web-клиенте, обязательны для установки на сервер Docsvision.
Расширение Web-клиента: Обеспечивают взаимодействие с сервером Web-клиента, обязательны для установки на сервер Web-клиента.
Кнопка Сброс: Сбрасывает выбор компонентов на стандартные.
Кнопка Использование диска: Позволяет посмотреть свободное место на системных дисках.

Нажмите на кнопку Установить и дождитесь завершения установки модуля.
Нажмите на кнопку Готово, чтобы закрыть мастер установки.
Установите коннекторы согласно инструкции, подробнее см. ниже.

Установка коннекторов

Docsvision Модуль интеграции с операторами ЭДО поддерживает работу со следующими коннекторами:

Коннектор к Диадок, руководство по установке см. в разделе "Установка и удаление Коннектора"

Версии коннекторов должны равняться версии модуля. Не устанавливайте коннекторы и модуль из инсталлятора разных версий!

Импорт решений

Решения с web-разметками включены в комплект поставки. Для работы с модулем Модуль интеграции с операторами ЭДО в Консоли управления Docsvision загрузите стандартные решения Web-клиента, см. подробнее "Группа настроек "Решения"" в документации Консоли управления Docsvision.

Установка клиентской части модуля

Клиентская часть модуля должна быть установлена на компьютеры пользователей Docsvision, работающих в Windows-клиенте. Если Windows-клиент установлен для всех пользователей, клиентский компонент модуля также должен быть установлен для всех пользователей.

Клиентская часть будет автоматически установлена при запуске Windows-клиента, а также может быть установлена вручную.

Чтобы установить клиентскую часть модуля "Модуль интеграции с операторами ЭДО" вручную:

Запустите пакет установки Docsvision EDI Integration client.msi. Модуль устанавливается с областью установки модуля Платформа.

Рисунок 6. Мастер установки клиентской части "Модуля интеграции с операторами ЭДО"
Примите условия лицензионного соглашения для продолжения установки.

Рисунок 7. Условия лицензионного соглашения
Выберите компоненты, которые требуется установить.

Рисунок 8. Выбор устанавливаемых компонентов

Обратите внимание, клиентские компоненты коннектора к Диадок ставятся в рамках данного инсталлятора.
В следующем окне нажмите Установить и дождитесь завершения установки модуля.
Нажмите на кнопку Готово, чтобы закрыть мастер установки.

Шифрование настроек

Создайте сертификат по инструкции "Создание сертификата шифрования в Linux".

Пароль для сертификата указывать не требуется!

Добавьте сертификаты с публичным и приватным ключом на клиентскую и серверную машины модуля Управление процессами по пути /root/.dotnet/corefx/cryptography/x509stores/my. Приватный ключ требуется и на клиенте, потому что при загрузке операторов нужны пароли к УЗ.
Приватная часть требуется только на машине, где планируется настраивать/редактировать справочник ЮЗДО и под пользователем, который будет это делать. Устанавливать сертификат на все рабочие места с Windows-клиентом не требуется.

Если Web-клиент запущен от имени пользователя иного, чем ROOT, например от имени учётной записи Docsvision, сертификат требуется размещать по пути /home/docsvision/.dotnet/corefx/cryptography/x509stores/my.

Убедитесь, что в настройках оператора Диадок появился параметр для ввода отпечатка Thumbprint.
В свойствах Контекстное меню Свойства Состав Отпечаток созданного сертификата скопируйте отпечаток (например: 3f65b0bc7ca3f7291c5473e1cfb411f62bc0dfbe) и укажите его в настройках оператора. Повторно введите пароли (Password, ApiKey, ProxyPassword) в настройках оператора Диадок, чтобы они сохранились с учётом новой логики шифрования.
Если этот шаг пропустить, документооборот с оператором будет невозможен.
Перезапустите службу dvworkflow для Linux и Docsvision Workflow Server для Windows.
Перезагрузите список операторов и котрагентов.
Проверьте работу модуля ЭДО (достаточно убедиться, что работает получение и отправка документов, если всё работает стандартно, дешифровка работает).

Удаление модуля

Чтобы удалить модуль в ОС Windows, воспользуйтесь стандартными средствами системы (Установка и удаление программ).
Чтобы удалить модуль в ОС Linux, выполните команду:
Astra Linux

РЕД ОС / SberLinux

Альт Сервер

$ sudo apt-get purge docsvision-edi-server

$ sudo dnf remove package docsvision-edi-server

$ sudo apt-get remove --purge docsvision-edi-server