Решения Store 365 / Интеграция с 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.

Нашли опечатку? Выделите текст, нажмите ctrl + enter и оповестите нас