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

Su questa pagina

1. Passaggio 1: installa ONLYOFFICE Docs
2. Passaggio 2: installa il plug-in
   1. Installazione tramite la cartella sdkjs-plugins
   2. Installazione tramite il file config.json

   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., nonché incorporato nella tua soluzione. Gli editor possono anche essere utilizzati come parte della soluzione di produttività completa ONLYOFFICE Workspace.

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

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

   Passo 1: Installa ONLYOFFICE Docs

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

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

   Puoi trovare le istruzioni dettagliate in questo tutorial HowtoForge.

   Passaggio 2: installa il plug-in

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

   Installazione 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

   Installazione 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.

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

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

   Passaggio 3: avvia il plug-in draw.io

   Dopo aver installato correttamente il plug-in draw.io, l'icona corrispondente viene visualizzata nella scheda Plugin. Fai clic su quell'icona e crea il tuo diagramma nella finestra aperta o incollane 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.

   

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