QWeb es un motor de renderizado basado en plantillas XML q utiliza Odoo.
Tags
t-set t-value
Permite asignar un valor a una variable. Se pueden hacer operaciones.
<t t-set="resultado" t-value="2 + 2" /> /* Cuando renderize resultado, devuelve: 4 */
t-esc
Renderiza una variable procesandola.
t-raw
Renderiza una variable sin procesarla.
t-field
Para mostrar información de un campo de Odoo.
<t t-field="campo.value">
t-if
Permite realizar renderizados condicionales
<t t-if="value == 1"> <p>Valor 1</p> </t> <t t-elif="value == 2"> <p>Valor 1</p> </t> <t t-else=""> <p>Valor distinto</p> </t> <p t-if="value == 1" t-esc="resultado">
t-foreach
<t t-foreach="[1, 2, 3, 4]" t-as="i"> <p t-esc="i" /> </t>
t-att-a
Indica el valor de atributo de un tag html.
<div t-att-a="1" />
/* renderiza: */
<div a="1" />
<div t-att="{'a': 1, 'b': 2 />
/* renderiza: */
<div a="1" b="2"/>
report
Es el nodo principal que indica que informe es.
<report /* id único del informe */ id="nombre_informe" /* Título del informe q aparecerá en el menú de Odoo */ string="Informe personalizado" /* Modelo de datos q utiliza para el informe*/ model="sales.order" /* Tipo de renderizado, este genera un fichero pdf */ report_type="qweb-pdf" /* Para identificarlo en el menú de Odoo */ name="nombre_modulo.nombre_informe" />
template
Indica el esquema de la plantilla. Un informe puede tener varias plantillas.
<template id="nombre_plantilla_dentro_informe" />
t-call
Permite llamar a otros templates.
t-js
Para poder ejecutar JavaScript.
<t t-set="value" t-value=12" />
<t t-js="odoo">
// A través del objeto odoo, podemos acceder a las
// variable creadas en el template.
console.log("Value", odoo.value);
</t>
Cosas útiles
translate_doc
Permite gestiones bloques y traducciones dependiendo del lenguaje del usuario.
Ver https://www.odoo.com/documentation/12.0/reference/reports.html#translatable-templates
Formateo de valores
// Formate un número estilo: 123,23
<span t-esc="'{0:,.2f}'.format(modelo_datos.campo).replace('.', ',')"/>
// Formato moneda con la configuración del usuario
<span
t-field="modelo_datos.campo"
t-field-options='{
"widget": "monetary",
"display_currency": "o.currency_id"
}'
/>
Cambiar nombre fichero exportado
Con el modo Desarrollo activo, Ajustes > Técnico > Informes, seleccionas el informe y cambia el campo Nombre del Reporte Impreso:
('FACTURA_'+(object.number or '').replace('/','_')+'.pdf')
Este ejemplo nombra el fichero al estilo: «FACTURA_INV_2019_0002.pdf», para mas ejemplos de la sintaxis se puede ver como se enumeran las series.
El nombre del fichero para adjuntar en el correo puede ser distinto y se configura en el campo Prefijo del adjunto al guardar como.
Tips
- A partir de odoo 10 no es necesario el tag inicial:
<odoo> <data> </data> <odoo>
Se puede utilizar Bootstrap y FontAwesome
Se puede insertar CSS global y local
<template id="report_saleorder_style" inherit_id="report.style">
<xpath expr=".">
<t>
.example-css-class {
background-color: red;
}
</t>
</xpath>
</template>
Formatos de papel
Se pueden utilizar los formatos de report.paperformat o crear nuevos
<record id="paperformat_frenchcheck" model="report.paperformat"> <field name="name">French Bank Check</field> <field name="default" eval="True"/> <field name="format">custom</field> <field name="page_height">80</field> <field name="page_width">175</field> <field name="orientation">Portrait</field> <field name="margin_top">3</field> <field name="margin_bottom">3</field> <field name="margin_left">3</field> <field name="margin_right">3</field> <field name="header_line" eval="False"/> <field name="header_spacing">3</field> <field name="dpi">80</field> </record>
Esquema típico
<odoo>
<data>
<report
/* id único del informe */
id="nombre_informe"
/* Título del informe */
string="Informe personalizado"
/* Modelo de datos q utiliza para el informe*/
model="sales.order"
/* Tipo de renderizado, este genera un fichero pdf */
report_type="qweb-pdf"
/* Para identificarlo en el menu de Odoo */
name="nombre_modulo.nombre_informe"
/>
<template id="nombre_plantilla">
<t t-call="report.html_container">
<t t-call="report.external_layout">
/* Estas secciones se repite en todas las páginas
<div class="header"></div>
<div class="page"></div>
<div class="footer"></div>
</t>
</t>
</template>
</data>
</odoo>
Esquema mínimo en Odoo 12
<template id="report_invoice">
<t t-call="web.html_container">
<t t-foreach="docs" t-as="o">
<t t-call="web.external_layout">
<div class="page">
<h2>Report title</h2>
<p>This object's name is
<span t-field="o.name"/>
</p>
</div>
</t>
</t>
</t>
</template>
Configurar un informe desde Odoo
En modo desarrollador podemos ir a Ajustes > Informes > Informes y podemos elegir un informe en concreto ver toda su información.
Una opción útil es cambiar el tipo de informe de «PDF» a «HTML» y si tienes instalado el módulo de edición web, podrás editar el informe desde el navegador, cuando lo visualizas por pantalla.
Desde esta pantalla tambien se pueden ver que vistas QWeb utiliza el informe.
El contenido del informe se puede modificar desde el navegador a traves de la pantalla de vistas QWeb. Pero es aconsejable, crear un módulo y cargarlo desde un fichero, para tenerlo versionado, etc.