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

На этой странице

1. Шаг 1. Установите ONLYOFFICE Docs
2. Шаг 2. Установите подключаемый модуль
   1. Установка через папку sdkjs-plugins
   2. Установка с помощью файла config.json

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

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

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

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

   Шаг 1. Установите ONLYOFFICE Docs

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

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

   Вы можете найти подробные инструкции в этом учебнике HowtoForge.

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

   Загрузите плагин на 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: asc.{DB38923B-A8C0-4DE9-8AEE-A61BB5C901A5}.

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

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

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

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

   

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