Интеграция с редакторами по протоколу WOPI

Назначение документа

В документе описано, как подключить к Почте редакторы: по протоколу WOPI или внутри самой инсталляции.

Документ нужен системным администраторам организации.

Протокол WOPI

WOPI (Web Application Open Platform Interface) – RESTful API, который определяет набор операций для доступа и модификации файлов в файловом хранилище. Работает через HTTP/HTTPS.

Вы можете подключить редактор с вашего сервера для онлайн-работы с файлами в Диске или воспользоваться редактором «Р7-Офис» внутри инсталляции.

Интеграция с редактором на вашем сервере

Убедитесь, что редактор реализует протокол WOPI. Эту информацию можно найти в документации к конкретному редактору.
Откройте веб-интерфейс установщика http://server-adress:8888.
Нажмите на кнопку в правом верхнем углу, выберите пункт Продукты.
Включите компонент Интеграция с редактором «МойОфис».
Нажмите на кнопку Сохранить.
Перейдите на вкладку Настройки → Интеграции → Интеграция с WOPI-редактором.
Нажмите кнопку редактирования .
Передайте ссылку https://OWAserver/hosting/discovery, где OWAserver -- это сервер, на котором установлен ваш редактор. По этому адресу находится xml-описание поддерживаемых приложений, действий и url-шаблонов доступа.

Примечание

Если вы загружаете xml-описание по кнопке Загрузить XML-файл, то нужно заполнить поля со списками форматов, поддерживаемых для открытия на просмотр и редактирования. Рекомендуется передавать URL до файла с xml-описанием, тогда списки заполняются автоматически.
Задайте зону обнаружения WOPI. Например: external-http.
Если ваш сервер использует самоподписанный сертификат, то включите опцию Игнорировать ошибки сертификата (insecure discovery).
Нажмите Сохранить.
Перейдите на вкладку AdminPanel и запустите автоматическую установку.
Подтвердить запуск автоматической установки, нажав на кнопку Запустить во всплывающем окне.

Редактор «Р7-Офис» внутри инсталляции

Примечание

На данный момент внутри инсталляции Почты VK WorkSpace поддерживается интеграция только с редактором «Р7-Офис». Он не рассчитан на большое количество пользователей. Если планируется активное использование сотнями пользователей одновременно, то рекомендуется установить редактор на вашем сервере и настроить интеграцию по протоколу WOPI.

Чтобы включить редактор «Р7-Офис» внутри инсталляции Почты:

Нажмите на кнопку в правом верхнем углу, выберите пункт Продукты.
Включите компонент Редактор «Р7-Офис» внутри инсталляции. По умолчанию редактор внутри инсталляции доступен бесплатно на 30 дней.
Нажмите на кнопку Сохранить.
Перейдите на вкладку Настройки.
Выберите Интеграции -> Лицензия редактора Р7-Офис.
Нажмите кнопку редактирования .
Нажмите на кнопку Добавить.
Введите лицензионный ключ или укажите путь до файла на вашем компьютере.
Нажмите на кнопку Сохранить.
Перейдите на вкладку AdminPanel и запустите автоматическую установку.
Подтвердить запуск автоматической установки, нажав на кнопку Запустить во всплывающем окне.

Загрузка шаблонов документов с подключенного сервера

После настройки интеграции с редактором по протоколу WOPI в интерфейсе Диска могут не появляться некоторые кнопки. Чтобы исправить проблему, нужно загрузить шаблоны документов из подключенного редактора.

Чтобы загрузить шаблоны документов на сервер:

В интерфейсе установщика перейдите на вкладку AdminPanel.
Найдите в списке контейнеров mailetcd и нажмите на значок шестеренки справа от названия контейнера.
Выполните шаг lightning_etcd_settings.
Найдите следующие контейнеры и выполните для каждого из них команду up_container:
- fcloud
- beaver
- lightning1
Найдите в списке контейнеров cld-docs и нажмите на значок шестеренки справа от названия контейнера.
Выполните шаг upload_file_templates.

Интеграция с редактором «МойОфис»

Чтобы подключить редактор «МойОфис», нужно проследовать шагам из пункта «Интеграция с редактором на вашем сервере». Редактор «МойОфис» реализует протокол WOPI, поэтому можете начать со второго шага.