Cómo integrar ONLYOFFICE Docs con draw.io/diagrams.net

Introducción

ONLYOFFICE Docs es una suite ofimática de código abierto distribuida bajo GNU AGPL v3.0. Incluye visores basados ​​en web y editores colaborativos para documentos de texto, hojas de cálculo y presentaciones compatibles con formatos OOXML.

ONLYOFFICE Docs se puede integrar con varios servicios en la nube como Nextcloud, Redmine, Seafile, Jira, Moodle, etc. Los editores también se pueden usar como parte de la solución completa de productividad ONLYOFFICE Workspace.

Draw.io (diagrams.net) es una aplicación de creación de diagramas de código abierto para equipos, que le permite crear una amplia variedad de diagramas, incluidos diagramas de flujo, mapas mentales, organigramas, diagramas de Venn, infografías, diagramas de red y arquitectura, diagramas UML y otros.

En este tutorial, veremos cómo hacer que el servicio draw.io esté disponible directamente en ONLYOFFICE Docs usando un complemento.

Instalar documentos de ONLYOFFICE

La forma más fácil de instalar la última versión de la suite con todas las dependencias es usar Docker ejecutando el siguiente comando:

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

Instalar el complemento

Descargue el complemento en GitHub y continúe con la instalación manual, que es posible de dos maneras.

Instalar a través de la carpeta sdkjs-plugins

Coloque la carpeta del código del complemento en la carpeta ONLYOFFICE Docs y reinicie el servicio:

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

Para la depuración, inicie ONLYOFFICE Docs con la carpeta 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

Instalar a través del archivo config.json

En la configuración de ONLYOFFICE Docs, agregue la ruta al archivo config.json correspondiente del complemento draw.io al parámetro 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",
                ...
            ]
        },
        ...
    },
    ...
});

Aquí, example.com es el nombre del servidor donde está instalado ONLYOFFICE Docs y https://example.com/plugin1/config.json es la ruta al complemento.

La ayuda del complemento draw.io es asc.{DB38923B-A8C0-4DE9-8AEE-A61BB5C901A5} .

Si hay un ejemplo de prueba en este archivo, reemplace la línea /etc/onlyoffice/documentserver-example/local.jsoncon la ruta al archivo config.json del complemento.

Inicie el complemento draw.io

Después de instalar correctamente el complemento draw.io, aparece el icono correspondiente en la pestaña Complementos. Haga clic en ese icono y cree su propio diagrama en la ventana abierta o pegue uno de cualquier recurso disponible.

Cuando esté listo, haga clic en Guardar y salir , luego haga clic en el botón Aceptar para obtener un diagrama listo en su documento. Si necesita realizar más cambios en el diagrama, simplemente haga clic en él.

Conclusión

¡Eso es todo! Ahora puede crear, editar e insertar diagramas en sus documentos sin salir del editor ni iniciar aplicaciones adicionales.