Redmine

Caratteristiche principali

• Visualizzazione e modifica di documenti di testo, fogli di calcolo e presentazioni dai moduli di Redmine a seconda dei diritti di accesso dell'utente.
• Creazione e compilazione di moduli online.
• Co-editing dei documenti in tempo reale: due modalità di co-editing (Veloce e Rigida), modalità Traccia Modifiche, commenti e una chat integrata.
• Supporto JWT per proteggere il tuo traffico in modo che nessuno, oltre agli utenti con i diritti appropriati, possa accedere ai tuoi documenti.
• Creazione di nuovi allegati utilizzando modelli che considerano la preferenza linguistica dell'utente.

Formati supportati

• Per la creazione: DOCX, DOCXF, XLSX, PPTX
• Per la modifica: DOCM, DOCX, DOCXF, DOTM, DOTX, *EPUB, *FB2, *HTML, *ODT, *OTT, PDF, *RTF, *TXT, *CSV, *ODS, *OTS, XLSM, XLSX, XLTM, XLTX, *ODP, *OTP, POTM, POTX, PPSM, PPSX, PPTM, PPTX
• Per la visualizzazione: DJVU, DOC, DOCM, DOCX, DOCXF, DOT, DOTM, DOTX, *EPUB, *FB2, FODT, HTM, *HTML, MHT, MHTML, *ODT, OFORM, *OTT, OXPS, PDF, *RTF, STW, SXW, *TXT, WPS, WPT, XML, XPS, *CSV, ET, ETT, FODS, *ODS, *OTS, SXC, XLS, XLSB, XLSM, XLSX, XLT, XLTM, XLTX, DPS, DPT, FODP, *ODP, *OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, SXI

Novità della versione 3.1.0

Funzionalità

• Compilazione di PDF invece di oform.

Correzioni

• Correzione del controllo manuale delle dipendenze di versione.

Il registro completo delle modifiche è disponibile qui.

Requisiti

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

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

  Si prega di fare riferimento alla pagina di documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.
• Redmine: v4.0.0 - v5.0.x. Se sei nuovo a Redmine, installalo seguendo queste istruzioni.
• Ruby: Usa una versione di Ruby supportata dalla tua installazione di Redmine (raccomandato: Ruby 2.7+ / 3.x).
• Connettore ONLYOFFICE v3.1.0 per Redmine

Installazione del connettore ONLYOFFICE per Redmine

Per installare il plugin, avrai bisogno di Redmine v. 4.2 o superiore, o Redmine v. 5.0 o superiore. Il plugin è compatibile con Ruby v. 2.7.2 o superiore, o Ruby v. 3.0.0 o superiore.

Inoltre, potresti aver bisogno di zstd per decomprimere il plugin.

1. Installa Redmine seguendo le istruzioni ufficiali di Redmine.
2. Una volta installato Redmine, scarica il plugin.

   curl --location https://github.com/ONLYOFFICE/onlyoffice-redmine/releases/latest/download/onlyoffice_redmine.tar.zst --output onlyoffice_redmine.tar.zst

3. Decomprimi il plugin scaricato nella directory plugins.

   tar --extract --file onlyoffice_redmine.tar.zst --directory plugins

4. Installa le dipendenze del plugin se Redmine non lo ha fatto automaticamente.

   bundle install

5. Esegui la migrazione.

   RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine

6. Riavvia Redmine.

Leggi di più sull'installazione del plugin sulla pagina Wiki di Redmine.

Configurazione del connettore ONLYOFFICE per Redmine

Vai al pannello di Amministrazione > Plugin, trova il plugin di integrazione ONLYOFFICE per Redmine e clicca su Configura. Specifica i seguenti parametri:

• Indirizzo del Servizio di Modifica Documenti - inserisci l'indirizzo URL e la porta dove è installato ONLYOFFICE Docs (es. https://documentserver:8080). Questo campo è obbligatorio.
  L'indirizzo di ONLYOFFICE Docs deve essere accessibile da Redmine, così come l'indirizzo di Redmine deve essere accessibile da ONLYOFFICE Docs.
• La sezione Impostazioni avanzate del server può essere utilizzata se la tua configurazione di rete non consente richieste tra Redmine installato e ONLYOFFICE Docs utilizzando gli indirizzi pubblici. In questo caso, specifica gli indirizzi per le richieste interne nei campi corrispondenti:
  • Indirizzo di ONLYOFFICE Docs per richieste interne dal server - specifica l'indirizzo utilizzato per accedere al Servizio di Modifica Documenti da Redmine.
  • Indirizzo del server per richieste interne da ONLYOFFICE Docs - specifica l'indirizzo utilizzato per accedere a Redmine dal Servizio di Modifica Documenti.
• 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. Per ulteriori dettagli, consulta la sezione Abilitazione di JWT per l'integrazione di ONLYOFFICE e Redmine di questo articolo.
• Disabilita la verifica del certificato (non sicuro) - seleziona questa casella per disabilitare la verifica del certificato e consentire a Redmine di stabilire una connessione con ONLYOFFICE Docs se stai utilizzando un certificato autofirmato per il tuo ONLYOFFICE Docs (altrimenti, Redmine non convaliderà un certificato autofirmato e non consentirà la connessione a/da ONLYOFFICE Docs). Questa è una soluzione non sicura e raccomandiamo vivamente di sostituire il certificato con uno emesso da una CA.
• Controlla le seguenti impostazioni di personalizzazione se necessario:
  • Mostra il pulsante di menu Chat.
  • Mostra l'intestazione in modo più compatto.
  • Mostra il pulsante di menu Feedback Support.
  • Mostra il pulsante di menu Aiuto.
  • Mostra l'intestazione della barra degli strumenti in monocromia.

Clicca sul pulsante Applica in fondo per salvare le modifiche.

Abilitazione di JWT per l'integrazione di ONLYOFFICE e Redmine

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 JSON web 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 usare 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ì:

   {"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. 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 Chiave segreta e salva le impostazioni.

Connessione ai demo di ONLYOFFICE Docs

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

Per attivare la connessione, seleziona la casella Connetti al server di documenti demo di ONLYOFFICE e clicca sul pulsante Applica.

Modifica delle autorizzazioni

Si prega di notare che le azioni disponibili sui file (visualizzazione o modifica) per ciascun modulo dipendono dalle autorizzazioni del ruolo utente.

Vai a Amministrazione > Ruoli e autorizzazioni, scegli il ruolo necessario nell'elenco, seleziona/deseleziona le autorizzazioni necessarie e clicca su Salva.

Puoi fare riferimento alla documentazione ufficiale di Redmine per ulteriori dettagli.

Modulo Problemi

Per aprire i file allegati ai problemi o ai commenti sui problemi nell'editor corrispondente, clicca sul pulsante Modifica in ONLYOFFICE / Apri in ONLYOFFICE a destra del nome del file.

La possibilità di modificare i documenti è disponibile per i ruoli utente con l'autorizzazione Modifica problemi.

La possibilità di aprire i file per la visualizzazione è disponibile per i ruoli utente con l'autorizzazione Visualizza problemi.

Modulo Notizie

Per aprire i file nell'editor corrispondente, clicca sul pulsante Modifica in ONLYOFFICE / Apri in ONLYOFFICE a destra del nome del file.

La possibilità di modificare i documenti è disponibile per i ruoli utente con l'autorizzazione Modifica notizie.

La possibilità di aprire i file per la visualizzazione è disponibile per i ruoli utente con l'autorizzazione Visualizza notizie.

Modulo Documenti

Per aprire i file nell'editor corrispondente, clicca sul pulsante Modifica in ONLYOFFICE / Apri in ONLYOFFICE a destra del nome del file.

La possibilità di modificare i documenti è disponibile per i ruoli utente con l'autorizzazione Modifica documenti.

La possibilità di aprire i file per la visualizzazione è disponibile per i ruoli utente con l'autorizzazione Visualizza documenti.

Per creare un modulo, clicca sul link Crea in ONLYOFFICE e scegli l'opzione Modello di Modulo.

Compila i campi richiesti e clicca su Crea.

Modulo Wiki

Per aprire i file nell'editor corrispondente, clicca sul pulsante Modifica in ONLYOFFICE / Apri in ONLYOFFICE a destra del nome del file.

La possibilità di modificare i documenti è disponibile per i ruoli utente con l'autorizzazione Modifica pagine Wiki.

La possibilità di aprire i file per la visualizzazione è disponibile per i ruoli utente con l'autorizzazione Visualizza Wiki.

Modulo Forum

Crea un forum con argomenti dedicati nel modulo Forum.

• Clicca sul pulsante Nuovo messaggio nell'angolo in alto a destra.
• Inserisci l'oggetto, formatta il corpo, allega file se necessario. Quando sei pronto, clicca sul pulsante Crea.

Per iscriverti a un forum e ricevere notifiche, clicca sul pulsante Osserva nell'angolo in alto a destra.

Modulo File

I file sono disponibili solo per la visualizzazione e esclusivamente agli utenti con autorizzazioni Visualizza file o Gestisci file. Per aprire un file nell'editor corrispondente, clicca sul pulsante Apri in ONLYOFFICE a destra del nome del file.

Conversione dei file

La possibilità di convertire i file è disponibile nei seguenti moduli di Redmine: Problemi, Documenti, Wiki e Notizie.

Clicca sul pulsante Converti con ONLYOFFICE a destra del nome del file.

Scegli il formato necessario dall'elenco. Facoltativamente, puoi cambiare il nome del file.

Clicca sul pulsante Converti per salvare il file convertito nella sezione corrispondente di Redmine. Clicca sul pulsante Scarica per salvare il file convertito localmente sul tuo computer.