Интеграции / Интеграция с OnlyOffice

Интеграция с OnlyOffice

Модуль для предпросмотра и редактирования документов онлайн с использованием сервера OnlyOffice позволяет работать с документами в окне системы ELMA365 как в облаке, так и в on-Premises версии системы 0.9.0 и выше.

Для работы требуется установленный сервер OnlyOffice Docs, который можно загрузить с сайта https://www.onlyoffice.com/. Бесплатная OpenSource версия также подойдет, но она имеет ограничение на 20 одновременно открытых сеансов редактирования (просмотр без редактирования не ограничен).

Скачать бесплатную версию можно на официальном сайте https://www.onlyoffice.com/ru/download.aspx?from=downloadintegrationmenu. Инструкции по установке OnlyOffice представлены по этой же ссылке и отличаются, в зависимости от варианта поставки.

Сервер OnlyOffice должен быть настроен на работу по https с правильным сертификатом (самоподписанный сертификат не подойдет) и доступен в сети как пользователям, так и серверу ELMA365.

Проверить, что сервер готов работать с документами можно перейдя по ссылке https://<ваш_адрес_сервера_onlyoffice> /web-apps/apps/api/documents/api.js. Откроется страница с кодом javascript.

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

Модуль может быть получен в виде файла или установлен через ELMA365 Store по ссылке https://store.elma365.ru/component/onlyoffice_v1-101.  

Для установки в виде файла:

  1. В системе ELMA365 перейдите в раздел Администрирование > Модули.

only-1

  1. Нажмите кнопку +Модуль в правом верхнем углу и выберите Загрузить файл.
  2. В появившемся окне загрузите файл модуля и дождитесь окончания проверки и установки. Затем нажмите кнопку Перейти в модуль.

only_office-2

Настройка модуля

На странице настроек модуля укажите:

only-3

Адрес до сервера 365 текущий фактический адрес в формате https://name.domain.ru/.

Адрес до сервера OnlyOffice адрес до OnlyOffice в формате https://name.domain.ru/.

Поддерживаемые форматы необходимо отметить те форматы файлов, которые вы хотите открывать в OnlyOffice. Можно выбрать сразу все.

Язык интерфейса укажите нужный язык интерфейса OnlyOffice. По умолчанию используется русская локализация.

Режим совместимости поставьте Да. Эта опция позволяет открывать редактирование документов (приложение типа документ) на версиях  от 0.9.х до 2021.6 включительно.

Чат отключает возможности внутреннего чата OnlyOffice в режиме редактирования. Установите Нет. Это настройка относится именно к внутренней функции OnlyOffice.

Комментарии отключает возможности внутренних комментариев OnlyOffice в режиме редактирования. Установите Нет. Это настройка относится именно к внутренней функции OnlyOffice.

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

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

only-4

Для приложений типа Документ на формах по умолчанию уже есть виджет предпросмотра, который использует OnlyOffice.

Создание документа

На форме создания документа по умолчанию есть виджет загрузки файла с предпросмотром.

only-5

В этот момент OnlyOffice еще не может открыть файл.

only-6

Просмотр документа

На форме просмотра документа по умолчанию есть виджет предпросмотра. Он используется для работы OnlyOffice.

only-7

Редактирование документа

Чтобы внести правки в документ, нажмите кнопку Редактировать в левом нижнем углу формы просмотра.

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

only-8

В режиме быстрого редактирования сервер OnlyOffice сохраняет изменения каждые несколько секунд, а если кто-то редактирует этот же документ одновременно с вами, то вы увидите его изменения в моменте.

После того как все пользователи прекратили редактировать документ, новая версия появится в системе ELMA365 в течение 5-10 секунд.

Задержка сохранения на 5-10 секунд не влияет на просмотр документа. То есть сразу после редактирования все пользователи уже увидят изменения, даже если кто-то продолжает редактировать документ (в этом случае новая версия еще не появилась), или прошло менее 5-10 секунд.

Произвольная форма

Если вы используете приложение другого типа (стандартное или событие) или форма настроена в Low сode-дизайнере, то вы можете разместить виджет Предпросмотра на форме просмотра или редактирования и настроить в нем поле Файл.

only-9

Если требуется на какой-либо форме, например, форме задачи, принудительно открыть файл на редактирование, то воспользуйтесь виджетом Просмотр и редактирование файла в OnlyOffice. Настройте поле Файл и в поле Action напишите «edit»

only-10

only-11

only-12

На одной форме нельзя одновременно просматривать и редактировать файл в OnlyOffice, даже на разных вкладках.

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

Раздел Файлы

В разделе Файлы при открытии файла, предпросмотр будет происходить в OnlyOffice.

only-13

Редактирование файлов в данном разделе появится в последующих версиях расширения.

Часто задаваемые вопросы

  • У меня была предварительная версия и теперь я поставил новую. Как понять, где старая, а где новая?

URL до актуальной версии: /admin/extensions/ext_265d7b04-b8c1-45d3-8d28-4dcccf25672c

  • В браузере я вижу, что OnlyOffice работает по https, но в ELMA365 появляется ошибка Download failed.

only-14

Если ваш путь сертификации DST Root CA x3 / R3 / Ваш_сервер, то вероятно причина в устаревании сертификата R3. Это известная ситуация в последнее время, о которой написано в интернете. Браузеры эту ошибку игнорируют, но это ошибка сертификата.

only-15

Убедиться в этом можно, воспользовавшись сервисом проверки SSL, например, https://www.ssllabs.com/ssltest/analyze.html.

only-16

Решение простое вам нужно положить сертификат, где не только указан Ваш_сервер, но и путь сертификации. Обычно такой сертификат выдается сразу и у него в названии написано +chain.