Passa al contenuto principale

Mattermost

Informazioni sull'integrazione di ONLYOFFICE e Mattermost​

ONLYOFFICE offre un connettore ufficiale per integrare ONLYOFFICE Docs con Mattermost per collaborare su documenti d'ufficio inviati in chat private o di gruppo. Puoi scaricarlo dal sito ufficiale o da GitHub. L'applicazione è distribuita con licenza Apache.

note

Per saperne di più su come funziona e come compilare il connettore ONLYOFFICE per Mattermost, visita la nostra documentazione API.

Caratteristiche principali​

  • Visualizza e modifica documenti di testo, fogli di calcolo e presentazioni utilizzando l'opzione Apri file in ONLYOFFICE.
  • Gestisci i diritti di accesso (Modifica o Lettura) dal menu contestuale con l'opzione Cambia diritti di accesso.
  • Co-editing dei documenti in tempo reale: due modalità di co-editing (Veloce e Rigida).
  • Live Viewer: gli utenti con accesso in sola lettura possono seguire in tempo reale le modifiche apportate da altri editor, inclusi i loro cursori. Disponibile solo per le installazioni su server, abilitato per impostazione predefinita.
  • Visualizza la cronologia delle modifiche del file.
  • Temi moderni Chiaro e Scuro dell'interfaccia per gli editor.
  • Notifiche per gli amministratori quando l'editor ONLYOFFICE diventa non disponibile (Abilita le notifiche di stato nella Console di Sistema).
  • Ricaricamento automatico dell'editor quando la connessione viene ripristinata.
  • Supporto JWT per proteggere il tuo traffico in modo che nessuno oltre agli utenti con i diritti appropriati abbia accesso ai tuoi documenti.

Formati supportati​

  • Per la modifica:
    • WORD: DOCM, DOCX, DOTM, DOTX
    • CELL: XLSB, XLSM, XLSX, XLTM, XLTX
    • SLIDE: POTM, POTX, PPSM, PPSX, PPTM, PPTX
    • PDF: PDF
  • Per la visualizzazione:
    • WORD: DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HML, 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, TSV, XLS, XLSB, 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, OXPS, PDF, XPS
    • DIAGRAM: VSDM, VSDX, VSSM, VSSX, VSTM, VSTX

Novità della versione 2.3.0​

Aggiunto

  • Live Viewer: gli utenti con accesso in sola lettura ora possono vedere in tempo reale le modifiche degli altri editor, inclusi i loro cursori. Disponibile solo per le installazioni su server, non è richiesta alcuna configurazione aggiuntiva.
  • Supporto per i temi dell'interfaccia Scuro moderno e Scuro chiaro (scheda Visualizza → Tema dell'interfaccia → Scuro moderno / Scuro chiaro).
  • Notifiche per gli amministratori in caso di disconnessione dell'editor tramite l'opzione Abilita le notifiche di stato nella Console di Sistema.
  • Ricaricamento automatico dell'editor quando la connessione viene ripristinata.

Il registro completo delle modifiche è disponibile qui.

Collegare ONLYOFFICE Docs a Mattermost​

Requisiti​

  • ONLYOFFICE Document Server v6.4.0 (server o versione cloud) o successiva

    Hai bisogno di un'istanza di ONLYOFFICE Docs che sia raggiungibile e accessibile sia da Mattermost, sia da qualsiasi client finale. Deve essere in grado di inviare POST direttamente a Mattermost.

    note

    Fare riferimento alla pagina della documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.

    ONLYOFFICE Docs e Mattermost possono essere installati su computer diversi o sulla stessa macchina. Se i due software sono ospitati sulla stessa macchina, configura una porta personalizzata per il Document Server.

  • Mattermost v. 10.11.0 o successiva

  • ONLYOFFICE Connector v2.3.0 per Mattermost

Installare il connettore ONLYOFFICE per Mattermost​

Per connettere Mattermost, segui questi passaggi:

  1. Installa Node.js. Consulta la documentazione di installazione per maggiori dettagli.

  2. Installa Go. Consulta la documentazione di installazione per maggiori dettagli. I passaggi di installazione variano a seconda del tuo sistema operativo.

  3. Installa make:

    sudo apt install make

  4. Clona il ramo del plugin:

    git clone https://github.com/ONLYOFFICE/onlyoffice-mattermost.git

  5. Vai alla radice del progetto e recupera i sottomoduli git:

    cd onlyoffice-mattermost/
    git submodule update --init --recursive

  6. Avvia la compilazione:

    make

Configurare il connettore ONLYOFFICE per Mattermost​

Vai a Console di Sistema → trova il plugin ONLYOFFICE tramite ricerca → Configura. Abilita il plugin nel campo corrispondente e specifica i seguenti parametri:

  1. Indirizzo di ONLYOFFICE Docs — inserisci l'indirizzo URL dove è installato ONLYOFFICE Docs (ad es., https://documentserver).

    note

    L'indirizzo di ONLYOFFICE Docs deve essere accessibile da Mattermost, così come l'indirizzo di Mattermost deve essere accessibile da ONLYOFFICE Docs.

  2. Segreto JWT del Document Server — il segreto JWT del server documenti utilizzato per firmare i dati.

    note

    A partire da ONLYOFFICE Docs v7.2, JWT è abilitato per impostazione predefinita e la chiave segreta viene generata automaticamente. Devi abilitarlo anche sul lato Mattermost: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, poi specifica la stessa chiave segreta nelle impostazioni del connettore. Per maggiori dettagli, consulta la sezione Abilitare JWT per l'integrazione di ONLYOFFICE e Mattermost di questo articolo.

  3. Intestazione JWT — specifica l'intestazione JWT.

    note

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

  4. Prefisso JWT — specifica il prefisso JWT.

  5. Puoi anche connetterti per un mese al server di test pubblico di ONLYOFFICE Docs selezionando la casella Connessione al server demo di ONLYOFFICE Docs abilitata.

  6. Formati — seleziona i formati di file che devono essere aperti in ONLYOFFICE Docs. Tutti i formati sono abilitati per impostazione predefinita. Deseleziona i formati per disabilitarli.

  7. Protezione dei file solo da parte del proprietario — quando abilitata, solo i proprietari dei file possono proteggere/rimuovere la protezione dei file tramite la scheda Protezione. Quando disabilitata, la protezione dei file è disponibile per tutti.

  8. Abilita i plugin ONLYOFFICE — quando abilitata, gli utenti possono accedere ai plugin negli editor. Quando disabilitata, i plugin sono nascosti.

  9. Abilita le macro — quando abilitata, gli utenti possono creare ed eseguire macro negli editor. Quando disabilitata, tutte le funzionalità delle macro sono nascoste.

  10. Abilita le notifiche di stato — abilita questa opzione per ricevere le notifiche degli amministratori quando l'editor ONLYOFFICE diventa non disponibile.

Configurazione di ONLYOFFICE

Come funziona​

L'interazione utente-documento avviene sia lato client sia lato server.

Le principali nozioni utilizzate in questa documentazione sono spiegate di seguito.

Il lato client comprende:

  • Document manager — 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 forniti, l'utente può aprire il documento per visualizzarlo o modificarlo e condividerlo con altri utenti).
  • Document editor — l'interfaccia di visualizzazione e modifica dei documenti con tutte le funzioni di modifica più note disponibili, utilizzata come mezzo tra l'utente e il document editing service.

Il lato server comprende:

  • Document storage service — il servizio del server che archivia tutti i documenti disponibili agli utenti con i diritti di accesso appropriati. Fornisce gli ID dei documenti e i collegamenti a tali documenti al document manager che l'utente vede nel browser.
  • Document editing service — il servizio del server che consente di visualizzare e modificare i documenti (nel caso in cui l'utente abbia 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 — il servizio del server che consente di eseguire comandi aggiuntivi con il document editing service.
  • Document conversion service — il servizio del 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 — il servizio del server che consente di creare facilmente un documento senza la necessità di 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 nel Community Server oppure devono essere implementati dagli integratori di software che utilizzano ONLYOFFICE Document Server sul proprio server.

Abilitare JWT per l'integrazione di ONLYOFFICE e Mattermost​

Per proteggere i documenti dall'accesso non autorizzato, gli editor ONLYOFFICE utilizzano il JSON Web Token (JWT). Il token viene aggiunto alla configurazione quando viene inizializzato il Document Editor e durante lo scambio di comandi tra i servizi interni di ONLYOFFICE Docs. La chiave segreta viene utilizzata per firmare il JSON Web Token e convalidare il token al momento della 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.

Passaggio 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 avere il seguente aspetto:

    {
      "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. Ciò 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 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 affinché le modifiche alla configurazione abbiano effetto.

    supervisorctl restart all

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

Inizia a usare ONLYOFFICE Docs all'interno di Mattermost​

Visualizzazione e modifica dei file​

  • Clicca sul pulsante Altre azioni Pulsante Altre azioni accanto a un file inviato in una chat di Mattermost.

  • Scegli l'opzione Apri file in ONLYOFFICE dal menu contestuale.

    Menu del file

oppure

  • Clicca sul nome del file.

  • Apparirà la finestra di anteprima del file. Per condividere il file con altri utenti, clicca sul pulsante Condividi. Per procedere con la modifica, clicca sul pulsante Modifica in ONLYOFFICE.

    Anteprima del file

Il file verrà aperto nell'editor ONLYOFFICE corrispondente.

Gli utenti con accesso in sola lettura possono utilizzare il Live Viewer per seguire in tempo reale le modifiche apportate da altri editor, inclusi i loro cursori, senza passare alla modalità di modifica. Il Live Viewer è disponibile solo per le installazioni su server ed è abilitato per impostazione predefinita: non è richiesta alcuna configurazione aggiuntiva. Per saperne di più sul Live Viewer, consulta la documentazione API.

Modifica dei diritti di accesso​

Il mittente ha diritti di modifica e il destinatario ha diritti di lettura per impostazione predefinita. Per cambiarli, usa l'opzione Cambia diritti di accesso disponibile nel menu contestuale del file. Questa opzione è disponibile solo per il mittente.

Per co-modificare un documento, gli utenti autorizzati devono aprire lo stesso file insieme.

In una chat privata:

  • Usa il menu a tendina nel campo Diritti di accesso per @utente.

    Chat privata

In una chat di gruppo per tutti i membri:

  • Usa il menu a tendina nel campo Diritti di accesso predefiniti per i membri della chat.

    Chat di gruppo, tutti i membri

In una chat di gruppo per un determinato utente:

  • Usa il menu a tendina in alto, scegli l'utente desiderato e clicca sul pulsante Aggiungi a destra.

    Chat di gruppo, utente specifico

  • L'utente apparirà nell'elenco sottostante. Modifica i suoi diritti di accesso tramite un menu a tendina a destra.

    Chat di gruppo, utente specifico

note

La modifica dei diritti di accesso comporterà l'invio di una notifica automatica da parte del bot alla parte corrispondente.

Visualizzazione della cronologia delle modifiche​

Tutte le modifiche al file verranno inviate come notifiche contenenti il nome utente.

Cronologia delle versioni

Le notifiche sono disponibili in un thread dedicato. Per aprire il thread, clicca sulla freccia a destra del file.

Cronologia delle versioni

note

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