Come integrare ONLYOFFICE Docs con draw.io/diagrams.net

Introduzione

ONLYOFFICE Docs è una suite per ufficio open source distribuita sotto GNU AGPL v3.0. Comprende visualizzatori basati sul Web ed editor collaborativi per documenti di testo, fogli di calcolo e presentazioni compatibili con i formati OOXML.

ONLYOFFICE Docs può essere integrato con vari servizi cloud come Nextcloud, Redmine, Seafile, Jira, Moodle, ecc.. Gli editor possono essere utilizzati anche come parte della soluzione di produttività completa ONLYOFFICE Workspace.

Draw.io (diagrams.net) è un'app open source per la creazione di diagrammi per i team, che consente di creare un'ampia varietà di diagrammi, inclusi diagrammi di flusso, mappe mentali, organigrammi, diagrammi di Venn, infografica, diagrammi di rete e architettura, UML diagrammi e altri.

In questo tutorial vedremo come rendere disponibile il servizio draw.io direttamente in ONLYOFFICE Docs usando un plugin.

Installare ONLYOFFICE Docs

Il modo più semplice per installare l'ultima versione della suite con tutte le dipendenze è utilizzare Docker eseguendo il comando seguente:

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

Installare il plug-in

Scarica il plugin su GitHub e procedi con l'installazione manuale che è possibile in due modi.

Installare tramite la cartella sdkjs-plugins

Metti la cartella del codice del plugin nella cartella ONLYOFFICE Docs e riavvia il servizio:

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

Per il debug, avvia ONLYOFFICE Docs con la cartella 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

Installare tramite il file config.json

Nella configurazione di ONLYOFFICE Docs, aggiungi il percorso al file config.json corrispondente del plugin draw.io al parametro 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",
                ...
            ]
        },
        ...
    },
    ...
});

Qui, example.com è il nome del server in cui è installato ONLYOFFICE Docs e https://example.com/plugin1/config.json è il percorso del plugin.

La guida del plugin draw.io è asc.{DB38923B-A8C0-4DE9-8AEE-A61BB5C901A5}.

Se in questo file è presente un esempio di test, sostituire la riga /etc/onlyoffice/documentserver-example/local.json con il percorso del file config.json del plug-in.

Avviare il plug-in draw.io

Dopo aver installato correttamente il plugin draw.io, l'icona corrispondente appare nella scheda Plugin. Fare clic su quell'icona e creare il proprio diagramma nella finestra aperta o incollarne uno da qualsiasi risorsa disponibile.

Quando sei pronto, fai clic su Salva ed esci, quindi fai clic sul pulsante OK per ottenere un diagramma pronto nel documento. Se è necessario apportare ulteriori modifiche al diagramma, è sufficiente fare clic su di esso.

Conclusione

È tutto! Ora puoi creare, modificare e inserire diagrammi nei tuoi documenti senza uscire dall'editor o avviare applicazioni aggiuntive.