Este artículo está traducido por IA

Confluence

Sobre la integración de ONLYOFFICE y Confluence

ONLYOFFICE ofrece un conector oficial para integrar ONLYOFFICE Docs con Confluence y editar documentos de oficina dentro de Confluence. Puedes instalar el conector de ONLYOFFICE desde el Atlassian Marketplace o descargarlo desde la página de GitHub. Nuestros repositorios de GitHub incluyen conectores tanto para Confluence como para Confluence Cloud. La aplicación se distribuye bajo la licencia Apache.

Para saber más sobre cómo funciona y cómo compilar el conector de ONLYOFFICE para Confluence, por favor visita nuestra documentación de la API.
Características principales
  • Creación de documentos de texto, hojas de cálculo y presentaciones usando la opción Nuevo documento.
  • Creación y llenado de formularios en línea.
  • Edición y visualización de documentos con la opción Editar en ONLYOFFICE.
    En Confluence Cloud es posible cargar y editar archivos.
  • Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto), Control de cambios, comentarios y un chat integrado.
  • Soporte JWT para proteger la comunicación de modo que nadie, aparte de los usuarios con los derechos adecuados, pueda acceder a tus documentos.
Formatos soportados
  • Para crear: DOCX, XLSX, PPTX, formularios PDF
  • Para editar y ver: DOCM, DOCX, formularios PDF, DOTM, DOTX, HTM, POTM, POTX, PPSM, PPSX, PPTM, PPTX, XLSM, XLSX, XLTM, XLTX, XML
  • Para editar con posible pérdida de información: CSV, EPUB, FB2, HTML, ODP, ODS, ODT, OTP, OTS, OTT, RTF, TXT
  • Para conversión a Office Open XML: DOC, DOCM, formularios PDF, DOT, DOTM, DOTX, EPUB, FB2, FODP, FODS, FODT, HTM, HTML, MHT, ODP, ODS, ODT, OTP, OTS, OTT, OXPS, PDF, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, XLS, XLSM, XLT, XLTM, XLTX, XML, XPS
    Confluence Cloud no admite la conversión. Todos estos formatos son soportados solo para visualización.
  • Solo para visualización: CSV, DJVU, DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODP, FODS, FODT, HTM, HTML, MHT, ODP, ODS, ODT, OTP, OTS, OTT, OXPS, PDF, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, RTF, TXT, XLS, XLSM, XLSX, XLT, XLTM, XLTX, XML, XPS
Conector para Confluence: novedades en la versión 6.3.0

Añadido

  • Soporte para ejecutar macros de documentos

Cambiado

  • Compatibilidad verificada con la versión 9.5.2 de Confluence
  • Actualizada la lista de formatos soportados, ahora alineada con ONLYOFFICE/document-formats v3.0.0
  • Vulnerabilidad corregida: CVE-2025-27820

El registro completo de cambios está disponible aquí.

Conector para Confluence Cloud: novedades en la versión 1.2.0

Añadido

  • Creación de nuevos documentos
  • Imagen de usuario añadida en el editor
  • Edición de PDF
  • Función de Pegado Especial para añadir un enlace entre archivos

Cambiado

  • La lista de formatos soportados se ha ampliado

El registro completo de cambios está disponible aquí.

Conectando ONLYOFFICE Docs a Confluence

Requisitos
  • Servidor de documentos de ONLYOFFICE v7.0 (servidor o versión en la nube) o posterior

    Necesitas una instancia de ONLYOFFICE Docs que sea resoluble por DNS y accesible tanto desde Confluence como desde cualquier cliente final. Debe poder realizar solicitudes POST a Confluence directamente.

    Por favor, consulta la página de documentación oficial para obtener más información sobre la instalación de ONLYOFFICE Docs.
  • Confluence Data Center 7.12.0 - 9.5.2 o Confluence Server 7.12.0 - 9.5.2

    Atlassian ya no soporta Confluence Server. El soporte del conector de ONLYOFFICE se aplica a instalaciones existentes.

  • Conector de ONLYOFFICE para Confluence
Instalación del conector de ONLYOFFICE para Confluence desde el Atlassian Marketplace

Puedes descargar la última versión del conector desde el Atlassian Marketplace oficial. Para hacerlo, sigue estos pasos:

  1. Inicia sesión en tu instancia de Confluence como administrador.
  2. Haz clic en el botón Configuración en la esquina superior derecha, luego desplázate hacia abajo hasta Atlassian Marketplace. Haz clic en el botón Buscar nuevas aplicaciones.
  3. Localiza Conector de ONLYOFFICE para Confluence a través de la búsqueda. Los resultados incluirán las versiones del complemento compatibles con tu instancia de Confluence.
    ONLYOFFICE_confluence_install ONLYOFFICE_confluence_install
  4. Haz clic en Instalar para descargar e instalar tu aplicación.
  5. Ahora puedes hacer clic en Cerrar en el diálogo Instalado y listo para usar.

O puedes cargar el target/onlyoffice-confluence-plugin.jar compilado en Confluence en la página Administrar complementos.

Los últimos archivos de paquetes compilados están disponibles aquí y en Atlassian Marketplace.

Compilación de la aplicación de integración de ONLYOFFICE para Confluence

Si planeas compilar la aplicación de integración de ONLYOFFICE para Confluence por ti mismo (por ejemplo, editar el código fuente y compilarlo después), sigue estos pasos:

  1. La versión estable de Java es necesaria para la compilación exitosa. Si no la tienes instalada, usa los siguientes comandos para instalar OpenJDK 8: 
    sudo apt-get update sudo apt-get install openjdk-8-jdk
  2. Instala el Atlassian Plugin SDK. El proceso de instalación se describe aquí.
  3. Inicializa los submódulos: 
    git submodule update --init --recursive
  4. Compila el paquete: 
    atlas-package
Configuración del conector de ONLYOFFICE para Confluence

Ve a Administración de Confluence > Administrar aplicaciones > Conector de ONLYOFFICE para Confluence > Configurar:

  • Servidor de documentos - especifica la dirección URL donde está instalado ONLYOFFICE Docs (por ejemplo, https://documentserver).
    ImportanteLa dirección de ONLYOFFICE Docs debe ser accesible desde Confluence, así como la dirección de Confluence debe ser accesible desde ONLYOFFICE Docs.
  • Clave secreta -clave secreta JWT utilizado 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 Confluence: 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 Habilitación de JWT para la integración de ONLYOFFICE y Confluence de este artículo.

Configuraciones avanzadas del servidor:

  • Dirección del servidor para solicitudes internas desde el Servicio de Edición de Documentos - dirección que se utiliza para acceder al servidor de Confluence desde el Servicio de Edición de Documentos.
  • Dirección del Servicio de Edición de Documentos para solicitudes internas desde el servidor - dirección que se utiliza para acceder al Servicio de Edición de Documentos desde el servidor de Confluence.
    Confluence Cloud no admite la configuración de ajustes avanzados.
ONLYOFFICE_confluence_configure ONLYOFFICE_confluence_configure
Cómo funciona

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

  1. El usuario navega a los adjuntos de Confluence y selecciona la acción Editar en ONLYOFFICE.
  2. Confluence realiza una solicitud a OnlyOfficeEditorServlet (URL de la forma: /plugins/servlet/onlyoffice/doceditor?attachmentId=$attachment.id).
  3. Confluence envía un documento al servicio de almacenamiento de documentos de ONLYOFFICE y recibe un enlace temporal.
  4. Confluence prepara un objeto JSON con las siguientes propiedades:
    • url - el enlace temporal que ONLYOFFICE Docs utiliza para descargar el documento;
    • callbackUrl - la URL que ONLYOFFICE Docs utiliza para informar sobre el estado de la edición del documento;
    • docserviceApiUrl - la URL que el cliente necesita para responder a ONLYOFFICE Docs (proporcionada por la propiedad files.docservice.url.api);
    • key - el UUID para instruir a ONLYOFFICE Docs si debe descargar el documento nuevamente o no;
    • title - el título del documento (nombre).
  5. Confluence utiliza este objeto para generar una página desde una plantilla freemarker, rellenándola con los valores proporcionados para permitir que el navegador del cliente cargue el editor.
  6. El navegador del cliente realiza una solicitud a la biblioteca JavaScript de ONLYOFFICE Docs y envía a ONLYOFFICE Docs la configuración de DocEditor con las propiedades mencionadas.
  7. Luego ONLYOFFICE Docs descarga el documento desde Confluence y el usuario comienza a editar.
  8. Cuando todos los usuarios y navegadores de clientes han terminado de editar, cierran la ventana de edición.
  9. Después de 10 segundos de inactividad, ONLYOFFICE Docs envía un POST a callbackUrl informando a Confluence que los clientes han terminado de editar el documento y lo han cerrado.
  10. Confluence descarga una nueva versión del documento, reemplazando la anterior.
Habilitación de JWT para la integración de ONLYOFFICE y Confluence

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

  1. 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 comando docker exec -it <containerID> bash y abre /etc/onlyoffice/documentserver/local.json

      Alternativamente, puedes usar el siguiente comando para encontrar la clave secreta predeterminada 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" } } } } }
  2. El valor true está especificado en tres secciones. Esto 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
  3. 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
  4. 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
Confluence Cloud no admite la conexión al servidor de demostración.

Si deseas probar los editores en línea de ONLYOFFICE dentro de Confluence sin instalar ONLYOFFICE Docs:

  1. Ve a Administración de Confluence > Administrar aplicaciones > Conector de ONLYOFFICE para Confluence > Configurar.
  2. Marca la casilla Conectar al servidor de documentos de demostración de ONLYOFFICE.
  3. 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 Confluence

Para crear un archivo:

  1. Abre la página donde necesitas crear un archivo.
  2. Haz clic en el botón Nuevo documento.
  3. Elige el tipo de archivo necesario.
  4. Ingresa el nombre del archivo en el campo de texto cerca del icono del tipo de archivo.
  5. Haz clic en el Confluence save object icon botón Guardar.

El documento se abrirá en el editor de ONLYOFFICE Docs.

ONLYOFFICE_confluence_newfile ONLYOFFICE_confluence_newfile

Para crear una vista previa de un archivo:

  1. Abre cualquier página de Confluence para editar.
  2. Haz clic en la opción Insertar más contenido.
  3. Elige la opción Otros macros.
  4. Selecciona la opción Vista previa de ONLYOFFICE.
  5. Elige el archivo requerido en la página de Adjuntos.
  6. Ajusta el ancho y alto de la vista previa del archivo si es necesario.
  7. Haz clic en el botón Insertar.
ONLYOFFICE_confluence_previewfile ONLYOFFICE_confluence_previewfile

Para descargar un archivo:

  1. Abre el menú contextual del archivo haciendo clic en la flecha a la izquierda de su nombre.
  2. Haz clic en el botón Descargar como. Se abrirá la ventana Descargar como con ONLYOFFICE.
  3. Edita el Nombre del Archivo en el campo correspondiente si es necesario.
  4. Abre el menú desplegable Tipo de destino y elige el formato requerido.
  5. Haz clic en el botón Descargar.
ONLYOFFICE_confluence_downloadfile ONLYOFFICE_confluence_downloadfile

Para editar o ver un documento:

  1. Encuentra el archivo necesario.
  2. Haz clic en el botón Editar en ONLYOFFICE.

El documento se abrirá en el editor de ONLYOFFICE.

Para coeditar un documento, los usuarios autorizados deben abrir el mismo archivo juntos.

ONLYOFFICE_confluence_editfile ONLYOFFICE_confluence_editfile

Para crear un formulario:

  1. Abre la página donde necesitas crear un archivo.
  2. Haz clic en el botón Nuevo documento y elige la opción Formulario.
    ONLYOFFICE_newform ONLYOFFICE_newform
  3. Ingresa el nombre del archivo en el campo de texto cerca del icono del tipo de archivo.
  4. Selecciona el archivo .docx adjunto a esta u otras páginas o elige la opción Crear desde blanco.
  5. El formulario se abrirá en el editor de ONLYOFFICE Docs.
  6. Guarda el formulario como PDF para tener acceso futuro a la edición, revisión o colaboración.

Para crear un formulario rellenable y restringir la edición de archivos por otros usuarios:

  1. Ve a los Adjuntos.
  2. Haz clic en el enlace Crear formulario usando ONLYOFFICE a la derecha del archivo PDF. El archivo se creará en la sección Adjuntos.
    ONLYOFFICE_createform ONLYOFFICE_createform

Para llenar un formulario:

  1. Ve a los Adjuntos.
  2. Haz clic en el enlace Llenar formulario en ONLYOFFICE a la derecha del archivo PDF.
    ONLYOFFICE_fillform ONLYOFFICE_fillform
  3. El formulario se abrirá en el editor de ONLYOFFICE Docs.
Para saber más sobre formularios, por favor lee los artículos correspondientes sobre creación y relleno de formularios.
Para saber más 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 nowUse in the cloud
Artículos con tag:
Browse all tags