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

Confluence приложение для интеграции  с Р7

Этот плагин позволяет пользователям редактировать офисные документы из Confluence с помощью Р7 Document Server.

Коннектор доступен в официальном магазине Atlassian Marketplace.

  • В настоящее время доступны для редактирования или просмотра следующие форматы документов: DOCX, XLSX, PPTX, DOCXF, OFORM.
  • Плагин создаст новый пункт меню «Редактировать в Р7» в библиотеке документов для документов Office. Это позволяет нескольким пользователям сотрудничать в режиме реального времени и сохранять эти изменения в Confluence.
  • В настоящее время в OOXML можно конвертировать следующие форматы документов: ODT, DOC, ODP, PPT, ODS, XLS.

Вам потребуется экземпляр Р7 Document Server (Document Server), который можно разрешить и подключить как из Confluence, так и из любого конечного клиента. Если это не так, воспользуйтесь официальной документацией Р7 Document Server. Документы Р7 также должны иметь возможность напрямую отправлять сообщения в Confluence.

Самый простой способ запустить экземпляр Р7 Document Server — использовать Docker.

Загрузите скомпилированный файл target/Р7-confluence-plugin.jar в Confluence на странице «Управление надстройками».

Последние скомпилированные файлы пакетов доступны здесь и на Atlassian Marketplace

Вы также можете установить приложение из панели администрирования Confluence:

  1. Войдите в свой экземпляр Confluence как администратор.
  2. Перейдите на страницу «Управление надстройками».
  3. Нажмите «Найти новые приложения» или «Найти новые надстройки» на левой панели.
  4. Найдите коннектор Р7 для Confluence с помощью поиска. Результаты будут включать версии дополнений, совместимые с вашим экземпляром Confluence.
  5. Нажмите «Установить», чтобы загрузить и установить приложение.
  6. Теперь вы можете нажать «Закрыть» в диалоговом окне «Установлено и готово к работе».

Найдите загруженное приложение интеграции Confluence Р7 на странице «Управление надстройками». Нажмите «Настроить» и введите имя сервера с установленным Р7 Document Server:

https://сервер документов/
где documentserver — это имя сервера с установленным Р7 Document Server. Адрес должен быть доступен из браузера пользователя и с сервера Confluence. Адрес сервера Confluence также должен быть доступен из Р7 Document Server для корректной работы.

Начиная с версии 7.2, JWT включен по умолчанию, а секретный ключ генерируется автоматически для ограничения доступа к Документам Р7, а также из соображений безопасности и целостности данных. Укажите свой Секретный ключ на странице администрирования Confluence. В конфигурационном файле Р7 Document Server укажите тот же секретный ключ и включите проверку.

Если вы планируете самостоятельно скомпилировать приложение для интеграции Confluence Р7 (например, открыть исходный код и затем скомпилировать его), выполните следующие действия:

  1. Для успешной сборки необходима стабильная версия Java. Если она у вас не установлена, используйте следующие команды для установки Open JDK 8:

sudo apt-get update sudo apt-get install openjdk-8-jdk

2. Установите Atlassian Plugin SDK. Процесс установки описан здесь.

3. Получить подмодуль:git submodule update —init —recursive

4. Скомпилируйте пакет:atlas-package

  1. Пользователь переходит к вложениям Confluence и выбирает действие «Изменить в Р7».
  2. Confluence делает запрос к Р7EditorServlet (URL формы: /plugins/servlet/Р7/doceditor?attachmentId=$attachment.id).
  3. Confluence отправляет документ в службу хранения документов Р7 и получает временную ссылку.
  4. Confluence подготавливает объект JSON со следующими свойствами:
    • url — временная ссылка, которую Р7 Document Server использует для загрузки документа;
    • callbackUrl -URL, по которому Р7 Document Server информирует о статусе редактирования документа;
    • key — UUID для указания Р7 Document Server, загружать ли документ снова или нет;
    • title — название (имя) документа.
  5. Confluence берет этот объект и создает страницу из шаблона freemarker, заполняя все эти значения, чтобы клиентский браузер мог загрузить редактор.
  6. Браузер клиента делает запрос в библиотеку JavaScript из Р7 Document Server и отправляет Р7 Document Server конфигурацию DocEditor с указанными выше свойствами.
  7. Затем Р7 Document Server загружает документ из Confluence, и пользователь начинает его редактирование.
  8. Когда все пользователи и клиентские браузеры заканчивают редактирование, они закрывают окно редактирования.
  9. After 10 seconds of inactivity, Р7 Document Server sends a POST to the callback URL letting Confluence know that the clients have finished editing the document and closed it.
  10. Через 10 секунд бездействия Р7 Document Server отправляет запрос POST на URL-адрес обратного вызова, сообщая Confluence, что клиенты закончили редактирование документа и закрыли его.
  11. Confluence загружает новую версию документа взамен старой.

Загрузить приложение для интеграции Confluence Р7 можно здесь.