This module was written to extend the functionality of the reporting engine to support XML reports and allow modules to generate them by code or by QWeb templates.
Table of contents
Installation
To install this module, you need to:
- Install lxml in Odoo’s
$PYTHONPATH
. - Install the repository reporting-engine.
But this module does nothing for the end user by itself, so if you have it installed it’s probably because there is another module that depends on it.
Usage
This module is intended as a base engine for other modules to use it, so no direct result if you are a user.
If you are a developer
To learn from an example, just check the sample module.
To develop with this module, you need to:
- Create a module.
- Make it depend on this one.
- Follow instructions to create reports having in mind that the
report_type
field in yourir.actions.report.xml
record must beqweb-xml
.
In case you want to create a custom report, the instructions remain the same
as for HTML reports, and the method that you must override is also called
_get_report_values
, even when this time you are creating a XML report.
You can make your custom report inherit report_xml.xsd_checked_report
, name
it like your XML <template>
id prepended by report.
, add a xsd()
method that returns a XSD in a string, and have XSD automatic checking for
free.
You can visit http://<server-address>/report/xml/<module.report_name>/<ids>
to see your XML report online as a web page.
For further information, please visit:
Bug Tracker
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
Credits
Contributors
- Enric Tobella <etobella@creublanca.es>
Jairo Llopis
Other credits
- Icon taken from http://commons.wikimedia.org/wiki/File:Text-xml.svg
Maintainers
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.
This module is part of the OCA/reporting-engine project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.