Как интегрировать ONLYOFFICE Docs с draw.io/diagrams.net

Введение

ONLYOFFICE Docs — это офисный пакет с открытым исходным кодом, распространяемый по лицензии GNU AGPL v3.0. Он включает веб-программы просмотра и редакторы для совместной работы для текстовых документов, электронных таблиц и презентаций, совместимых с форматами OOXML.

ONLYOFFICE Docs можно интегрировать с различными облачными сервисами, такими как Nextcloud, Redmine, Seafile, Jira, Moodle и т. д. Редакторы также можно использовать как часть комплексного решения ONLYOFFICE Workspace для повышения производительности.

Draw.io (diagrams.net) — это приложение для создания диаграмм с открытым исходным кодом для команд, которое позволяет вам создавать самые разнообразные диаграммы, включая блок-схемы, интеллект-карты, организационные диаграммы, диаграммы Венна, инфографику, диаграммы сети и архитектуры, диаграммы UML и другие.

В этом руководстве мы увидим, как сделать сервис draw.io доступным непосредственно в Документах ONLYOFFICE с помощью плагина.

Установить Документы ONLYOFFICE

Самый простой способ установить последнюю версию пакета со всеми зависимостями — использовать Docker, выполнив следующую команду:

sudo docker run -i -t -d -p 80:80 --restart=always onlyoffice/documentserver

Установите плагин

Загрузите плагин на GitHub и продолжите ручную установку, которая возможна двумя способами.

Установить через папку sdkjs-plugins

Поместите папку с кодом плагина в папку ONLYOFFICE Docs и перезапустите службу:

var/www/onlyoffice/documentserver/sdkjs-plugins/

Для отладки запустите ONLYOFFICE Docs с папкой sdkjs-plugins:

docker run -itd -p 80:80 -v /absolutly_path_to_work_dir:/var/www/onlyoffice/documentserver/sdkjs-plugins/plugin onlyoffice/documentserver-ee:latest

Установить через файл config.json

В конфигурации ONLYOFFICE Docs добавьте путь к соответствующему файлу config.json плагина draw.io в параметр plugins.pluginsData:

var docEditor = new DocsAPI.DocEditor("placeholder", {
 "editorConfig": {
 "plugins": {
 "autostart": [
 "asc.{0616AE85-5DBE-4B6B-A0A9-455C4F1503AD}",
 "asc.{FFE1F462-1EA2-4391-990D-4CC84940B754}",...
 ],
 "pluginsData": [
 "https://example.com/plugin1/config.json",
 "https://example.com/plugin2/config.json",...
 ]
 },...
 },...
 });

Здесь example.com — это имя сервера, на котором установлена ONLYOFFICE Docs, а https://example.com/plugin1/config.json — это путь к подключаемому модулю.

Справка по плагину draw.io: {DB38923B-A8C0-4DE9-8AEE-A61BB5C901A5}.

Если в этом файле есть тестовый пример, замените строку /etc/onlyoffice/documentserver-example/local.json на путь к файлу config.json подключаемого модуля.

Запустите плагин draw.io

После успешной установки плагина draw.io на вкладке «Плагины» появится соответствующий значок. Нажмите на этот значок и создайте собственную диаграмму в открытом окне или вставьте ее из любого доступного ресурса.

Когда будете готовы, нажмите « Сохранить и выйти », затем нажмите кнопку «ОК», чтобы получить готовую диаграмму в своем документе. Если вам нужно внести дополнительные изменения в диаграмму, просто нажмите на нее.

Вывод

Это все! Теперь вы можете создавать, редактировать и вставлять диаграммы в свои документы, не выходя из редактора и не запуская дополнительных приложений.