Este artículo está traducido por IA

Alfresco

Acerca de la integración de ONLYOFFICE y Alfresco

ONLYOFFICE ofrece un conector oficial para integrar ONLYOFFICE Docs con Alfresco, permitiendo crear, editar y convertir documentos de oficina dentro de la biblioteca de documentos. Puedes descargar el conector de ONLYOFFICE desde el directorio de complementos de Alfresco o desde la página de GitHub de ONLYOFFICE.

Para obtener más información sobre el módulo de ONLYOFFICE y Alfresco y cómo funciona en detalle, por favor, visita nuestra documentación API.

Características principales

Crear, editar y visualizar documentos de texto, hojas de cálculo y presentaciones.
Convertir archivos.
Coeditar documentos en tiempo real: dos modos de coedición (Rápido y Estricto), el modo Control de Cambios, comentarios y el chat integrado.
Soporte JWT para asegurar tu tráfico de modo que nadie pueda acceder a tus documentos, excepto los usuarios con los derechos adecuados.

Formatos soportados

Para crear, editar y visualizar: DOCX, PPTX, XLSX
Para trabajar con formularios: PDF
Para conversión: ODT, ODP, ODS, DOC, XLS, PPT, RTF
Para editar mediante conversión a OOXML: ODP, ODS, ODT, RTF, CSV, TXT
Solo para visualizar: PDF

Novedades en la versión 8.1.0

Añadido

Soporte de eventos en el editor: onRequestReferenceData, onRequestReferenceSource, onRequestOpen

Cambiado

Se corrigió el error de configuración de Ignorar Certificado SSL

El registro completo de cambios está disponible aquí.

Conectando ONLYOFFICE Docs a Alfresco Share

Requisitos

Servidor de Documentos de ONLYOFFICE v7.1 (servidor o versión en la nube) o posterior
Necesitas una instancia de ONLYOFFICE Docs que sea resoluble y conectable tanto desde Alfresco como desde cualquier cliente final. Debe poder realizar POST a Alfresco directamente.
Por favor, consulta la página de documentación oficial para obtener más información sobre la instalación de ONLYOFFICE Docs.
Alfresco v.7.4, 23, 25
Conector de ONLYOFFICE 7.0.0 para Alfresco

Instalación del paquete del módulo ONLYOFFICE y Alfresco

Los archivos del paquete compilado más recientes están disponibles en GitHub. Necesitas los archivos onlyoffice-integration-repo.amp y onlyoffice-integration-share.amp.

Instalación mediante paquetes compilados

Descarga los archivos del paquete .amp compilados usando el enlace anterior.

Crea los siguientes directorios en tu servidor:

sudo mkdir -p /var/opt/alfresco/amps

sudo mkdir -p /var/opt/alfresco/amps_share

Mueve los archivos del paquete .amp compilados a los directorios recién creados:
- /var/opt/alfresco/amps para onlyoffice-integration-repo.amp
- /var/opt/alfresco/amps_share para onlyoffice-integration-share.amp
Detén los servicios de Alfresco usando cualquiera de los métodos:
1. Método 1:
```
sudo systemctl stop alfresco
```
  Asegúrate de que todos los servicios de Alfresco estén detenidos. Deben detenerse consecutivamente; los últimos deben ser aquellos con content en su nombre, por ejemplo:
```
alfresco-tengine-aio.service.service
alfresco-search.service
alfresco-content-monitored-startup.service
alfresco-content.service
```
2. Método 2:
```
sudo ./alfresco.sh stop
```
  Ten en cuenta que este método funciona solo si el script está incluido en tu versión, lo cual no siempre es el caso.
Encuentra la ruta a los archivos alfresco.war y share.war, por ejemplo:
```
sudo find / -type f -iname '*alfresco.war*' 2>/dev/null
```
Encuentra la ruta al archivo de herramienta alfresco-mmt.jar.
Instala el componente repo del plugin:
```
java -jar /PATH/alfresco-mmt.jar install \
/PATH/onlyoffice-integration-repo.amp \
/PATH/alfresco.war \
-verbose -nobackup -force
```
donde PATH representa las rutas de archivo localizadas previamente. Ten en cuenta que los valores de PATH son diferentes para cada iteración en el comando anterior.
Puede que necesites actualizar Java para desplegar alfresco-mmt.jar:
```
sudo apt update
sudo apt install openjdk-17-jre-headless
```
Instala el componente share del plugin:
```
java -jar /PATH/alfresco-mmt.jar install \
/PATH/onlyoffice-integration-share.amp \
/PATH/share.war \
-verbose -nobackup -force
```
donde PATH representa las rutas de archivo localizadas previamente. Ten en cuenta que los valores de PATH son diferentes para cada iteración en el comando anterior.

Elimina los directorios de Tomcat para que Alfresco los vuelva a compilar al reiniciar:

sudo rm -rf /var/opt/alfresco/tomcat/webapps/alfresco
sudo rm -rf /var/opt/alfresco/tomcat/webapps/share

Reinicia Alfresco usando cualquiera de los métodos:
1. ```
sudo systemctl start alfresco
```
2. ```
sudo ./alfresco.sh start
```
Asegúrate de lanzar los servicios en el mismo orden en que los detuviste.

Instalación en Ubuntu

Para comenzar a usar ONLYOFFICE Docs con Alfresco, se deben realizar los siguientes pasos para Ubuntu 24.04:

Sube los paquetes compilados *.amp a los directorios correspondientes para tu instalación de Alfresco:
- de onlyoffice-alfresco/repo/target/ a /usr/local/tomcat/amps/ para el repositorio de Alfresco,
- de onlyoffice-alfresco/share/target/ a /usr/local/tomcat/amps_share/ para Share.

Puedes descargar los archivos del paquete ya compilados aquí y colocarlos en los directorios respectivos.

Usa la Herramienta de Gestión de Módulos (MMT) para instalar módulos, ejecuta estos comandos:

Alfresco

java -jar /usr/local/tomcat/alfresco-mmt/alfresco-mmt.jar install /usr/local/tomcat/amps/onlyoffice-integration-repo.amp /usr/local/tomcat/webapps/alfresco

Share

java -jar /usr/local/tomcat/alfresco-mmt/alfresco-mmt.jar install /usr/local/tomcat/amps_share/onlyoffice-integration-share.amp /usr/local/tomcat/webapps/share

Más detalles sobre el uso de MMT se pueden encontrar en la guía de instalación de Alfresco.

Asegúrate de que el Servidor de Documentos pueda realizar POST a Alfresco.
Puede que necesites cambiar estas líneas en alfresco-global.properties o puedes configurarlo usando la página de configuración:
```
    alfresco.host=<hostname>
    alfresco.port=443
    alfresco.protocol=https
    
    share.host=<hostname>
    share.port=443
    share.protocol=https
    
```

Reinicia Alfresco:

sudo ./alfresco.sh stop sudo ./alfresco.sh start

El módulo puede verificarse en las herramientas de administración en /share/page/console/admin-console/module-package en Alfresco.

Compilación del paquete del módulo ONLYOFFICE Alfresco

Si planeas compilar el paquete del módulo ONLYOFFICE Alfresco tú mismo (por ejemplo, editar el código fuente y compilarlo después), sigue estos pasos:

La última versión estable de Oracle Java es necesaria para la compilación exitosa. Si no la tienes instalada, usa los siguientes comandos para instalar Oracle Java 8:
```
sudo apt-get update sudo apt-get install openjdk-8-jdk
```
Instala el último Maven. El proceso de instalación se describe en la guía oficial de Maven.
Descarga el código fuente del paquete del módulo ONLYOFFICE Alfresco:
```
git clone https://github.com/ONLYOFFICE/onlyoffice-alfresco.git
```
Obtén un submódulo:
```
git submodule update --init --recursive
```
Compila paquetes en los directorios repo y share:
```
cd onlyoffice-alfresco && mvn clean install
```

Otra forma de construir el paquete del módulo ONLYOFFICE Alfresco es usando el archivo docker-compose.

Usa este comando desde el directorio del proyecto:

docker-compose up

Configuración del paquete del módulo ONLYOFFICE y Alfresco

Ve a la Consola de Administración de Alfresco. Abre http://<alfrescohost>/alfresco/s/onlyoffice/onlyoffice-config y especifica los siguientes parámetros.

Configuraciones:

Dirección del Servicio de Edición de Documentos - especifica la dirección URL donde está instalado el Servicio de Edición de Documentos.
Importante La dirección de ONLYOFFICE Docs debe ser accesible desde Alfresco, así como la dirección de Alfresco debe ser accesible desde ONLYOFFICE Docs.
Clave Secreta - especifica la clave secreta utilizada para firmar los datos.
A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. Necesitas habilitarlo también en el lado de Alfresco: encuentra tu clave secreta en el archivo de configuración de ONLYOFFICE Docs, luego especifica la misma clave secreta en la configuración del conector. Para más detalles, consulta la Sección de Habilitación de JWT para la integración de ONLYOFFICE y Alfresco de este artículo.

Configuraciones avanzadas del servidor:

Dirección del Servicio de Edición de Documentos para solicitudes internas desde el servidor de Alfresco - especifica la dirección que se utiliza para acceder al Servicio de Edición de Documentos desde el servidor de Alfresco.
Dirección del servidor de Alfresco para solicitudes internas desde el Servicio de Edición de Documentos - especifica la dirección que se utiliza para acceder al servidor de Alfresco desde el Servicio de Edición de Documentos.
Encabezado de autorización (dejar en blanco para usar el encabezado predeterminado) - El encabezado JWT de autorización utilizado en ONLYOFFICE es Authorization. En caso de que este encabezado entre en conflicto con tu configuración, puedes cambiar el encabezado a uno personalizado.

Configuraciones comunes:

Ignorar Certificado SSL - desactiva SSL.
Habilitar Guardado Forzado - habilita guardar los cambios del documento directamente en el almacenamiento de Alfresco después de hacer clic en el botón Guardar (si está deshabilitado, el documento se guarda en la caché del editor de documentos hasta que se cierre el documento).
Guardar docx, xlsx, pptx como una nueva versión del archivo original después de la conversión - si está deshabilitado, se creará un archivo separado y se colocará en la misma carpeta.
Abrir el archivo para edición - permite a los administradores elegir los formatos de documento para editar mediante conversión a formatos OOXML.
Después de cerrar el editor, guardar el documento como una versión menor - determina si las versiones de documentos se guardan como versiones mayores (2.0, 3.0) después de cerrar o como versiones menores (1.1, 1.2) durante la edición, con 1.0 como el documento inicial vacío.

También puedes agregar onlyoffice.url a alfresco-global.properties. La configuración realizada a través de la página de configuraciones anulará alfresco-global.properties.

Cómo funciona

La integración de ONLYOFFICE sigue la API documentada aquí.

El usuario navega hasta un documento dentro de Alfresco Share y selecciona la opción de menú Editar en ONLYOFFICE.
Alfresco Share realiza una solicitud al extremo del repositorio (URL de la forma: /parashift/onlyoffice/prepare?nodeRef={nodeRef}).
El extremo del repositorio de Alfresco prepara un objeto JSON para Share con las siguientes propiedades:
- url - la URL que ONLYOFFICE Docs utiliza para descargar el documento (incluye el alf_ticket del usuario actual);
- callbackUrl - la URL que ONLYOFFICE Docs informa sobre el estado de la edición del documento;
- onlyofficeUrl - la URL que el cliente necesita para responder a ONLYOFFICE Docs (proporcionada por la propiedad onlyoffice.url);
- key - el UUID+Modified Timestamp para instruir a ONLYOFFICE Docs si debe descargar el documento nuevamente o no;
- title - el título del documento (nombre).
Alfresco Share toma este objeto y construye una página a partir de una plantilla freemarker, llenando todos esos valores para que el navegador del cliente pueda cargar el editor.
El navegador del cliente realiza una solicitud a la biblioteca de JavaScript de ONLYOFFICE Docs y envía a ONLYOFFICE Docs la configuración de DocEditor con las propiedades anteriores.
Luego, ONLYOFFICE Docs descarga el documento de Alfresco y el usuario comienza a editar.
ONLYOFFICE Docs envía una solicitud POST a callbackUrl para informar a Alfresco que un usuario está editando el documento.
Alfresco bloquea el documento, pero aún permite a otros usuarios con acceso de escritura colaborar en tiempo real con ONLYOFFICE Docs dejando la Acción presente.
Cuando todos los usuarios y navegadores de clientes han terminado de editar, cierran la ventana de edición.
Después de 10 segundos de inactividad, ONLYOFFICE Docs envía un POST a callbackUrl informando a Alfresco que los clientes han terminado de editar el documento y lo han cerrado.
Alfresco descarga una nueva versión del documento, reemplazando la anterior.

Habilitación de JWT para la integración de ONLYOFFICE y Alfresco

Para proteger los documentos del acceso no autorizado, los editores de ONLYOFFICE utilizan el JSON Web Token (JWT). El token se añade en la configuración cuando se inicializa el Editor de Documentos y durante el intercambio de comandos entre los servicios internos de ONLYOFFICE Docs. La clave secreta se utiliza para firmar el token web JSON y validar el token al realizar la solicitud a ONLYOFFICE Docs.

A partir de ONLYOFFICE Docs v7.2, JWT está habilitado por defecto y la clave secreta se genera automáticamente. Necesitas encontrar tu clave secreta en el archivo de configuración de ONLYOFFICE Docs, luego especifica la misma clave secreta en la configuración del conector.

Paso 1: Encuentra tu clave secreta en el archivo de configuración de ONLYOFFICE Docs

Abre el archivo local.json con cualquier editor de texto disponible.
- Para Linux - /etc/onlyoffice/documentserver/local.json
- Para Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
- Para Docker - ingresa al contenedor de ONLYOFFICE Docs usando el docker exec -it <containerID> bash comando y abre /etc/onlyoffice/documentserver/local.json
  Alternativamente, puedes usar el siguiente comando para encontrar la clave secreta por defecto sin abrir local.json:
```
sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'
```
El archivo local.json debería verse así:
```
{"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}
```
El valor true está especificado en tres secciones. Significa que la validación del token está habilitada.
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
La clave secreta generada automáticamente está especificada en tres secciones. Puedes reemplazar el valor secreto predeterminado con tu propia clave secreta. La clave secreta debe ser la misma en las tres secciones.
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
Si realizas cambios, guárdalos y reinicia los servicios para que los cambios de configuración surtan efecto.
```
supervisorctl restart all
```

Paso 2: Especifica la misma clave secreta en la configuración del conector

En la configuración del conector, especifica la misma clave secreta en el campo Clave secreta y guarda la configuración.

Conectando al demo de ONLYOFFICE Docs

A partir de la versión 5.0.0 del conector de ONLYOFFICE, puedes probar los editores en línea de ONLYOFFICE dentro de Alfresco sin instalar ONLYOFFICE Docs.

Para activar la conexión, marca la casilla Conectar al Servidor de Documentos de ONLYOFFICE demo y haz clic en el botón Guardar.

ImportanteEste es un servidor de prueba público que estará disponible durante un período de 30 días. No compartas tus datos sensibles allí.

Comienza a usar ONLYOFFICE Docs dentro de Alfresco

Para crear un documento:

Abre la carpeta donde deseas crear un documento.
Haz clic en el botón Crear....
Elige el tipo de archivo que deseas crear: Documento, Hoja de cálculo o Presentación.

Para editar o ver un documento:

Encuentra el documento requerido.
Haz clic en el botón Editar en ONLYOFFICE.

Para convertir un documento no XML a formato XML (DOCX, XLSX o PPTX):

Encuentra el documento requerido.
Haz clic en el botón Convertir usando ONLYOFFICE.

El documento se convertirá automáticamente en su análogo XML. Los archivos resultantes se colocan en la misma carpeta. También puedes configurar reglas de conversión automática para una carpeta. Para obtener más información sobre la configuración de reglas, por favor lee la documentación oficial de Alfresco.

Para descargar el archivo en un formato preferido:

Encuentra el archivo requerido.
Haz clic en el botón Descargar como... y elige el formato que necesitas.

Para ver el historial de cambios del archivo:

Haz clic en el nombre del archivo o su icono para abrir la pestaña de detalles del archivo.
Encuentra la pestaña Historial de Versiones en el panel derecho.
Las secciones disponibles son: Última Versión y Versiones Anteriores. Los cambios realizados en el archivo se resaltarán.
Para cargar una nueva versión, haz clic en el icono correspondiente en la esquina superior derecha.
Para ver rápidamente la versión actual del archivo, coloca el puntero del mouse sobre el archivo. El número de versión se mostrará a la derecha del nombre del archivo, por ejemplo, .

properties

Ve a la pestaña Archivo en el editor.
Elige la opción Historial de Versiones en el menú.

Para crear un nuevo archivo directamente en el Editor de Documentos:

Abre la pestaña Archivo.
Haz clic en la opción Crear Nuevo.

Se abrirá un nuevo archivo .docx en una nueva pestaña.

Para crear plantillas personalizadas:

Inicia sesión en tu portal de Alfresco como administrador que lo creó.
Ve a Mis archivos -> Diccionario de Datos -> Plantillas de Nodo.
Agrega plantillas personalizadas en los formatos disponibles: .docx, .xlsx, .pptx.

Para crear documentos desde plantillas:

Abre la carpeta donde deseas crear un documento.
Haz clic en el botón Crear....
Selecciona la opción Crear documento desde plantilla y elige una de las plantillas disponibles.
o

En el editor, ve a la pestaña Archivo.
Haz clic en la opción Crear Nuevo....
Elige la plantilla requerida.

Para aprender cómo comparar archivos desde el almacenamiento, sigue las instrucciones de este artículo.

Para aprender cómo usar la combinación de correspondencia desde el almacenamiento, sigue las instrucciones de este artículo.

Para aprender cómo insertar imágenes desde el almacenamiento, sigue las instrucciones de este artículo.

Para aprender cómo marcar el documento como favorito directamente en el Editor de Documentos, sigue las instrucciones de este artículo.

Para obtener más información sobre los problemas más comunes y las formas de resolverlos, por favor visita nuestra guía de solución de problemas.

Host ONLYOFFICE Docs on your own server or use it in the cloud

Get it now Use in the cloud