SuiteCRM

Informazioni sull'integrazione di ONLYOFFICE e SuiteCRM

SuiteCRM è un sistema di gestione delle relazioni con i clienti. ONLYOFFICE offre un modulo ufficiale per integrare ONLYOFFICE Docs con SuiteCRM e modificare documenti di office nel tuo spazio SuiteCRM. Puoi ottenere il modulo di integrazione ONLYOFFICE dalla pagina GitHub. Il modulo è distribuito con licenza AGPL-3.

note

Per saperne di più sul funzionamento del connettore ONLYOFFICE per SuiteCRM, visita la nostra pagina della documentazione API.

Funzionalità principali

• Modifica e visualizzazione di documenti di testo, fogli di calcolo e presentazioni.

• Co-modifica dei documenti in tempo reale: due modalità di co-modifica (Veloce e Rigorosa), la modalità Revisione delle modifiche, i commenti e la chat integrata.

• Creazione e modifica di modelli di moduli.

  note

  Per saperne di più sui moduli, leggi gli articoli corrispondenti sulla creazione e sulla compilazione dei moduli.

• Supporto JWT per proteggere il tuo traffico in modo che nessuno possa accedere ai tuoi documenti, ad eccezione degli utenti con i diritti appropriati.

Formati supportati

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

Collegare ONLYOFFICE Docs a SuiteCRM

Requisiti

• ONLYOFFICE Document Server v7.1 (versione server) o successiva

  Hai bisogno di un'istanza di ONLYOFFICE Docs risolvibile e raggiungibile sia da SuiteCRM sia da qualsiasi client finale. Deve poter inviare richieste POST direttamente a SuiteCRM.

  note

  Consulta la pagina della documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.

• SuiteCRM 7 (tutte le release 7.x)

• Connettore ONLYOFFICE v1.0.0 o successiva per SuiteCRM

Installare il modulo di integrazione ONLYOFFICE per SuiteCRM

Per installare l'applicazione ONLYOFFICE:

1. Ottieni gli ultimi file del pacchetto compilato del plugin di integrazione ONLYOFFICE dalla pagina GitHub.

2. Avvia SuiteCRM e passa a Admin > Admin Tools > Module Loader.

   

3. Carica l'archivio del plugin ONLYOFFICE.

4. Installa il modulo caricato premendo il pulsante Install (Installa).

5. Passa a Admin > Admin Tools > Repair.

6. Esegui Quick Repair and Rebuild.

   

Come funziona

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

Di seguito è riportata una spiegazione dei termini chiave utilizzati in questa documentazione.

Il lato client comprende:

• Document manager (gestore dei documenti): l'elenco dei documenti visualizzato nel browser dell'utente, dove l'utente può selezionare il documento necessario ed eseguire alcune azioni su di esso (a seconda dei diritti concessi, l'utente può aprire il documento per visualizzarlo o modificarlo, e condividerlo con altri utenti).
• Document editor (editor di documenti): l'interfaccia di visualizzazione e modifica dei documenti con tutte le più note funzionalità di modifica disponibili, utilizzata come mezzo tra l'utente e il document editing service.

Il lato server comprende:

• Document storage service (servizio di archiviazione dei documenti): il servizio server che archivia tutti i documenti disponibili per gli utenti con i diritti di accesso appropriati. Fornisce al document manager gli ID dei documenti e i link a tali documenti, che l'utente vede nel browser.
• Document editing service (servizio di modifica dei documenti): il servizio server che consente di visualizzare e modificare i documenti (se l'utente ha i diritti appropriati per farlo). L'interfaccia del document editor viene utilizzata per accedere a tutte le funzionalità del document editing service.
• Document command service (servizio di comandi sui documenti): il servizio server che consente di eseguire comandi aggiuntivi con il document editing service.
• Document conversion service (servizio di conversione dei documenti): il servizio server che consente di convertire il file del documento nel formato Office Open XML appropriato (docx per i documenti di testo, xlsx per i fogli di calcolo e pptx per le presentazioni) per la modifica o il download.
• Document builder service (servizio di creazione dei documenti): il servizio server che consente di creare facilmente un documento senza dover effettivamente eseguire un editor di elaborazione dei documenti.

Tieni presente che ONLYOFFICE Document Server include il document editor, il document editing service, il document command service, il document conversion service e il document builder service. Il document manager e il document storage service sono inclusi in Community Server oppure devono essere implementati dagli integratori di software che utilizzano ONLYOFFICE Document Server sul proprio server.

Configurare 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 viene salvato solo lato client, quindi la trasmissione tra le parti è protetta e firmata digitalmente.

Il token viene generato utilizzando lo standard JWT (JSON Web Tokens). I token sono firmati con la chiave del server, quindi il client può verificare che il token sia legittimo.

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

In ONLYOFFICE Docs, JWT è abilitato per impostazione predefinita a partire dalla versione 7.2.

Segui questi passaggi per configurarlo manualmente, se necessario:

1. Vai su Admin > ONLYOFFICE > ONLYOFFICE Settings (Impostazioni di ONLYOFFICE).

   

2. Inserisci i valori nei seguenti campi:

   • Document Editing Service Address (Indirizzo del Document Editing Service): specifica l'indirizzo URL in cui è installato ONLYOFFICE Docs (ad esempio, https://documentserver).
   • Secret key (Chiave segreta) (lascia vuoto per disabilitare): la chiave segreta viene generata automaticamente per limitare l'accesso a ONLYOFFICE Docs. Se vuoi specificare in questo campo la tua chiave segreta, specifica la stessa chiave segreta anche nel file di configurazione di ONLYOFFICE Docs per abilitare la convalida.
   • Authorization header (Intestazione di autorizzazione) (lascia vuoto per usare l'intestazione predefinita): l'intestazione JWT standard utilizzata in ONLYOFFICE è Authorization. Se questa intestazione è in conflitto con la tua configurazione, puoi cambiarla con una personalizzata.

   

Iniziare a usare ONLYOFFICE Docs in SuiteCRM

Per modificare i file di office e collaborare su di essi:

• Vai al modulo Documents (Documenti).
• Apri la pagina Detail View (Vista dettagliata) facendo clic sul nome del file.
• Nella pagina Detail View, fai clic su Open in ONLYOFFICE (Apri in ONLYOFFICE) nel menu a discesa ACTIONS (AZIONI): il file si aprirà nella stessa scheda.

note

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