Integrar Alfresco con ONLYOFFICE Editors

Intención principal

Integrar Alfresco Share con ONLYOFFICE Online Editors para editar documentos de oficina (Word, Excel, PowerPoint) en tiempo real dentro del repositorio de Alfresco.

Variantes de la intención

Conectar Alfresco con ONLYOFFICE
Instalar plugin onlyoffice-alfresco
Configurar ONLYOFFICE Document Server para Alfresco
Coedición en Alfresco Share

Requisitos (resumen)

ONLYOFFICE Document Server accesible (recomendado sobre HTTPS)
Java 7 SDK o superior (se recomienda Java 8 para compatibilidad)
Gradle
Acceso al servidor Alfresco y permisos para aplicar AMP

Paso 0. Preparación (recomendado)

Haga una copia de seguridad de Alfresco (contenidos y configuración).
Asegúrese de que Alfresco y ONLYOFFICE sean accesibles entre sí (firewall, puertos).
Si usa HTTPS, prepare certificados válidos y configure confianza mutua.

Paso 1. Instalar ONLYOFFICE Document Server

Siga la documentación oficial de ONLYOFFICE para instalar el Document Server o use la imagen Docker oficial para evitar problemas de dependencias. Se recomienda ejecutar Document Server en un host separado o en un contenedor que tenga acceso a Alfresco.

Paso 2. Instalar Gradle

Añada el repositorio de Gradle y actualice paquetes:

sudo add-apt-repository ppa:cwchien/gradle
sudo apt-get update
sudo apt-get install gradle

Si ya tiene Gradle instalado y desea reinstalar la versión del PPA, elimínelo primero:

sudo apt-get remove gradle

Paso 3. Instalar Oracle Java 8 (opcional, si necesita Java 8)

Para instalar Oracle Java 8:

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

Nota: si prefiere OpenJDK, verifique compatibilidad con su versión de Alfresco.

Paso 4. Cambiar alternativas de Java

Configure las alternativas para usar la versión de Java deseada:

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

Paso 5. Compilar dependencias necesarias

Descargue el plugin Alfresco AMP desde Git y publíquelo con Gradle:

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

Esto genera paquetes AMP necesarios en el árbol de build.

Paso 6. Copiar el plugin onlyoffice-alfresco

Clonar el repositorio oficial del plugin:

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

Revise el README del repositorio para detalles de versión y requisitos.

Paso 7. Ejecutar gradle amp en directorios share y repo

Dentro del proyecto del plugin, construya los AMPs para las partes share y repository:

cd onlyoffice-alfresco
# Ejemplo: ejecutar gradle desde los submódulos, según README
gradle amp

Tras la compilación encontrará paquetes en ./build/amp.

Paso 8. Añadir onlyoffice.url a alfresco-global.properties

Edite el fichero alfresco-global.properties y añada la URL de ONLYOFFICE Document Server, por ejemplo:

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

Si usa HTTPS, asegúrese de que Alfresco confíe en el certificado del servidor ONLYOFFICE (importar en el keystore si es necesario).

Paso 9. Cargar paquetes AMP en Alfresco

Copie los AMPs creados desde ./build/amp a los directorios de su instalación Alfresco:

amps/ (para repositorio)
amps_share/ (para Share)

Asegúrese de permisos y propietarios correctos (usuario de Alfresco/Tomcat).

Paso 10. Aplicar AMPs

Ejecute el script de aplicación de AMPs en la instalación de Alfresco:

bin/apply_amps.sh

Verá que se instalan dos módulos; presione Enter cuando se solicite para completar. Reinicie el servicio de Alfresco/Tomcat tras aplicar los AMPs.

Verifique la instalación

En Alfresco Share debería aparecer la acción “Edit in ONLYOFFICE” o similar en la biblioteca de documentos.
Pruebe abrir y coeditar un documento de Office.

Fragmento de configuración de ejemplo

En alfresco-global.properties:

alfresco.host=alfresco.example.com
alfresco.port=8080
onlyoffice.url=https://onlyoffice.example.com

Criterios de aceptación

La acción “Editar en ONLYOFFICE” aparece en Alfresco Share para documentos compatibles.
Al abrir un documento, se carga ONLYOFFICE en el navegador y permite editar.
Cambios guardados desde ONLYOFFICE se reflejan en Alfresco y generan nueva versión (según políticas).

Lista de verificación por rol

Administrador Alfresco: copia de seguridad previa, permisos de archivo, reinicio de servicios.
Administrador de sistema/DevOps: apertura de puertos, certificados TLS, monitorización.
Usuario final: comprobar que los tipos MIME y extensiones (docx, xlsx, pptx) abran con “Editar en ONLYOFFICE”.

Solución de problemas comunes

Error al cargar ONLYOFFICE en iframe: comprobar políticas CSP y que la URL de ONLYOFFICE esté permitida.
Documento no guarda cambios: revisar logs de ONLYOFFICE y Alfresco, comprobar que ONLYOFFICE puede realizar callbacks a Alfresco (network).
Problemas de certificados HTTPS: importe el certificado en el keystore de Java usado por Alfresco.

Comandos útiles para depuración:

# Ver logs de Tomcat/Alfresco
tail -f /opt/alfresco/tomcat/logs/catalina.out
# Ver logs de ONLYOFFICE (según instalación)
journalctl -u onlyoffice-documentserver -f

(Adapte rutas de logs según su distribución e instalación.)

Buenas prácticas de seguridad

Use HTTPS entre Alfresco y ONLYOFFICE.
Aplique políticas de acceso y minimice cuentas con privilegios elevados.
Mantenga los servidores actualizados y monitorice certificados que caduquen.

Alternativas y cuándo considerar otra opción

Si su organización ya usa otra suite de coedición (por ejemplo, Collabora Online), compare compatibilidad y soporte corporativo.
Para instalaciones muy pequeñas, la imagen Docker de ONLYOFFICE simplifica despliegues; para producción, considere un host dedicado o la oferta de nube de ONLYOFFICE.

Mini-metodología de despliegue (3 fases)

Prueba: desplegar Document Server y plugin en un entorno de staging.
Validación: ejecutar casos reales de edición, versiones y permisos.
Producción: plan de despliegue con ventanas de mantenimiento y rollback.

Consideraciones de compatibilidad y migración

Verifique la versión de Alfresco y compatibilidad del plugin onlyoffice-alfresco en su repositorio GitHub.
Backup y plan de rollback antes de aplicar AMPs.

Resumen

Integrar Alfresco con ONLYOFFICE permite coeditar documentos desde Alfresco Share con pocos pasos: instalar Document Server, compilar e instalar el plugin onlyoffice-alfresco, añadir la URL en alfresco-global.properties y aplicar los AMPs. Pruebe en un entorno de staging, asegure la comunicación HTTPS y prepare un plan de rollback.

Importante: revise la documentación de los repositorios oficiales para cambios de versión y requisitos específicos.

Enlaces

Alfresco oficial: https://www.alfresco.com/
ONLYOFFICE oficial: http://www.onlyoffice.com/
onlyoffice-alfresco plugin en GitHub: https://github.com/cetra3/onlyoffice-alfresco

Integrar Alfresco con ONLYOFFICE Online Editors