ownCloud

Caratteristiche principali

• Creazione, modifica e visualizzazione di documenti, fogli di calcolo e presentazioni.
• Condivisione di file con diverse autorizzazioni — visualizzazione/modifica, revisione, compilazione di moduli e commenti con menzioni degli utenti. È anche possibile limitare il download (in tutti gli editor) e la modifica dei filtri (nei fogli di calcolo). È disponibile anche la condivisione tramite link pubblici.
• Co-editing dei documenti in tempo reale: due modalità di co-editing (Veloce e Rigida), Traccia Modifiche, commenti e una chat integrata.
• Co-editing tra diverse istanze federate di ownCloud collegate a un unico Document Server.
• Supporto JWT per proteggere il tuo traffico in modo che nessuno, oltre agli utenti con i diritti appropriati, possa accedere ai tuoi documenti.

Formati supportati

• Per la modifica: DOCM, DOCX, DOTM, DOTX, XLSB, XLSM, XLSX, XLTM, XLTX, POTM, POTX, PPSM, PPSX, PPTM, PPTX, PDF
• Per la visualizzazione:
  • WORD: DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTM, HTML, HWP, HWPX, MD, MHT, MHTML, ODT, OTT, PAGES, RTF, STW, SXW, TXT, WPS, WPT, XML
  • CELL: CSV, ET, ETT, FODS, NUMBERS, ODS, OTS, SXC, XLS, XLSM, XLSX, XLT, XLTM, XLTX
  • SLIDE: DPS, DPT, FODP, KEY, ODG, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, SXI
  • PDF: DJVU, DOCXF, OFORM, OXPS, PDF, XPS
  • DIAGRAM: VSDM, VSDX, VSSM, VSSX, VSTM, VSTX
• Per la conversione in formati Office Open XML utilizzando l'opzione Converti con ONLYOFFICE: DOC, DOCM, DOT, DOTX, EPUB, HTM, HTML, ODP, ODT, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, XLS, XLSM, XLT, XLTM, XLTX.
  ODT, ODS e ODP sono disponibili anche per la conversione istantanea. Dopo aver abilitato l'opzione corrispondente nelle impostazioni dell'amministratore, i documenti formattati ODF vengono immediatamente convertiti nell'editor e aperti dopo aver fatto clic su di essi.

Novità nella versione 9.12.1

Aggiunto

• Descrizione del plugin e link utili nelle impostazioni dell'amministratore

Modificato

• Risolto il problema dell'apertura di un link condiviso quando l'accesso di gruppo all'app è limitato
• Sostituito il messaggio generale Salvataggio riuscito con messaggi dedicati per ciascuna sezione delle impostazioni
• Cambiato il colore del pulsante di salvataggio delle impostazioni in primario
• Mostrata una finestra di conferma prima di eseguire la cancellazione dei metadati della versione
• Scaricare tutte le pagine del documento quando si converte in tipi di immagine con il metodo Scarica come

Il changelog completo è disponibile qui.

Requisiti

• ONLYOFFICE Document Server v7.0 (server o versione cloud) o successivo

  Hai bisogno di un'istanza di ONLYOFFICE Docs che sia risolvibile e connessa sia da ownCloud che da qualsiasi client finale. ONLYOFFICE Docs deve essere in grado di inviare POST a ownCloud direttamente.

  A partire dalla versione 4.3.0, ONLYOFFICE Docs e ownCloud possono essere installati su computer diversi o sulla stessa macchina. Nel caso in cui scegli questa ultima opzione, dovrai configurare una porta personalizzata per ONLYOFFICE Docs, poiché di default sia ONLYOFFICE Docs che ownCloud funzionano sulla porta 80.

  Si prega di fare riferimento alla pagina di documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.
• ownCloud v10.0.0 e successivo
• ONLYOFFICE Connector v8.2.3 e successivo per ownCloud

Installazione del connettore ONLYOFFICE per ownCloud

L'amministratore di ownCloud può installare l'app di integrazione dal mercato delle applicazioni integrato. Per farlo, segui questi passaggi:

1. Fai clic sul menu hamburger in alto a sinistra.
2. Seleziona Market.
3. Vai alla categoria Tools.
4. Trova ONLYOFFICE nell'elenco delle applicazioni disponibili.
5. Fai clic sul pulsante Installa.

In alternativa, l'amministratore può installare l'applicazione manualmente:

1. Ottieni l'app ONLYOFFICE per ownCloud. Ci sono diversi modi per farlo:
   • Scarica l'ultima versione firmata dal negozio ufficiale di ownCloud.
   • Oppure puoi scaricare l'ultima versione firmata dalla pagina dei rilasci dell'applicazione su GitHub. Ad esempio:

     tar -xvzf vX.X.X.tar.gz

     Dove vX.X.X è la versione del connettore necessaria.

     Decomprimi l'archivio:

     tar -xvzf vX.X.X.tar.gz

     Rinomina la cartella in onlyoffice:

     mv onlyoffice-owncloud-X.X.X onlyoffice

   • Oppure puoi clonare il codice sorgente dell'applicazione e compilarlo tu stesso:

     git clone https://github.com/ONLYOFFICE/onlyoffice-owncloud.git onlyoffice cd onlyoffice git submodule update --init --recursive

   ownCloud non funziona con applicazioni non firmate mostrando un messaggio di avviso, quindi dovrai utilizzare l'opzione a o b per ottenere l'applicazione per il tuo ambiente di produzione.
2. Sposta la cartella onlyoffice nella directory apps/ del server ownCloud (o in un'altra directory usata per collegare le applicazioni):

   cp -r /root/onlyoffice/ /var/www/owncloud/apps/

3. Vai alla directory apps/:

   cd /var/www/owncloud/apps

4. Cambia il proprietario per aggiornare l'applicazione direttamente dall'interfaccia web di ownCloud:

   chown -R www-data:www-data onlyoffice

5. In ownCloud, vai su Settings > Admin > Apps, fai clic su Show disabled apps e fai clic su Enable per l'applicazione ONLYOFFICE.

Configurazione del connettore ONLYOFFICE per ownCloud

Per configurare le impostazioni dell'applicazione ONLYOFFICE, vai su Settings > Admin > Additional.

Nella sezione Server settings, specifica le seguenti opzioni:

• Indirizzo di ONLYOFFICE Docs - specifica l'indirizzo URL in cui è installato il Document Editing Service. Questo campo è obbligatorio. Se installi ONLYOFFICE Docs su una porta personalizzata, devi specificare la porta, ad esempio: http://127.0.0.1:8081/
  L'indirizzo di ONLYOFFICE Docs deve essere accessibile da ownCloud, così come l'indirizzo di ownCloud deve essere accessibile da ONLYOFFICE Docs.
• Disabilita la verifica del certificato (non sicuro) - seleziona questa casella per disabilitare la verifica del certificato e consentire a ownCloud di stabilire una connessione con ONLYOFFICE Docs se stai utilizzando un certificato autofirmato per il tuo ONLYOFFICE Docs (altrimenti, ownCloud non convaliderà un certificato autofirmato e non consentirà la connessione a/da ONLYOFFICE Docs). Questa è una soluzione non sicura e ti consigliamo vivamente di sostituire il certificato con uno emesso da un CA.
• Chiave segreta - specifica il segreto utilizzato per firmare i dati.
  A partire da ONLYOFFICE Docs v7.2, JWT è abilitato per impostazione predefinita e la chiave segreta viene generata automaticamente. Devi abilitarlo anche sul lato ownCloud: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specifica la stessa chiave segreta nelle impostazioni del connettore. Per ulteriori dettagli, consulta la sezione Abilitazione di JWT per l'integrazione di ONLYOFFICE e ownCloud di questo articolo.
• La sezione Advanced server settings può essere utilizzata se la tua configurazione di rete non consente richieste tra ownCloud e ONLYOFFICE Docs installati utilizzando gli indirizzi pubblici. In questo caso, specifica gli indirizzi per le richieste interne nei campi corrispondenti:
  • Nel campo Indirizzo di ONLYOFFICE Docs per richieste interne dal server, specifica l'indirizzo utilizzato per accedere al Document Editing Service da ownCloud.
  • Nel campo Indirizzo del server per richieste interne da ONLYOFFICE Docs, specifica l'indirizzo utilizzato per accedere a ownCloud da Document Editing Service.

Fai clic sul pulsante Save. Dopo aver salvato le Server settings, appariranno le sezioni Common settings, Editor customization settings e Common templates.

Nella sezione Common settings, puoi specificare le seguenti opzioni:

• Limita l'accesso agli editor ai seguenti gruppi - seleziona questa casella e seleziona i gruppi di utenti che non saranno autorizzati a utilizzare gli editor ONLYOFFICE in ownCloud.
• Usa ONLYOFFICE per generare un'anteprima del documento - seleziona questa casella per la generazione di miniature tramite ONLYOFFICE. Occuperà un po' di spazio su disco.
• Apri il file nella stessa scheda - seleziona questa casella per aprire un file nella scheda del browser corrente. Se questa opzione è deselezionata, un file verrà aperto in una nuova scheda del browser.
• Mantieni i metadati per ogni versione una volta che il documento è stato modificato funzione che consente di mantenere i metadati e visualizzare le modifiche per ogni versione del documento nella cronologia delle versioni. Occuperà un po' di spazio su disco. Puoi usare il pulsante Clear per rimuovere i metadati e liberare spazio su disco.
• L'applicazione predefinita per l'apertura del formato - consente di controllare i formati da associare agli editor ONLYOFFICE. I formati docx, xlsx e pptx sono selezionati per impostazione predefinita.
  L'apertura negli editor ONLYOFFICE verrà eseguita solo per i formati selezionati in questa sezione.
• Apri il file per la modifica - consente agli amministratori di scegliere i formati di documento da modificare tramite conversione in formati OOXML. I formati csv e txt sono selezionati per impostazione predefinita.
  ImportanteA causa delle restrizioni del formato, alcuni dati potrebbero andare persi quando si salva nei formati dell'elenco (csv, odp, ods, odt, rtf, txt).

  Dopo aver abilitato l'opzione corrispondente, i documenti nei formati specificati verranno immediatamente convertiti e aperti nell'editor ONLYOFFICE per la modifica dopo aver fatto clic su di essi e scelto l'elemento di menu Open in ONLYOFFICE. Se un formato non è selezionato, il file verrà aperto per la visualizzazione.

Nella sezione Editor customization settings, puoi specificare le seguenti opzioni:

• Mantieni le versioni intermedie durante la modifica (forcesave) funzione che consente di inviare tutte le modifiche all'archiviazione direttamente quando si fa clic sul pulsante Save nell'interfaccia degli editor ONLYOFFICE se si desidera prevenire la perdita di dati. Quando questa opzione è disabilitata, le modifiche vengono salvate automaticamente nella cache degli editor.
• Seleziona gli elementi dell'interfaccia degli editor che desideri nascondere/mostrare (Chat, Intestazione più compatta, Feedback & Support, Help, Intestazione della barra degli strumenti monocromatica).
• Modalità di revisione per la visualizzazione funzione che consente di impostare la modalità di visualizzazione predefinita della revisione del documento:
  • Markup - per evidenziare le modifiche proposte,
  • Final - per mostrare con le modifiche applicate,
  • Original - per mostrare il documento originale senza alcuna modifica.

Dopo aver apportato modifiche alle Common settings e/o Editor customization settings, fai clic sul pulsante Save situato in basso per salvare le modifiche.

Nella sezione Common templates, puoi fare clic sull'icona e caricare modelli docx, xlsx o pptx per creare nuovi documenti.

Puoi scaricare o eliminare un modello da questo elenco utilizzando le icone corrispondenti.

Dopo aver aggiunto modelli nelle impostazioni dell'amministratore, gli utenti potranno scegliere un modello quando creano un nuovo documento utilizzando il pulsante add nell'interfaccia di ownCloud o tramite il menu File > Create new nell'interfaccia degli editor ONLYOFFICE.

Verifica della connessione

Puoi verificare la connessione a ONLYOFFICE Docs utilizzando il seguente comando occ:

occ onlyoffice:documentserver --check

Vedrai un testo, sia con informazioni sulla connessione riuscita che sulla causa dell'errore.

Come funziona

L'integrazione di ONLYOFFICE segue l'API documentata qui.

1. Quando si crea un nuovo file, l'utente naviga in una cartella di documenti all'interno di ownCloud e fa clic sull'elemento Document, Spreadsheet o Presentation nel menu new (+).
2. Il browser richiama il metodo create nel controller /lib/Controller/EditorController.php. Questo metodo aggiunge una copia di un file dalla cartella assets alla cartella in cui si trova attualmente l'utente.
3. Quando si apre un file esistente, l'utente naviga fino ad esso all'interno di ownCloud e seleziona l'opzione di menu Open in ONLYOFFICE.
4. Si apre una nuova scheda del browser e viene invocato il metodo index del controller /lib/Controller/EditorController.php.
5. L'app prepara un oggetto JSON con le seguenti proprietà:
   • url - l'URL che ONLYOFFICE Docs utilizza per scaricare il documento;
   • callbackUrl - l'URL che ONLYOFFICE Docs utilizza per informare sullo stato della modifica del documento;
   • documentServerUrl - l'URL a cui il client deve rispondere al Document Server di ONLYOFFICE (può essere impostato nella pagina delle impostazioni amministrative);
   • key - il UUID+Modified Timestamp per istruire ONLYOFFICE Docs se scaricare nuovamente il documento o meno.
6. ownCloud prende questo oggetto e costruisce una pagina dal modello templates/editor.php, popolando tutti i valori necessari per garantire che il browser del client carichi correttamente l'editor.
7. Il browser del client effettua una richiesta alla libreria JavaScript di ONLYOFFICE Docs e invia a ONLYOFFICE Docs la configurazione di DocEditor con le proprietà sopra menzionate.
8. Quindi ONLYOFFICE Docs scarica il documento da ownCloud e l'utente inizia a modificarlo.
9. ONLYOFFICE Docs invia una richiesta POST a callbackUrl per informare ownCloud che un utente sta modificando il documento.
10. Quando tutti gli utenti e i browser dei client hanno terminato la modifica, chiudono la finestra di modifica.
11. Dopo 10 secondi di inattività, ONLYOFFICE Docs invia un POST a callbackUrl informando ownCloud che i client hanno terminato la modifica del documento e lo hanno chiuso.
12. ownCloud scarica una nuova versione del documento, sostituendo quella vecchia.

Abilitazione di JWT per l'integrazione di ONLYOFFICE e ownCloud

Per proteggere i documenti da accessi non autorizzati, gli editor di ONLYOFFICE utilizzano il JSON Web Token (JWT). Il token viene aggiunto nella configurazione quando l'Editor di Documenti viene inizializzato e durante lo scambio di comandi tra i servizi interni di ONLYOFFICE Docs. La chiave segreta viene utilizzata per firmare il token web JSON e convalidare il token alla richiesta a ONLYOFFICE Docs.

A partire da ONLYOFFICE Docs v7.2, JWT è abilitato per impostazione predefinita e la chiave segreta viene generata automaticamente. Devi trovare la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specificare la stessa chiave segreta nelle impostazioni del connettore.

Passo 1: Trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs

1. Apri il file local.json con qualsiasi editor di testo disponibile.
   • Per Linux - /etc/onlyoffice/documentserver/local.json
   • Per Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Per Docker – entra nel container di ONLYOFFICE Docs utilizzando il comando docker exec -it <containerID> bash e apri /etc/onlyoffice/documentserver/local.json

     In alternativa, puoi utilizzare il seguente comando per trovare la chiave segreta predefinita senza aprire local.json:

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   Il file local.json dovrebbe apparire così:

   { }

2. Il valore true è specificato in tre sezioni. Significa che la convalida del token è abilitata.
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. La chiave segreta generata automaticamente è specificata in tre sezioni. Puoi sostituire il valore segreto predefinito con la tua chiave segreta. La chiave segreta deve essere la stessa in tre sezioni.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Se apporti modifiche, salvale e riavvia i servizi affinché le modifiche di configurazione abbiano effetto.

   supervisorctl restart all

Passo 2: Specifica la stessa chiave segreta nelle impostazioni del connettore

Nelle impostazioni del connettore, specifica lo stesso segreto nel campo Secret key e salva le impostazioni.

Collegamento al demo di ONLYOFFICE Docs

A partire dalla versione 3.0.1 del connettore ONLYOFFICE, puoi provare gli editor online di ONLYOFFICE all'interno di ownCloud senza installare ONLYOFFICE Docs.

Per attivare la connessione, seleziona la casella Connect to demo ONLYOFFICE Docs server e fai clic sul pulsante Save.

Installazione di Docker e Docker Compose

1. Segui questa istruzione per scaricare e installare Docker sul tuo computer. Docker è un programma per automatizzare lo sviluppo e la gestione delle applicazioni in ambienti abilitati ai container.
2. Quindi segui questa istruzione per scaricare e installare il gestore pacchetti Docker Compose, che ti consente di descrivere ed eseguire applicazioni multi-container.

Installazione dei server ONLYOFFICE Docs e ownCloud

1. Scarica l'ultima versione del repository docker-onlyoffice-owncloud. Per farlo, inserisci la seguente riga nell'interfaccia della riga di comando:

   git clone --recursive https://github.com/ONLYOFFICE/docker-onlyoffice-owncloud

2. Una volta scaricato il repository, vai alla cartella docker-onlyoffice-owncloud:

   cd docker-onlyoffice-owncloud

3. Aggiorna i sottomoduli nel repository:

   git submodule update --remote

4. Avvia Docker Compose:

   sudo docker-compose up -d

   Potrebbe essere necessario attendere un paio di minuti fino a quando tutti i container sono attivi e funzionanti dopo il comando sopra.

Nella barra degli indirizzi del browser, inserisci http://localhost per aprire la pagina di configurazione di ownCloud e creare il tuo account amministratore. Inserisci il tuo Login e Password (per impostazione predefinita, admin è utilizzato per entrambi i campi).

Ora puoi creare e modificare documenti in ownCloud utilizzando ONLYOFFICE Docs senza configurare alcuna impostazione.

Le impostazioni del server sono specificate durante la distribuzione, ma puoi regolare Common settings, Editor customization settings e Common templates. Si prega di fare riferimento alla sezione Configurazione del connettore ONLYOFFICE per ownCloud per saperne di più sulle impostazioni del connettore disponibili.

Scarica i componenti necessari

Innanzitutto, devi installare l'hypervisor per la macchina virtuale. Scegli tra VMware Workstation Pro o VirtualBox e segui la documentazione per istruzioni dettagliate sull'installazione.

Quindi scarica ONLYOFFICE-ownCloud VM per l'hypervisor che hai scelto.

Importa l'appliance virtuale

Ora apri l'hypervisor e importa l'appliance virtuale ONLYOFFICE-ownCloud. Questa guida descrive come farlo su entrambe le piattaforme.

Installa l'applicazione

Una volta che l'immagine è stata importata correttamente, avvia la Virtual Machine. Segui il processo di avvio tramite la procedura guidata di installazione, seguendo i passaggi seguenti.

1. Scegli la tua lingua e inserisci la città più vicina.
   

   La procedura guidata otterrà la localizzazione di sistema predefinita, il fuso orario e il layout della tastiera.

   
2. Configura il tuo dominio e le impostazioni di rete. Per impostazione predefinita, ottieni automaticamente un indirizzo IP. In alternativa, puoi specificare manualmente il tuo indirizzo IP, la maschera di rete e il gateway. Inserisci l'indirizzo del server DNS preferito.
   
3. Seleziona le impostazioni del tuo dominio. L'opzione Gestisci utenti e permessi direttamente su questo sistema è selezionata per impostazione predefinita. Consente di creare un nuovo dominio in questo sistema. In alternativa, puoi connetterti al dominio UCS o Microsoft Active Directory esistente.
   
4. Inserisci il nome della tua azienda, l'indirizzo email dell'amministratore per attivare ONLYOFFICE (il file di licenza verrà inviato a questo indirizzo email), crea e conferma una nuova password per il tuo account amministratore.
   
5. Specifica il nome di dominio completo per questo sistema e la base LDAP:
   
6. Rivedi le tue impostazioni e assicurati che tutto sia compilato correttamente. Quindi fai clic sul pulsante Configure System.
   
7. Una volta che tutto è configurato, ONLYOFFICE è pronto per iniziare in una piattaforma UCS appena creata.
   
   
8. Inserisci il tuo indirizzo IP nella barra degli indirizzi del browser e carica il tuo file ucs.license ricevuto via email.
9. Per accedere alla tua appliance ONLYOFFICE Docs e ownCloud, fai clic su ownCloud nella sezione Applications e inserisci il nome utente e la password predefiniti (owncloud, owncloud).

   Per accedere alla tua Univention Management Console, fai clic su LOGIN in alto o su System and domain settings nella sezione Administration e inserisci il tuo indirizzo email dell'amministratore e la password specificata durante la registrazione (vedi passo 4).

   

Abilitazione della modifica per ownCloud Web

Per abilitare il lavoro all'interno di ownCloud Web, registra il connettore nel config.json di ownCloud Web:

• Se hai installato ownCloud Web dal marketplace ufficiale, il percorso è

  owncloud-root-catalog

• Se l'hai compilato tu stesso dal codice sorgente utilizzando questa istruzione, il percorso è

  owncloud-web-root-catalog/config/config.json

Per registrare il connettore, utilizza queste righe:

"external_apps": [ { "id": "onlyoffice", "path": "http(s):///custom/onlyoffice/js/web/onlyoffice.js" } ] 

A seconda della configurazione del tuo server web, puoi eliminare il segmento index.php dal percorso URL.