Интеграция с Р7-Офис

Модуль для предпросмотра и редактирования документов онлайн с использованием сервера Р7‑Офис позволяет работать с документами в интерфейсе ELMA365 как в облачной поставке, так и в ELMA365 On‑Premises версии 0.9.0 и выше.

начало внимание 

Для корректной работы модуля интеграции рекомендуем использовать Р7‑Офис версии 7.4.

конец внимание

Установка сервера Р7-Офис

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

Настройка поддержки JWT

В ELMA365 поддерживается работа с JWT‑токенами, которые используются для обеспечения дополнительного уровня безопасности при аутентификации.

Начиная с версии 7.2 валидация JWT включена по умолчанию. Для более ранних версий её необходимо включить.

Включение валидации JWT-токенов на стороне Р7-Офис

Если вы не используете JWT, для корректной работы модуля отключите проверку токенов в настройках Р7‑Офис.

Отключение валидации JWT-токенов на стороне Р7-Офис

Установка модуля Р7-Офис в ELMA365

Модуль можно загрузить из каталога ELMA365 Store или в виде файла формата .e365.

Для установки модуля выполните следующие действия:

  1. В ELMA365 перейдите в раздел Администрирование > Модули и нажмите кнопку + Модуль в правом верхнем углу.

r7-office-1

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

 

r7-office-2

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

На открывшейся странице заполните основные поля:

r7-office-3

  • Адрес сервера 365* — текущий фактический адрес в формате https://name.domain.ru/;
  • Адрес сервера Р7-Офис* — адрес до Сервера документов Р7-Офис в формате https://name.domain.ru/;
  • Поддерживаемые форматы* — отметьте форматы файлов, с которыми вы хотите работать в Р7-Офис. Можно отметить сразу все опции.

Затем перейдите к дополнительным настройкам:

r7-office-3-1

  • Секрет для формирования JWT — если на сервере Р7‑Офис включена поддержка JWT, укажите в этом поле секретный ключ. Его можно скопировать в конфигурационном файле local.json в поле secret;
  • Режим совместимости* — отметьте Да. Эта опция позволяет открывать редактирование файлов из приложений типа Документ на версиях от 0.9.х до 2021.6 включительно;
  • Чат* — отключает возможности внутреннего чата Р7-Офис в режиме редактирования. Установите Нет. Эта настройка относится именно к внутренней функции Р7‑Офис;
  • Комментарии* — опция включает и отключает возможности внутренних комментариев Р7‑Офис в режиме редактирования. Установите Нет. Эта настройка относится именно к внутренней функции Р7‑Офис;
  • Запуск макросов* — установите Да, чтобы включить выполнение макросов в документе;
  • Плагины* — установите Да, чтобы включить поддержку плагинов Р7‑Офис;
  • Рецензирование — установите Да, чтобы при редактировании файла автоматически включался режим отслеживания изменений. Все изменения, внесённые в этом режиме, фиксируются как правки и выделяются цветом. Их можно принять или отклонить. Пользователи могут индивидуально включать и отключать отслеживание изменений при редактировании определённого документа на вкладке Совместная работа;
  • Отображение изменений — выберите, как отображаются изменения, внесённые в документ в режиме рецензирования. Опция работает для Р7‑Офис версии 7.0 и выше:
    • Подсветка — опция используется по умолчанию. Во время просмотра документа правки, добавленные в режиме отслеживания изменений, выделены цветом. При нажатии на отредактированный текст можно посмотреть автора, дату и детали исправлений. Все вносимые изменения отображаются для пользователя в реальном времени.

В режиме редактирования можно принять или отклонить правки, нажав на выделенный цветом текст;

    • Не показывать — в режиме просмотра правки не видны, пока их не одобрят. Чтобы увидеть последние принятые правки, а также изменения, внесённые с отключённым рецензированием, нужно обновить страницу. Как только все пользователи заканчивают редактирование, и новая версия документа добавляется в систему, страница обновляется автоматически.

В режиме редактирования все ещё не принятые исправления выделены цветом. Их можно принять или отклонить, нажав на них;

    • Показывать с изменениями — исправления, внесённые в режиме рецензирования, при просмотре документа отображаются без выделения, как если бы они уже были приняты. Если рецензирование отключено, в режиме просмотра можно увидеть изменение текста в моменте.

При редактировании документа правки, которые ещё не приняты, выделены цветом. Их можно принять или отклонить, нажав на них;

    • Упрощенная подсветка — при просмотре и редактировании документа правки выделены цветом, однако примечания с информацией об исправлениях недоступны. Если в момент просмотра документ редактируется, изменения отображаются для пользователя в реальном времени.

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

После заполнения полей сохраните настройки.

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

После установки модуля и настройки интеграции Р7-Офис будет использоваться для просмотра и редактирования файлов, добавленных в приложения типа Документ, а также в раздел Файлы.

Приложение типа «Документ»

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

only-4

Подробнее о работе с приложениями этого типа читайте в статье «Приложение типа „Документ“».

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

На форме создания элемента приложения типа Документ по умолчанию размещён виджет Загрузка файла с предпросмотром. Нажмите кнопку в центре формы и загрузите файл с компьютера.

r7-office-4

После загрузки документ отобразится на форме с помощью Р7-Офис.

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

На форме просмотра приложений типа Документ по умолчанию размещён виджет Просмотр файла, который будет использоваться для работы Р7‑Офис.

r7-office-7

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

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

По умолчанию в Р7-Офис включён режим быстрого редактирования. При необходимости вы можете выбрать другой режим в настройках сервера Р7-Офис или переключать режим для конкретного документа вручную.

r7-office-9

В режиме быстрого редактирования сервер Р7-Офис сохраняет изменения каждые несколько секунд. Если кто‑то редактирует этот же документ одновременно с вами, то вы увидите его изменения в моменте.

После того как все пользователи прекратили редактировать документ, новая версия появится в системе Р7‑Офис в течение 5–10 секунд.

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

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

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

r7-office-5

Если требуется на какой-либо форме, например, форме задачи, принудительно открыть файл на редактирование, то воспользуйтесь виджетом Просмотр и редактирование файла в Р7-Офис. В настройках виджета заполните поля:

r7-office-6

  • File — нажмите на значок chain_icon  и выберите свойство типа Файлы из контекста приложения или бизнес‑процесса;
  • Action — напишите «edit»;
  • Отображать в режиме редактирования — выберите Да, чтобы после загрузки файл отображался в режиме редактирования.

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

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

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

Раздел «Файлы»

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

r7-office-8

Чтобы перейти в режим редактирования и внести правки в документ, нажмите кнопку Редактировать на верхней панели страницы с превью.

Возле аватара пользователя, который редактирует файл, отображается значок карандаша.

После внесения изменений можно:

  • вернуться в режим просмотра, нажав на значок onlyoffice-17 в правом верхнем углу окна;
  • закрыть файл, нажав на крестик.

В систему будет добавлена новая версия файла, которая станет текущей.