OdooWiki OCA HUB

Report QWeb Parameter

report_qweb_parameter folder_open OCA/reporting-engine open_in_new
Technical Settings License: AGPL-3

This module allows you to add new parameters on QWeb reports. Currently, we have defined a field maximum on a report and a validation of maximal and minimal size. It is useful on xml reports in order to validate length. XML are sometimes XSD dependant and we must validate its format. For example, in spanish facturae (), where length and format must be validated in several fields in order to send an invoice.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds three new attributes to QWeb report templates so report designers can limit, truncate or validate the length of a value before it is printed. If a value is too short or too long, report generation stops with a clear error message.

This module is a technical helper for people who build QWeb report templates (the XML/HTML templates used to print invoices, delivery slips and other documents). It does not add any menu or screen; its effect is visible only inside report templates.

It extends the QWeb rendering engine (ir.qweb) with three new template attributes that can be used on any element that outputs a value (t-esc, t-out or t-raw):

  • t-length: cuts the printed value to the given number of characters.
  • t-minlength: refuses to print a value shorter than the given number of characters.
  • t-maxlength: refuses to print a value longer than the given number of characters.

When a minimum or maximum is set, the value is checked by the new check_length method. If the check fails, a validation error is raised and the report is not produced, with a message such as "Length cannot be less than X" or "Length cannot be more than X".

This is useful when a report must respect a fixed format, for example official electronic invoice files where certain fields have a mandatory size. The module only touches the QWeb report engine; it does not change any business document, and it works together with the standard web module.

Depends on

web

Required by other modules

Models and fields (1)
  • ir.qweb · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 8 confirmed, 1 with no information of 9 versions.

Sources · Odoo 19.0

Confirmed on 2026-11-03 in branch 19.0 of OCA/reporting-engine.

terminal Installation and usage

OCA documentation · Odoo 19.0
  • Add a t-length attribute on report templates fields that will truncate the field
  • Add a t-minlength attribute on report template fields that will check the min length
  • Add a t-maxlength attribute on report template fields that will check the max length

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.