SharePoint

Informazioni sull'integrazione di ONLYOFFICE e SharePoint

Per modificare i documenti all'interno della piattaforma collaborativa SharePoint, puoi integrare ONLYOFFICE Docs con la tua libreria di documenti utilizzando il connettore ufficiale di ONLYOFFICE o WOPI. Per ulteriori informazioni, visita la pagina GitHub del connettore ONLYOFFICE per SharePoint. Il connettore è distribuito sotto la licenza AGPL-3.0.

Per saperne di più su come funziona il connettore ONLYOFFICE per SharePoint, visita la nostra pagina di documentazione API.

Metodi di connessione

ONLYOFFICE Docs può essere collegato a SharePoint utilizzando due metodi: il connettore ufficiale o WOPI. Entrambi i metodi consentono di modificare i documenti direttamente in SharePoint, ma differiscono per funzionalità e formati supportati.

Avviso

Consigliamo vivamente di scegliere un solo metodo di installazione. Se l'installazione viene eseguita con entrambi i metodi, le funzionalità collaborative e il salvataggio dei documenti potrebbero non funzionare come previsto.

Confronto delle funzionalità

Funzionalità	Connettore ufficiale	WOPI
Modifica dei documenti dal menu contestuale / barra multifunzione	✓ (Apri in ONLYOFFICE)	✓ (Clicca sul file / Menu contestuale → Apri → Apri in office online)
Modalità di co-editing Veloce	✓	✓
Modalità di co-editing Rigida	✓	✗ 1
Tracciamento delle modifiche	✓	✗
Commenti, chat integrata	✓	✓
Cronologia Versioni	✗	✗
Stampa Unione	✓	✓
Inserimento di un'immagine dall'archivio	✗	✗
Confronto dei documenti	✓	✗

¹ La modalità di co-editing Rigida potrebbe influire negativamente sul parametro del token di accesso quando si utilizza WOPI.

Importante

Quando si utilizza WOPI, i token di accesso scadono dopo un certo periodo di tempo. Imposta la proprietà access_token_ttl a 10 ore per la modalità di co-editing Veloce.

Formati supportati

Connettore ufficiale:

• Per visualizzazione e modifica: DOCM, DOCX, DOTM, DOTX, PDF, POTM, POTX, PPSM, PPSX, PPTM, PPTX, XLSB, XLSM, XLSX, XLTM, XLTX
• Solo per visualizzazione: CSV, DJVU, DOC, DOT, DPS, DPT, EPUB, ET, ETT, FB2, FODP, FODS, FODT, HML, HTM, HTML, HWP, HWPX, KEY, MD, MHT, MHTML, NUMBERS, ODG, ODT, ODP, ODS, OTT, OTP, OXPS, PAGES, POT, PPS, PPT, RTF, STW, SXC, SXI, SXW, TXT, VSDM, VSDX, VSSM, VSSX, VSTM, VSTX, WPS, WPT, XLS, XLT, XML, XPS

WOPI:

• Per visualizzazione e modifica: DOCX, XLSX, PPTX, DOCM, XLSM, PPTM, ODT, ODS, ODP, CSV, PDF
• Solo per visualizzazione: DJVU, XPS

note

I formati disponibili dipendono dalla versione di ONLYOFFICE Docs e dal metodo di connessione selezionato.

Novità nella versione 3.1.0

Modificato

• Aggiunti nuovi formati supportati

Il registro completo delle modifiche è disponibile qui.

Utilizzo del connettore ufficiale

Requisiti

• ONLYOFFICE Document Server v7.1 (server o versione cloud) o successiva. L'istanza deve essere risolvibile e raggiungibile sia da SharePoint che da qualsiasi client finale, e deve essere in grado di inviare POST direttamente a SharePoint. Per maggiori informazioni inerenti all'installazione di ONLYOFFICE Docs, consultare la pagina di documentazione ufficiale.
• SharePoint 2019
• Connettore ONLYOFFICE 3.1.0 per SharePoint

Installazione e configurazione

La soluzione di integrazione ONLYOFFICE SharePoint è un connettore ufficiale di ONLYOFFICE disponibile sulla pagina GitHub sotto la licenza GNU AGPL v.3.

Per saperne di più su come funziona e come compilare la soluzione, visita la nostra documentazione API.

1. Clicca su Start, vai su Tutti i Programmi, vai su Strumenti Amministrativi, quindi clicca su Servizi, e assicurati che il servizio Amministrazione SharePoint sia avviato.

2. Clicca su Start, apri la Shell di Gestione SharePoint, e naviga nella directory contenente il file .wsp.

3. Esegui lo script Install.ps1:

   PS> .\Install.ps1

4. Inserisci l'indirizzo del tuo sito SharePoint:

   https://<yoursharepointsite>

   Invece dei passaggi 3 e 4 puoi digitare il seguente comando:

   Add-SPSolution -LiteralPath<solutionpath>/onlyoffice.wsp

   Sulla home page di Amministrazione Centrale SharePoint, clicca su Impostazioni di Sistema → Gestione Farm → Gestisci soluzioni farm. Nella pagina di Gestione Soluzioni, clicca su onlyoffice.wsp, quindi clicca su Distribuisci Soluzione.

5. Sulla home page di Amministrazione Centrale SharePoint, sotto Gestione Applicazioni, clicca su Gestisci applicazioni web.

6. Assicurati di selezionare il tuo sito e clicca sull'icona Provider di Autenticazione.

7. Nella finestra pop-up Provider di Autenticazione, clicca su Zona predefinita.

8. Sotto Modifica Autenticazione, seleziona Abilita accesso anonimo e clicca su Salva.

9. Tornando a Gestione Applicazioni Web, clicca sull'icona Politica Anonima.

10. Sotto Restrizioni Accesso Anonimo, seleziona la tua Zona e imposta la politica Permessi a Nessuno – No e clicca su Salva.

11. In SharePoint, apri la pagina /_layouts/15/Onlyoffice/Settings.aspx con le impostazioni amministrative. Inserisci il seguente indirizzo:

    https://<documentserver>/

    Dove il documentserver è il nome del server con installato ONLYOFFICE Docs. L'indirizzo deve essere accessibile per il browser dell'utente e dal server SharePoint. L'indirizzo del server SharePoint deve anche essere accessibile da ONLYOFFICE Docs per un corretto funzionamento.

Se hai sottositi configurati con SharePoint, sarà necessario configurare ulteriormente la connessione di ONLYOFFICE Docs con ciascuno di essi. Vai alle impostazioni di ciascun sottosito e inserisci l'indirizzo dei Docs nel campo appropriato.

A partire da ONLYOFFICE Docs v7.2, JWT è abilitato di default e la chiave segreta è generata automaticamente. Devi abilitarla anche dal lato SharePoint: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specifica la stessa chiave segreta nelle impostazioni amministrative di SharePoint. Per ulteriori dettagli, consulta la sezione Abilitazione JWT di seguito.

Se la protezione JWT è abilitata, è necessario specificare un nome di intestazione personalizzato, poiché la politica di sicurezza di SharePoint blocca le intestazioni 'Authorization' esterne. Questa intestazione deve essere specificata anche nelle impostazioni della firma di ONLYOFFICE Docs (ulteriori informazioni sono disponibili qui).

Compilazione della soluzione

Ci sono due modi per compilare la soluzione di integrazione ONLYOFFICE SharePoint:

• Utilizzando MS Visual Studio:

  1. Accedi al server SharePoint e apri questo progetto in Visual Studio.
  2. In Esplora Soluzioni, apri il menu di scelta rapida per il progetto e poi scegli Pubblica.
  3. Nella finestra di dialogo Pubblica, scegli l'opzione Pubblica su File System.
  4. Clicca sul pulsante Pubblica. Quando il processo di pubblicazione è terminato, il file di soluzione .wsp verrà creato.
  5. Copia il file risultante nella cartella con il file Install.ps1 (cartella BuildAndInstall per impostazione predefinita).

• Utilizzando il file build.bat:

  1. Vai alla cartella BuildAndInstall.
  2. Esegui il file build.bat.
  3. Il file di soluzione .wsp risultante verrà creato e posizionato nella cartella BuildAndInstall.

Come funziona

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

1. L'utente va su un documento all'interno di SharePoint e seleziona l'azione Modifica in ONLYOFFICE nel menu contestuale o sulla barra multifunzione.

2. SharePoint effettua una richiesta alla pagina dell'editor (con un URL di questo tipo: /_layouts/15/Onlyoffice/editorPage.aspx?SPListItemId={ItemId}&SPListURLDir={ListUrlDir}&action=track).

3. SharePoint 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 informa sullo stato della modifica del documento;
   • DocumentSeverHost — l'URL utilizzato dal client per connettersi all'ONLYOFFICE Document Server (può essere impostato nella pagina delle impostazioni);
   • Key — l'identificatore del file da SharePoint;
   • FileName — il titolo del documento (nome);
   • CurrentUserId — l'identificatore dell'utente;
   • CurrentUserName — il nome utente.

4. SharePoint costruisce una pagina, riempiendo tutti questi valori in modo che il browser del client possa caricare l'editor.

5. Il browser del client effettua una richiesta alla libreria JavaScript di ONLYOFFICE Docs e invia a ONLYOFFICE Docs la configurazione DocEditor con le proprietà sopra indicate.

6. Quindi ONLYOFFICE Docs scarica il documento da SharePoint e l'utente inizia a modificare.

7. Quando tutti gli utenti e i browser dei client hanno finito di modificare, chiudono la finestra di modifica.

8. Dopo 10 secondi di inattività, ONLYOFFICE Docs invia un POST a callbackUrl informando la soluzione ONLYOFFICE per SharePoint che i client hanno terminato di modificare il documento e lo hanno chiuso.

9. SharePoint scarica una nuova versione del documento, sostituendo quella vecchia.

Per saperne di più sui problemi più comuni e su come risolverli, visita la nostra guida alla risoluzione dei problemi.

Abilitazione JWT

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 il Document Editor 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 di ONLYOFFICE Docs.

A partire da ONLYOFFICE Docs v7.2, JWT è abilitato di default e la chiave segreta è 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 docker exec -it <containerID> bash e apri /etc/onlyoffice/documentserver/local.json. In alternativa, esegui:

     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ì:

   {
     "services": {
       "CoAuthoring": {
         "token": {
           "enable": {
             "request": {
               "inbox": true,
               "outbox": true
             },
             "browser": true
           }
         },
         "secret": {
           "inbox": {
             "string": "yoursecret"
           },
           "outbox": {
             "string": "yoursecret"
           },
           "session": {
             "string": "yoursecret"
           }
         }
       }
     }
   }

2. Il valore true è specificato in tre sezioni, il che 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 predefinito con la tua chiave: deve essere la stessa in tutte e tre le 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:

   supervisorctl restart all

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

Nelle impostazioni del connettore, specifica lo stesso segreto nel campo Chiave segreta e salva le impostazioni.

Utilizzo di WOPI

Puoi anche connettere ONLYOFFICE Docs con SharePoint tramite WOPI, un protocollo basato su REST che emette richieste HTTP a un insieme di endpoint REST quando un client stabilisce una connessione al server con i tuoi dati.

Limitazioni

La connessione di ONLYOFFICE Docs tramite WOPI manca di alcune funzionalità a causa dell'architettura WOPI:

• Nessun supporto per la funzionalità Cronologia Versioni.
• L'inserimento di un'immagine dall'archivio non è supportato.
• Il confronto dei documenti non è supportato.
• Nessun supporto per i seguenti formati: DOC, XLS, PPT.

Requisiti

• ONLYOFFICE Document Server v7.1 o successiva con WOPI abilitato. Segui queste istruzioni per abilitare WOPI.
• SharePoint 2019

Connessione tramite WOPI

1. Apri il tuo server SharePoint. Esegui la console Shell di Gestione SharePoint e imposta la zona WOPI necessaria:

   Set-SPWOPIZone -Zone "external-http"

   Il documentserver utilizza il parametro external-http per impostazione predefinita.

2. Verifica se ci sono associazioni WOPI ad altri tipi di documenti sulla farm corrente:

   Get-SPWOPIBinding

   Elimina queste associazioni, se presenti:

   Remove-SPWOPIBinding -All:$true

3. Crea nuove associazioni per le azioni predefinite in base ai tipi di file.

   Per creare associazioni per tutti i tipi di file contemporaneamente:

   New-SPWOPIBinding -ServerName ip_or_domain.com:port

   Per creare associazioni solo per determinati tipi di file:

   New-SPWOPIBinding -ServerName ip_or_domain.com:port -Extension DOCX

   Se non viene utilizzato SSL, aggiungi -AllowHTTP alla fine del comando.

Abilitazione dell'intestazione di autorizzazione

Il parametro wopi.sendAuthorizationHeader aggiunge l'intestazione Authorization: Bearer <access_token> alle richieste WOPI. È facoltativo secondo la specifica WOPI, ma obbligatorio a seconda della versione di SharePoint:

• SharePoint Subscription Edition: questo parametro deve essere abilitato. Senza di esso si verifica l'errore Invalid access token e la modifica del documento non riesce.
• SharePoint 2019: questo parametro è facoltativo. La connessione funziona con il token passato nell'URI, ma abilitare l'intestazione non causa problemi.

Per abilitare wopi.sendAuthorizationHeader, utilizza uno dei seguenti modi:

• Modifica il file di configurazione /etc/onlyoffice/documentserver/default.json, oppure aggiungi quanto segue a /etc/onlyoffice/documentserver/local.json per conservare le modifiche dopo gli aggiornamenti:

  {
    "wopi": {
      "sendAuthorizationHeader": true
    }
  }

  Dopo aver apportato le modifiche, riavvia i servizi:

  supervisorctl restart all

• Nelle build commerciali, questo parametro può essere configurato anche tramite il Pannello di amministrazione.

Creazione di nuovi documenti

Importante

Le seguenti istruzioni sono valide solo per il metodo di connessione WOPI.

Per poter creare nuovi documenti, imposta i parametri descritti di seguito. Questo esempio è fornito solo per i file DOCX, ma puoi aggiungere XLSX, PPTX e altri file in modo simile.

1. Abilita l'impostazione Consenti gestione dei tipi di contenuto: vai su Documenti → Impostazioni libreria → Impostazioni avanzate. Nella sezione Consenti gestione dei tipi di contenuto, seleziona Sì e clicca su OK.

   

2. Nella libreria Documenti, vai su Contenuti del sito → Impostazioni del sito → Tipi di contenuto del sito. Clicca su Crea. Compila il modulo: Nome (Nuovo documento), Descrizione. Nel Tipo di contenuto principale, scegli Tipi di contenuto documento, Documento. Nel Gruppo esistente, scegli Tipi di contenuto personalizzati e clicca su OK.

   

3. Nella libreria Documenti, vai su Contenuti del sito → Impostazioni del sito → Tipi di contenuto del sito. Seleziona il Nuovo documento appena aggiunto. Vai su Impostazioni avanzate → Modello di documento → Carica un nuovo modello di documento. Clicca sul pulsante Scegli File, carica il documento necessario e clicca su OK.

   

4. Vai alla libreria Documenti → Impostazioni libreria. Nella sezione Tipi di contenuto, seleziona Aggiungi da tipi di contenuto del sito esistenti. Nell'elenco Seleziona tipi di contenuto del sito da, seleziona Tipi di contenuto personalizzati. Nel campo Tipi di contenuto del sito disponibili, scegli Nuovo documento. Clicca sul pulsante Aggiungi >, quindi clicca su OK.

   

5. Nella libreria Documenti, aggiorna la pagina e premi il pulsante Nuovo.

   

6. Il tipo di contenuto Documento verrà aggiunto automaticamente come tipo principale. Deve essere nascosto: vai alla libreria Documenti → Impostazioni libreria. Nella sezione Tipi di contenuto, seleziona Cambia ordine del pulsante nuovo e tipo di contenuto predefinito.

   

   Nella colonna Visibile, deseleziona la casella di controllo per il tipo di contenuto Documento e clicca su OK.

   

7. Nella libreria Documenti, aggiorna la pagina e premi il pulsante Nuovo — sarà disponibile solo la voce di menu Nuovo documento.