Saltar al contenido principal

SuiteCRM

Acerca de la integración de ONLYOFFICE y SuiteCRM​

SuiteCRM es un sistema de gestión de relaciones con los clientes. ONLYOFFICE ofrece un módulo oficial para integrar ONLYOFFICE Docs con SuiteCRM y editar documentos de ofimática en tu espacio de SuiteCRM. Puedes obtener el módulo de integración de ONLYOFFICE en la página de GitHub. El módulo se distribuye bajo la licencia AGPL-3.

nota

Para obtener más información sobre cómo funciona el conector de ONLYOFFICE para SuiteCRM, visita nuestra página de documentación de la API.

Características principales​

  • Edición y visualización de documentos de texto, hojas de cálculo y presentaciones.

  • Coedición de documentos en tiempo real: dos modos de coedición (Rápido y Estricto), el modo Control de cambios, comentarios y el chat integrado.

  • Creación y edición de plantillas de formularios.

    nota

    Para obtener más información sobre los formularios, lee los artículos correspondientes sobre cómo crear y cómo rellenar formularios.

  • Compatibilidad con JWT para proteger tu tráfico de modo que nadie pueda acceder a tus documentos, salvo los usuarios con los derechos adecuados.

Formatos compatibles​

  • Para ver y editar: DOCX, XLSX, PPTX.
  • Solo para ver: PDF, ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM, TXT, CSV.

Conectar ONLYOFFICE Docs con SuiteCRM​

Requisitos​

  • ONLYOFFICE Document Server v7.1 (versión de servidor) o posterior

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

    nota

    Consulta la página de documentación oficial para obtener más información sobre la instalación de ONLYOFFICE Docs.

  • SuiteCRM 7 (todas las versiones 7.x)

  • Conector de ONLYOFFICE v1.0.0 o posterior para SuiteCRM

Instalar el módulo de integración de ONLYOFFICE para SuiteCRM​

Para instalar la aplicación de ONLYOFFICE:

  1. Obtén los últimos archivos del paquete compilado del plugin de integración de ONLYOFFICE desde la página de GitHub.

  2. Inicia SuiteCRM y ve a Admin > Admin Tools > Module Loader.

    Administración de ONLYOFFICE SuiteCRM

  3. Sube el archivo del plugin de ONLYOFFICE.

  4. Instala el módulo subido pulsando el botón Install (Instalar).

  5. Ve a Admin > Admin Tools > Repair.

  6. Ejecuta Quick Repair and Rebuild.

    Reparación y reconstrucción de ONLYOFFICE SuiteCRM

Cómo funciona​

La interacción entre el usuario y el documento se realiza tanto en el lado del cliente como en el lado del servidor.

A continuación se explican los términos clave utilizados a lo largo de esta documentación.

El lado del cliente incluye:

  • Document manager (gestor de documentos): la lista de documentos que se muestra en el navegador del usuario, donde este puede seleccionar el documento necesario y realizar algunas acciones con él (según los derechos otorgados, el usuario puede abrir el documento para verlo o editarlo, o compartirlo con otros usuarios).
  • Document editor (editor de documentos): la interfaz de visualización y edición de documentos con todas las funciones de edición más conocidas, que se utiliza como medio entre el usuario y el document editing service.

El lado del servidor incluye:

  • Document storage service (servicio de almacenamiento de documentos): el servicio del servidor que almacena todos los documentos disponibles para los usuarios con los derechos de acceso adecuados. Proporciona los ID de los documentos y los enlaces a ellos al document manager que el usuario ve en el navegador.
  • Document editing service (servicio de edición de documentos): el servicio del servidor que permite ver y editar documentos (si el usuario tiene los derechos adecuados para ello). La interfaz del document editor se utiliza para acceder a todas las funciones del document editing service.
  • Document command service (servicio de comandos de documentos): el servicio del servidor que permite ejecutar comandos adicionales con el document editing service.
  • Document conversion service (servicio de conversión de documentos): el servicio del servidor que permite convertir el archivo del documento al formato Office Open XML correspondiente (docx para documentos de texto, xlsx para hojas de cálculo y pptx para presentaciones) para su edición o descarga.
  • Document builder service (servicio de creación de documentos): el servicio del servidor que permite crear un documento fácilmente sin necesidad de ejecutar un editor de procesamiento de documentos.

Ten en cuenta que ONLYOFFICE Document Server incluye el document editor, el document editing service, el document command service, el document conversion service y el document builder service. El document manager y el document storage service vienen incluidos en Community Server o deben ser implementados por los integradores de software que utilizan ONLYOFFICE Document Server en su propio servidor.

Configurar JWT para la integración de ONLYOFFICE y SuiteCRM​

JWT o JSON Web Token es una cadena enviada del cliente al servidor dentro de la solicitud HTTP para validar la autenticidad del cliente. JWT se guarda únicamente en el lado del cliente, por lo que la transmisión entre las partes está protegida y firmada digitalmente.

El token se genera mediante el estándar JWT (JSON Web Tokens). Los tokens se firman con la clave del servidor, de modo que el cliente puede verificar que el token es legítimo.

ONLYOFFICE Docs valida el token. Los datos de la carga útil se consideran válidos y se utilizan en lugar de los datos correspondientes de los parámetros principales. Si el token no es válido, el comando no se ejecuta. Para obtener más información, lee la guía de seguridad de la API.

En ONLYOFFICE Docs, JWT está habilitado por defecto a partir de la versión 7.2.

Sigue estos pasos para configurarlo manualmente si es necesario:

  1. Ve a Admin > ONLYOFFICE > ONLYOFFICE Settings.

    Ajustes de ONLYOFFICE en SuiteCRM

  2. Introduce los valores en los siguientes campos:

    • Document Editing Service Address (Dirección de Document Editing Service): especifica la dirección URL donde está instalado ONLYOFFICE Docs (por ejemplo, https://documentserver).
    • Secret key (Clave secreta, déjalo en blanco para deshabilitarlo): la clave secreta se genera automáticamente para restringir el acceso a ONLYOFFICE Docs. Si quieres especificar tu propia clave secreta en este campo, especifica también la misma clave secreta en el archivo de configuración de ONLYOFFICE Docs para habilitar la validación.
    • Authorization header (Encabezado de autorización, déjalo en blanco para usar el encabezado predeterminado): el encabezado JWT estándar que se usa en ONLYOFFICE es Authorization. Si este encabezado entra en conflicto con tu configuración, puedes cambiarlo por uno personalizado.

    Ajustes de JWT de ONLYOFFICE en SuiteCRM

Empezar a usar ONLYOFFICE Docs en SuiteCRM​

Para editar archivos de ofimática y colaborar en ellos:

  • Ve al módulo Documents (Documentos).
  • Abre la página Detail View (Vista de detalle) haciendo clic en el nombre del archivo.
  • En la página Detail View, haz clic en Open in ONLYOFFICE (Abrir en ONLYOFFICE) en el menú desplegable ACTIONS: el archivo se abrirá en la misma pestaña.

Editar en ONLYOFFICE en SuiteCRM

nota

Para obtener más información sobre los problemas más comunes y cómo resolverlos, visita nuestra guía de solución de problemas.