Cómo crear una nueva plantilla de formulario ONLYOFFICE para Odoo: una guía detallada
La nueva aplicación ONLYOFFICE Templates te permite automatizar el proceso de creación de formularios utilizando los datos y campos disponibles en Odoo. Aunque hay plantillas listas para usar, tales como facturas, la creación de otras nuevas desde cero puede ser un reto, especialmente para los nuevos usuarios. En esta guía paso a paso, aprenderás a crear nuevas plantillas ONLYOFFICE para varios módulos de Odoo.
Lo que necesitas para empezar
Para empezar a crear formularios, necesitas tener una instancia de Odoo, una instancia de ONLYOFFICE Docs y la aplicación ONLYOFFICE Templates instalada. Este artículo ofrece una visión detallada de esta integración y explica cómo funciona.
Si tienes la app ONLYOFFICE Templates integrada con tu plataforma Odoo, puedes crear nuevas plantillas de formularios, editar las existentes e imprimir plantillas de formularios ya rellenadas basadas en los datos y campos disponibles en Odoo.
Vamos a ver cómo puedes crear una nueva plantilla de formulario para uno de los módulos de Odoo. Por ejemplo, una plantilla de aviso de dos semanas para el departamento de RRHH para facilitar la renuncia de los empleados.
Paso 1. Cambia al modo desarrollador
Para crear nuevas plantillas de formularios, se recomienda activar el modo desarrollador en Odoo. Para ello, haz clic en el icono Configuración en el menú Inicio, encuentra la sección Herramientas de desarrollador en Configuración general y haz clic en el botón Activar el modo desarrollador. Serás redirigido automáticamente al menú Inicio después de que el modo desarrollador esté activado.
Paso 2. Crea una nueva plantilla ONLYOFFICE
El siguiente paso implica la creación de una nueva plantilla ONLYOFFICE en el módulo Plantillas. Inicia la aplicación ONLYOFFICE Templates desde el menú Inicio y haz clic en el botón Nuevo en la esquina superior izquierda del módulo.
La aplicación te permite crear nuevas plantillas desde cero si pulsas el botón Nuevo. Alternativamente, puedes subir un archivo desde tu disco local usando el botón Subir tu archivo. La plantilla de formulario recién creada aparecerá en el módulo.
Al crear una nueva plantilla, es de vital importancia seleccionar el modelo de Odoo requerido. Tu elección depende de lo que vayas a crear. Si eliges el modelo incorrecto, tu plantilla no funcionará como se espera.
Para determinar el nombre del modelo que necesitas seleccionar, puedes echar un vistazo a la dirección URL del registro correspondiente en Odoo. Para hacer esto, accede al módulo de Odoo requerido, abre cualquier registro que tenga el botón Imprimir con ONLYOFFICE y mira la dirección URL para encontrar la pista.
En nuestro caso, queremos crear una plantilla de aviso de dos semanas. Por eso vamos al módulo Empleados, seleccionamos uno de los registros disponibles y miramos su dirección URL. El valor requerido es hr.employee.
Ahora copia este valor y vuelve a la ventana de creación de plantillas. Introduce el valor copiado en el campo Seleccionar modelo y pulsa Intro. El valor hr.employee corresponde al modelo Empleado por lo que este modelo se elegirá automáticamente para nuestra nueva plantilla. No olvides introducir el nombre de la plantilla y crear una nueva plantilla desde cero o subir un nuevo archivo desde tu dispositivo utilizando una de las opciones disponibles. Tu plantilla aparecerá en el módulo Plantillas.
Paso 3. Edita tu nueva plantilla con ONLYOFFICE
Ahora que tu plantilla está creada, ábrela desde el módulo Plantillas y edita su contenido utilizando la funcionalidad del editor ONLYOFFICE. Puedes introducir texto, añadir encabezados y pies de página, insertar objetos y utilizar varias herramientas de formato.
Cuando la versión final de tu plantilla PDF esté lista, puedes proceder con el siguiente paso e insertar campos rellenables basados en los datos de Odoo.
Paso 4. Inserta campos rellenables con la aplicación ONLYOFFICE Templates
Ahora necesitas insertar campos rellenables en tu plantilla para que la aplicación ONLYOFFICE pueda usar los datos de Odoo cuando imprimas la plantilla. Este proceso puede parecer complicado a primera vista, pero no te preocupes. Cuando entiendas el principio básico, será pan comido.
Con la aplicación ONLYOFFICE, puedes añadir automáticamente los campos requeridos basados en ciertos parámetros de Odoo. Dado que el modo desarrollador está activado, todos los campos en cada módulo de Odoo tendrán un signo de interrogación para ayudarte a encontrar los parámetros necesarios. Particularmente, necesitas información de los parámetros Campo y Modelo.
En nuestra plantilla, habrá información sobre uno de nuestros empleados. Por eso necesitas ir al módulo Empleados y abrir uno de los registros. El primer campo de tu plantilla puede ser Manager que mostrará el nombre del gerente del empleado en tu aviso de dos semanas. Así que apunta con el cursor del ratón al signo de interrogación que aparece junto a Manager, y obtendrás algunos parámetros.
Los que necesitas son:
- Campo: parent_id
- Modelo: hr.employee
Es necesario conocer estos parámetros para insertar el campo correcto en la plantilla. Vuelve a tu plantilla y haz clic donde quieras añadir el primer campo. En el panel de la izquierda, inserta parent_id y encuéntralo en la lista. Pertenece a la sección Empleado que tiene muchos campos disponibles.
Ahora busca Manager en la sección Empleado. Este es el campo requerido. Cuando hagas click en él, el campo se añadirá automáticamente a tu plantilla con una cierta clave de Odoo.
¡Felicidades! Acabas de insertar tu primer campo. Utilizando el mismo algoritmo, añade tantos campos como necesites.
Ahora puedes obtenerla completada con los datos de Odoo cuando eliges esta plantilla después de hacer clic en el botón Imprimir con ONLYOFFICE en el menú Acción.
Consejos para encontrar campos de Odoo en la aplicación ONLYOFFICE
Encontrar los campos de Odoo deseados será más fácil si consideras los siguientes consejos:
Consejo 1. Cuando vas a añadir un campo de Odoo en el editor ONLYOFFICE, necesitas saber su tipo en primer lugar. Puedes ver el tipo bajo el parámetro Modelo en el modo desarrollador.
Consejo 2. Si el tipo de un campo es one2many / many2many / many2many /many2one, significa que el valor en este campo es una entidad separada con sus propios campos. Tal campo se mostrará como una sección separada en el panel izquierdo del editor ONLYOFFICE. Al abrir esta sección, todos los campos relacionados de esta entidad se mostrarán también.
Por ejemplo, imagina que necesitas añadir la dirección de un empleado a tu plantilla. Utilizando el modo desarrollador, descubrirás que el nombre de este campo es address_id y su tipo es many2one. Esta es una entidad separada con sus propias propiedades (campos), que también puedes ver y encontrar en el editor ONLYOFFICE.
Haz clic en el botón Enlace interno (flecha) para acceder a todos los campos relacionados en la sección de Odoo.
En este registro Dirección, puedes ver los campos de la entidad Dirección y luego encontrarlos en el editor ONLYOFFICE usando sus nombres. Por ejemplo, vamos a encontrar e insertar el campo Tax ID. Su nombre es vat y pertenece a la sección address_id. En el panel izquierdo del editor ONLYOFFICE, encuentra la sección address_id, abre esta sección y encuentra el campo llamado vat.
Usando el mismo algoritmo, puedes encontrar y añadir fácilmente campos de Odoo con el tipo one2many / many2many / many2many /many2one.
Consejo 3. Si el valor Modelo de un campo especifica un modelo que no es de la dirección URL, entonces necesitas buscar una subsección. Si es así, la clave de la sección tendrá el mismo nombre que el modelo.
Cómo crear tablas en ONLYOFFICE Templates
La aplicación ONLYOFFICE tiene una función útil que facilita el trabajo con tablas. Si quieres crear una plantilla que contendrá una tabla (por ejemplo, una factura con una lista de artículos a vender), no tendrás que insertar campos para todas las filas. Simplemente necesitas crear una tabla en el editor ONLYOFFICE e insertar los campos que corresponden a los campos principales de Odoo usando sus IDs, como Descripción, Cantidad, Precio unitario, Impuestos, Importe, etc.
Para saber que campo debe ser insertado en una determinada columna de tu tabla, puedes colocar el cursor del ratón en el modo desarrollador sobre el encabezado de la columna correspondiente en la sección de Odoo y allí verás el nombre del campo.
Cuando imprimas la plantilla, verás que cada artículo tiene una fila separada. De esta manera, la aplicación ONLYOFFICE puede añadir tantos artículos como sea necesario en función de los datos disponibles en el módulo correspondiente de Odoo.
Obtén la aplicación ONLYOFFICE Templates
Obtén la aplicación ONLYOFFICE desde el mercado de aplicaciones de Odoo y mejora los flujos de trabajo de documentos electrónicos en tu equipo utilizando plantillas ONLYOFFICE para diferentes módulos de Odoo:
Ojo: es necesario obtener una licencia especial de ONLYOFFICE Docs con el soporte de la aplicación Odoo Template. Para obtener más información, por favor, contacta con nuestro equipo de ventas a través de sales@onlyoffice.com.
