SuiteCRM

Caratteristiche principali

• Modifica e visualizzazione di documenti di testo, fogli di calcolo e presentazioni.
• Co-editing dei documenti in tempo reale: due modalità di co-editing (Veloce e Rigida), la modalità Traccia Modifiche, commenti e chat integrata.
• Creazione e modifica di modelli per moduli compilabili.
  Per saperne di più sui moduli, leggi gli articoli corrispondenti per creare e compilare moduli.
• Supporto JWT per proteggere il traffico e garantire che solo gli utenti autorizzati, con i permessi adeguati, possano accedere ai tuoi documenti.

Formati supportati

• Per visualizzazione e modifica: DOCX, XLSX, PPTX.
• Solo per visualizzazione: PDF, ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM, TXT, CSV.

Requisiti

• ONLYOFFICE Document Server v7.1 (server) o successivo

  Hai bisogno di un'istanza di ONLYOFFICE Docs raggiungibile e risolvibile sia da SuiteCRM sia dai client finale. Inoltre, l'istanza deve poter inviare richieste POST direttamente a SuiteCRM per garantire il corretto funzionamento dell'integrazione.

  Si prega di fare riferimento alla pagina di documentazione ufficiale per ulteriori informazioni sul processo di installazione di ONLYOFFICE Docs.
• SuiteCRM 7 (tutte le versioni 7.x)
• Connettore ONLYOFFICE v1.0.0 e successivi per SuiteCRM

Installazione del modulo di integrazione ONLYOFFICE per SuiteCRM

Per installare l'applicazione ONLYOFFICE:

1. Scarica i file dell'ultima versione compilata del plugin di integrazione ONLYOFFICE dalla relativa pagina GitHub.
2. Avvia SuiteCRM e passa a Admin > Strumenti di amministrazione > Caricatore di moduli.
   
3. Carica l'archivio del plugin ONLYOFFICE.
4. Installa il modulo caricato cliccando su Installa.
5. Passa a Admin > Strumenti di amministrazione > Ripara.
6. Esegui Riparazione e Ricostruzione Rapida.
   

Come funziona

L'interazione tra utente e documento avviene sia a lato client che alato server.

Di seguito è riportata una spiegazione dei termini chiave utilizzati in queste guide.

Il lato client include:

• Gestore documenti - l’elenco dei documenti visualizzati nel browser dell’utente. Da qui l’utente può selezionare il documento desiderato ed eseguire diverse operazioni in base ai permessi assegnati, come aprire il documento per la visualizzazione o la modifica oppure condividerlo con altri utenti.
• Editor documenti - l'interfaccia per la visualizzazione e la modifica dei documenti, dotata delle funzionalità di editing più comuni. Funge da collegamento tra l’utente e il servizio di modifica documenti.

Il lato server include:

• Servizio di archiviazione documenti - il servizio che memorizza tutti i documenti accessibili agli utenti autorizzati. Fornisce al gestore documenti gli ID e i link dei documenti mostrati nel browser.
• Servizio di modifica documenti - il servizio che consente di visualizzare e modificare i documenti, se l’utente dispone dei permessi necessari. Le sue funzionalità sono accessibili tramite l’editor documenti.
• Servizio di comando documenti - il servizio che permette di eseguire operazioni aggiuntive tramite il servizio di modifica documenti.
• Servizio di conversione documenti - il servizio che consente di convertire il file del documento nel formato appropriato Office Open XML (docx per i documenti di testo, xlsx per i fogli di calcolo e pptx per le presentazioni) per modificarli o scaricarli.
• Servizio di costruzione documenti - il servizio che consente di generare documenti senza dover avviare un editor di documenti completo.

ONLYOFFICE Document Server include l'editor documenti, il servizio di modifica documenti, il servizio di comando documenti, il servizio di conversione documenti e il servizio di costruzione documenti. Il gestore documenti e il servizio di archiviazione documenti sono inclusi nel Community Server; in alternativa devono essere implementati dagli integratori software che utilizzano ONLYOFFICE Document Server sul proprio server.

Configurazione JWT per l'integrazione di ONLYOFFICE e SuiteCRM

JWT o JSON Web Token è una stringa inviata dal client al server all'interno della richiesta HTTP per convalidare l'autenticità del client. JWT è salvato solo sul lato client, quindi la trasmissione tra le parti è protetta e firmata digitalmente.

Il token è generato utilizzando lo standard JWT (JSON Web Tokens). I token sono firmati dalla chiave del server, quindi il client è in grado di verificare che il token sia legittimo.

ONLYOFFICE Docs convalida il token. I dati dal payload sono considerati validi e vengono utilizzati al posto dei dati corrispondenti dai parametri principali. Se il token è invalido, il comando non viene eseguito. Per saperne di più, leggi la guida alla sicurezza API.

In ONLYOFFICE Docs, JWT è abilitato di default a partire dalla versione 7.2.

Segui questi passaggi per configurarlo manualmente se necessario:

1. Vai su Admin > ONLYOFFICE > Impostazioni ONLYOFFICE.
   
2. Inserisci i valori nei seguenti campi:
   • Indirizzo del Servizio di Modifica Documenti: Specifica l'indirizzo URL dell'istanza di ONLYOFFICE Docs installata (es., https://documentserver).
   • Chiave segreta (lascia il campo vuoto per disattivarla): La chiave segreta viene generata automaticamente per limitare l'accesso a ONLYOFFICE Docs. Se inserisci una chiave segreta in questo campo, aggiungi la stessa chiave segreta nel file di configurazione di ONLYOFFICE Docs, per abilitare la convalida.
   • Intestazione di autorizzazione (lascia vuoto per usare l'intestazione predefinita): l'intestazione JWT standard usata su ONLYOFFICE è Authorization. Nel caso in cui l'intestazione sia in conflitto con la tua configurazione, puoi sostituirla con una personalizzata.