v 14.0 Third Party 2775
Download for v 14.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Lines of code 236
Technical Name report_xml
LicenseAGPL-3
Websitehttps://github.com/OCA/reporting-engine
Versions 8.0 13.0 14.0 16.0 15.0 10.0 12.0 11.0
You bought this module and need support? Click here!

XML Reports

Production/Stable License: AGPL-3 OCA/reporting-engine Translate me on Weblate Try me on Runboat

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 demo report on GitHub for the model res.company or check it in interface from companies views.

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 your ir.actions.report record must be qweb-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.report_xml.abstract, name it in such way report.<module.report_name>. Also you can add a XSD file for report validation into xsd_schema field of your report (check report definition) and have XSD automatic checking for free.

You can customize rendering process and validation way via changing logic of generate_report and validate_report methods in your report class.

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

Authors

  • Tecnativa
  • Avoin.Systems

Contributors

Other credits

  • Icon taken from http://commons.wikimedia.org/wiki/File:Text-xml.svg

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.