Este artículo está traducido por IA

Odoo

Acerca de la integración de ONLYOFFICE y Odoo

Odoo es una herramienta de gestión empresarial diseñada para la planificación de recursos. ONLYOFFICE ofrece tres módulos oficiales para integrarlo con Odoo:

  1. ONLYOFFICE es el módulo principal que se requiere para que otros módulos funcionen y permite adjuntar documentos.
  2. ONLYOFFICE Documents es un módulo utilizado para crear, editar y adjuntar documentos.
  3. ONLYOFFICE Templates es un módulo utilizado para crear y editar formularios rellenables.

Los módulos de integración se distribuyen bajo la licencia LGPL-3.

Para saber más sobre cómo funciona y cómo compilar el conector de ONLYOFFICE para Odoo, por favor visita nuestra documentación de la API.
Características principales
  • Edición y visualización de documentos de texto, hojas de cálculo, presentaciones, PDF y diagramas.
  • 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.
  • Soporte JWT para asegurar el tráfico de modo que nadie pueda acceder a tus documentos excepto los usuarios con los derechos adecuados.
Formatos soportados
  • Para edición: DOCM, DOCX, DOTM, DOTX, XLSB, XLSM, XLSX, XLTM, XLTX, POTM, POTX, PPSM, PPSX, PPTM, PPTX, PDF
  • Para visualización:
    • WORD: DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTM, HTML, HWP, HWPX, MD, MHT, MHTML, ODT, OTT, PAGES, RTF, STW, SXW, TXT, WPS, WPT, XML
    • CELL: CSV, ET, ETT, FODS, NUMBERS, ODS, OTS, SXC, XLS, XLSM, XLSX, XLT, XLTM, XLTX
    • SLIDE: DPS, DPT, FODP, KEY, ODG, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, SXI
    • PDF: DJVU, DOCXF, OFORM, OXPS, PDF, XPS
    • DIAGRAM: VSDM, VSDX, VSSM, VSSX, VSTM, VSTX
Novedades en la versión 5.3.0

Añadidas las siguientes funciones:

  • Opción para desactivar la verificación de certificados
  • Soporte para abrir una vista previa de documentos en el editor de ONLYOFFICE
  • Añadido el panel Acerca de y actualizadas las descripciones en la configuración
  • Soporte para visualizar los formatos de diagramas .vsdx, .vssx, .vstx, .vsdm, .vssm, .vstm
  • Soporte para visualizar los formatos .odg, .md
  • Soporte para editar archivos .xlsb
  • Añadidas plantillas de archivo vacías en catalán, danés, húngaro, indonesio y rumano

El registro completo de cambios está disponible aquí.

Conectar ONLYOFFICE Docs a Odoo

Requisitos
  • Instancia de ONLYOFFICE Docs. Por favor, consulta la página de documentación oficial para saber más sobre la instalación de ONLYOFFICE Docs:
  • El módulo principal ONLYOFFICE que se requiere para que otros módulos funcionen. El módulo no tiene licencia de pago.
  • ONLYOFFICE Documents módulo que requiere Odoo Enterprise Edition para funcionar correctamente. Este módulo instalará automáticamente el módulo principal ONLYOFFICE.
  • ONLYOFFICE Templates módulo que requiere licencia de ONLYOFFICE con API de Automatización para funcionar correctamente. Este módulo instalará automáticamente el módulo principal ONLYOFFICE.
  • PyJWT es necesario para todos los módulos.
Instalación de la biblioteca PyJWT

Para instalar la biblioteca PyJWT, ejecuta el siguiente comando en la línea de comandos:

pip install pyjwt

Para más información, consulta la Guía de instalación oficial de PyJWT.

Configuración del módulo de integración de ONLYOFFICE para Odoo

Módulo ONLYOFFICE

Para instalar el módulo ONLYOFFICE:

  1. Abre las Aplicaciones.
  2. Encuentra ONLYOFFICE y haz clic en el botón Activar abajo.

ONLYOFFICE Documents

Para instalar el módulo ONLYOFFICE Documents:

  1. Abre las Aplicaciones.
  2. Encuentra ONLYOFFICE Documents y haz clic en el botón Activar abajo.

ONLYOFFICE Templates

Para instalar el módulo ONLYOFFICE Templates:

  1. Abre las Aplicaciones.
  2. Encuentra ONLYOFFICE Templates y haz clic en el botón Activar abajo.

El primer módulo instalado establece automáticamente una conexión con el Servidor de documentos.

Después de la instalación de los módulos, ajusta la configuración dentro de tu Odoo si es necesario. Para hacerlo, ve al Menú principal > Configuración > ONLYOFFICE.

En la URL del Servidor de Documentos, especifica la URL del ONLYOFFICE Docs instalado o la dirección de ONLYOFFICE Docs Cloud. Para saber más sobre la configuración de JWT, por favor consulta la sección correspondiente de esta guía.

Dirección del servidor para solicitudes internas desde el Servicio de Edición de Documentos - el campo se llena automáticamente.

Dirección del Servicio de Edición de Documentos para solicitudes internas desde el servidor - este campo debe tener el mismo valor que la URL del Servidor de Documentos.

Si es necesario, puedes conectarte al servidor de demostración de ONLYOFFICE activando la casilla Conectar al servidor de demostración de ONLYOFFICE Docs. Ten en cuenta que este es un servidor de prueba público, y no se debe cargar ni procesar datos sensibles allí.

Configuración de JWT para la integración de ONLYOFFICE y Odoo

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 en el lado del cliente, por lo que la transmisión entre las partes está protegida y firmada digitalmente.

El token se genera utilizando el estándar JWT (JSON Web Tokens). Los tokens están firmados por la clave del servidor, por lo que el cliente puede verificar que el token es legítimo.

ONLYOFFICE Docs valida el token. Los datos del payload se consideran válidos y se utilizan en lugar de los datos correspondientes de los parámetros principales. Si el token es inválido, el comando no se ejecuta. Para saber más, por favor lee la Guía de Seguridad API.

En Odoo, JWT está habilitado por defecto.

Siga estos pasos para configurarlo manualmente si es necesario:

  1. Ve al menú Inicio > Configuración > ONLYOFFICE.
    ONLYOFFICE_Odoo ONLYOFFICE_Odoo
  2. Introduce los valores en los siguientes campos:
    • Secreto JWT del Servidor de Documentos: La clave secreta se genera automáticamente para restringir el acceso a ONLYOFFICE Docs. Si deseas especificar tu propia clave secreta en este campo, también especifica la misma clave secreta en el archivo de configuración de ONLYOFFICE Docs para habilitar la validación.
    • Encabezado JWT del Servidor de Documentos: El encabezado JWT estándar utilizado en ONLYOFFICE es Authorization. En caso de que este encabezado entre en conflicto con tu configuración, puedes cambiarlo por uno personalizado.

Comenzar a usar ONLYOFFICE Docs dentro de Odoo

Módulo ONLYOFFICE

Para adjuntar un archivo:

  1. Ve al módulo Discusión.
  2. Elige un canal o una discusión.
  3. Haz clic en el botón Adjuntar archivos en el campo de chat.
  4. Selecciona el archivo que necesitas adjuntar y haz clic en OK.
  5. El archivo adjunto se verá así:
    ONLYOFFICE_Odoo ONLYOFFICE_Odoo
Módulo ONLYOFFICE Documents

Para crear un archivo:

  1. Abre el módulo Documentos.
  2. Haz clic en el botón Crear con ONLYOFFICE en el menú desplegable Nuevo en la esquina superior izquierda del panel superior.
  3. Elige una de las siguientes opciones:
    • En blanco - crea un Documento, Hoja de Cálculo, Presentación o formulario PDF vacío.

      Introduce el nombre del archivo en el campo Título si es necesario.

      ONLYOFFICE_Odoo ONLYOFFICE_Odoo

      Haz clic en el botón Crear para crear un archivo, o haz clic en el botón Crear y Establecer Permisos para establecer derechos de acceso para el archivo.

      ONLYOFFICE_Odoo ONLYOFFICE_Odoo
      • Añadir personas o direcciones de correo electrónico en el campo correspondiente.
      • Ver la lista de usuarios con acceso al documento en el panel Personas con acceso.
      • Establecer los parámetros de Acceso General para todos los usuarios internos y para el acceso de terceros a través de enlace.
    • Desde Plantilla - crea un documento basado en una de las plantillas disponibles. Ordena la lista de plantillas por Categorías, Tipo y Idioma, o utiliza el campo Buscar.

      Haz clic en la plantilla para ver su vista previa, o selecciónala haciendo clic en el botón de opción en la esquina superior derecha de la plantilla. Haz clic en el botón Crear para continuar.

Puedes editar cualquier archivo adjunto a las actividades de Odoo y soportado por ONLYOFFICE (ver la lista completa aquí).

Para editar o ver un archivo, haz clic en el botón Abrir en ONLYOFFICE en el panel extendido derecho, por ejemplo:

ONLYOFFICE_Odoo ONLYOFFICE_Odoo
Módulo ONLYOFFICE Templates

Puedes usar una plantilla predefinida disponible en la página principal del módulo.

ONLYOFFICE_Odoo ONLYOFFICE_Odoo

Por favor, ten en cuenta que el número de plantillas disponibles depende de los módulos instalados, es decir, Ventas, Facturación, Calendario, Reclutamiento, etc. Las plantillas de demostración de ONLYOFFICE solo se añadirán a los módulos de Odoo que ya estén instalados. Se recomienda encarecidamente instalar ONLYOFFICE Templates después de instalar otros módulos de Odoo.

Para crear un formulario:

  1. Se recomienda cambiar al modo desarrollador.
    • Ve a la Configuración.
    • Abre la pestaña Configuración General.
    • Desplázate hasta las Herramientas de Desarrollador.
    • Haz clic en la opción de menú Activar el modo desarrollador.
  2. Abre el Menú Principal y elige la opción ONLYOFFICE Templates.
  3. Haz clic en el botón Crear o subir para crear un nuevo formulario.
  4. Introduce el Nombre de la Plantilla.
  5. Introduce el modelo de Odoo en el campo Seleccionar Modelo.
    ONLYOFFICE_Odoo ONLYOFFICE_Odoo
    • Para conocer el nombre del modelo, abre el módulo requerido.
    • Ve a cualquier entrada que tenga un botón ONLYOFFICE Enviar e Imprimir.
    • Mira la URL de la página. El model-xxx es el nombre del modelo de Odoo que necesitas para el campo Seleccionar Modelo. Pégalo en este campo y presiona Enter.
      ONLYOFFICE_Odoo ONLYOFFICE_Odoo
    • También puedes subir una plantilla existente haciendo clic en el botón Subir tu archivo.
  6. La plantilla debe ser creada y estar disponible para edición. Si no, haz clic en el botón Guardar manualmente en la esquina superior izquierda de la pantalla al crear una plantilla.

    Si necesitas crear múltiples plantillas, llena los campos requeridos y haz clic en el botón Nuevo en la esquina superior derecha de la pantalla. La plantilla actual se guardará, los campos estarán nuevamente vacíos, y podrás proceder a crear otra plantilla.

  7. Trabajando con los campos de la plantilla

    Cambia al módulo ONLYOFFICE Templates y haz clic en la plantilla requerida para abrirla para una edición posterior. Si necesitas editar las propiedades de la plantilla, haz clic en el botón Más en la esquina superior derecha del módulo requerido y elige la opción Editar.

  8. Cada campo en cada módulo tiene un signo de interrogación al lado. La información allí es necesaria para completar los campos.
    ONLYOFFICE_Odoo ONLYOFFICE_Odoo

    Si un campo no tiene un signo de interrogación, intenta eliminar temporalmente su contenido. El nombre del campo podría aparecer en su lugar. Estos tipos de nombres también se pueden encontrar en la sección raíz en el panel izquierdo mientras se edita un formulario.

  9. La búsqueda en el conector ONLYOFFICE Templates requiere información de los campos Campo y Módulo.
  10. Si un campo tiene una relación one2many/many2many/many2one, la subsección tendrá un nombre correspondiente.

    Nombre de la subsección

  11. Si el campo Modelo contiene un nombre que no coincide con el dado en la URL (por ejemplo, model-account.move en la URL y account.move.line en el campo Modelo), búscalo en la subsección.

    Si es una relación one2many/many2many/many2one, la clave de la subsección tendrá el mismo nombre que el campo Campo. Por ejemplo, si es un partner_id, la clave tendrá el mismo nombre.

  12. Por favor, ten en cuenta que si el modelo del campo no coincide con el de la URL, la clave de la sección tendrá el mismo nombre que el campo Modelo.
  13. Dado que el conector está integrado dentro de todos los módulos de Odoo, es posible imprimir un formulario completado en el menú Acción > Imprimir con ONLYOFFICE.
  14. Todos los templates disponibles para el módulo seleccionado se mostrarán en el menú abierto. Elige el template requerido para llenarlo con los datos correspondientes al elemento del módulo seleccionado.
  15. El formulario se descargará a tu dispositivo. Los campos se completan automáticamente dependiendo de la página desde la que descargaste el formulario.
  16. Para añadir un conjunto de datos a un formulario
    • crea una tabla en el formulario que tenga las mismas columnas que los nombres de los campos del conjunto de datos;
    • introduce la información dada en los signos de interrogación de Odoo en los campos correspondientes;
    • el resto de la tabla se completará automáticamente durante la impresión de la página.

      Hasta ahora, no se pueden insertar elementos HTML en un formulario.

  17. Para gestionar los derechos de acceso,
    • ve al perfil del usuario;
    • elige si son un Usuario o un Administrador:
      • Usuario solo puede imprimir y ver plantillas.
      • Administrador puede crear, editar, ver, eliminar e imprimir plantillas.
    • todos los usuarios tienen el derecho de acceso de Usuario por defecto.
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

Artículos con tag:
Browse all tags