Integrazione Alfresco con ONLYOFFICE

Introduzione

Alfresco Share è una piattaforma ECM che facilita la collaborazione e la gestione dei contenuti. Integrando ONLYOFFICE Document Server, gli utenti possono modificare documenti Office in tempo reale direttamente dalla libreria documentale di Alfresco Share.

Questa guida traduce e organizza i passaggi chiave per installare il plugin onlyoffice-alfresco, incluse note operative, alternative e controlli post-installazione.

Intento primario e varianti correlate

Intento primario: integrare Alfresco con ONLYOFFICE per co-editing. Varianti correlate: installazione plugin onlyoffice-alfresco, configurazione ONLYOFFICE Document Server, deploy AMP Alfresco, uso di Docker per Document Server.

Requisiti

ONLYOFFICE Document Server (consigliato: istanza separata o container Docker)
Java SDK 7 o superiore (la guida originale raccomanda Oracle Java 8)
Gradle
Accesso amministrativo al server Alfresco

Nota importante: se preferisci evitare problemi di dipendenze, considera di usare l’immagine Docker ufficiale di ONLYOFFICE Document Server.

Panoramica dei passaggi

Installare ONLYOFFICE Document Server.
Installare Gradle.
Installare Oracle Java 8 (o JVM compatibile richiesta da Alfresco).
Configurare alternative Java.
Scaricare e compilare plugin/AMP richiesti.
Copiare e costruire il plugin onlyoffice-alfresco.
Applicare gli AMP ad Alfresco.
Aggiungere onlyoffice.url in alfresco-global.properties.
Caricare i pacchetti AMP in directories appropriate.
Eseguire lo script di applicazione AMP e verificare.

Guida passo-passo

Passo 1. Installare ONLYOFFICE Document Server

Segui le istruzioni ufficiali per installare ONLYOFFICE Document Server oppure usa l’immagine Docker per evitare errori di dipendenza.

Passo 2. Installare Gradle

Aggiungi il repository Gradle e installa:

sudo add-apt-repository ppa:cwchien/gradle

Aggiorna i pacchetti:

sudo apt-get update

Installa l’ultima versione di Gradle:

sudo apt-get install gradle

Se Gradle è già presente, rimuovilo prima:

sudo apt-get remove gradle

Passo 3. Installare Oracle Java 8

Per installare Oracle Java 8 (versione stabile consigliata), esegui:

sudo add-apt-repository ppa:webupd8team/java   
sudo apt-get update   
sudo apt-get install oracle-java8-installer

Se non puoi usare Oracle JDK, usa una JVM compatibile con Alfresco e verifica i requisiti di versione nel tuo ambiente.

Passo 4. Configurare le alternative Java

Imposta le alternative di sistema per usare Oracle Java:

sudo update-alternatives --config java   
sudo update-alternatives --config javac   
sudo update-alternatives --config javaws

Passo 5. Compilare le dipendenze necessarie

Clona il plugin Alfresco dal repository Git e costruiscilo:

git clone https://github.com/yeyan/alfresco-amp-plugin.git

cd amp-plugin   
gradle publish

Passo 6. Copiare il plugin onlyoffice-alfresco

cd ..  
git clone https://github.com/cetra3/onlyoffice-alfresco.git

Passo 7. Eseguire gradle amp dalle directory share e repo

Entra nelle directory share e repo del progetto e lancia il task gradle che costruisce gli AMP. Questo creerà pacchetti AMP sotto ./build/amp.

Passo 8. Aggiungere onlyoffice.url in alfresco-global.properties

Apri il file alfresco-global.properties del tuo server Alfresco e aggiungi la URL del Document Server ONLYOFFICE, esempio:

onlyoffice.url=https://onlyoffice.example.com

Sostituisci https://onlyoffice.example.com con la URL effettiva del tuo Document Server (può essere un IP, dominio o localhost in ambiente di test).

Passo 9. Copiare i pacchetti AMP

Copia i pacchetti creati da ./build/amp nelle directory del tuo Alfresco install:

amps/ per il repository
amps_share/ per la parte Share

Passo 10. Applicare gli AMP

Esegui lo script di applicazione degli AMP nella directory bin del tuo Alfresco:

bin/apply_amps.sh

Vedrai i moduli installati. Premi Enter quando richiesto per completare il processo. Dopo il riavvio, l’azione “Edit in Onlyoffice” apparirà nella libreria documentale per i documenti Office.

Esempio: frammento alfresco-global.properties

Di seguito un esempio minimo da adattare:

# URL del Document Server ONLYOFFICE
onlyoffice.url=https://onlyoffice.example.com

# Altre proprietà Alfresco rilevanti
alfresco.host=localhost
alfresco.port=8080

Adatta le proprietà al tuo ambiente di rete e sicurezza (HTTPS, proxy, certificati).

Controlli post-installazione (checklist)

ONLYOFFICE Document Server raggiungibile dall’host Alfresco (test curl o wget).
alfresco-global.properties aggiornato con onlyoffice.url corretto.
AMP caricati in amps/ e amps_share/.
Script apply_amps.sh eseguito e Alfresco riavviato.
Verificata la voce “Edit in Onlyoffice” nella libreria documenti.
Test di co-editing con due utenti diversi effettuato e funzionale.

Ruoli e responsabilità

Amministratore Alfresco: deploy AMP, modifiche a alfresco-global.properties, riavvio dei servizi.
Amministratore del Document Server: installazione e aggiornamento di ONLYOFFICE Document Server, certificati SSL.
Sviluppatore / integratore: build dei plugin AMP, risoluzione di conflitti delle dipendenze.

Alternative e approcci consigliati

Uso di Docker: se vuoi ridurre i problemi di dipendenze usa l’immagine Docker ufficiale di ONLYOFFICE Document Server. Questo semplifica l’installazione e l’isolamento del servizio.
Versioni Java alternative: se non puoi installare Oracle Java 8, verifica la compatibilità con OpenJDK 8+ per la tua versione di Alfresco.
Backup: esegui snapshot o backup prima di applicare gli AMP in ambienti di produzione.

Risoluzione dei problemi comuni

Problema: l’azione “Edit in Onlyoffice” non appare.
- Verifica che gli AMP siano stati applicati correttamente e che Alfresco sia stato riavviato.
- Controlla i log di Alfresco per errori durante il caricamento dei moduli.
- Assicurati che onlyoffice.url punti al Document Server accessibile.
Problema: carica incompleta o timeout durante apertura documento.
- Controlla che il Document Server risponda e che non ci siano problemi di certificato SSL.
- Testa con HTTP temporaneamente per isolare problemi SSL.
Problema: conflitti Gradle o dipendenze mancanti.
- Usa la versione di Gradle raccomandata; rimuovi versioni preesistenti prima dell’install.

Sicurezza e certificati

Per ambienti di produzione, usa HTTPS tra Alfresco e ONLYOFFICE Document Server. Configura certificati validi e, se necessario, inserisci eccezioni per certificati self-signed solo in ambienti di test.

Note sulla conformità e privacy

L’integrazione non modifica la gestione dei dati di Alfresco. Tuttavia, verifica le policy aziendali e le regole GDPR relative al trasferimento di documenti verso servizi esterni se il Document Server è ospitato fuori dal perimetro aziendale.

Glossario (1 riga per voce)

Alfresco Share: interfaccia web di collaborazione e gestione documentale di Alfresco.
ONLYOFFICE Document Server: motore che abilita l’editing e la co-modifica dei documenti Office.
AMP: pacchetti Alfresco Module Package, estensioni installabili in Alfresco.

Criteri di accettazione

L’azione “Edit in Onlyoffice” è visibile nella libreria documenti per file Office.
Due utenti possono editare lo stesso documento in tempo reale senza errori di sincronizzazione evidenti.
Il Document Server risponde alle richieste inviate da Alfresco entro limiti operativi accettabili (dipendenti dalla rete).

Sommario

Questa guida descrive i passaggi per integrare Alfresco Share con ONLYOFFICE Online Editors tramite il plugin onlyoffice-alfresco. Include installazione di Gradle e Java, build dei pacchetti AMP, configurazione di alfresco-global.properties e controlli post-installazione. Per ambienti di produzione si raccomanda l’uso di HTTPS e backup prima del deploy.

Importante: non modificare componenti di produzione senza test preliminari in ambiente di staging.

Link utili

Alfresco official website: https://www.alfresco.com/
ONLYOFFICE official website: http://www.onlyoffice.com/
onlyoffice-alfresco plugin on GitHub: https://github.com/cetra3/onlyoffice-alfresco

Integrazione di Alfresco con ONLYOFFICE Online Editors