Installation

Install the required python libs:

:literal:`` pip install py3o.template pip install py3o.formats``

To allow the conversion of ODT or ODS reports to other formats (PDF, DOC, DOCX, etc.), install libreoffice:

:literal:`` apt-get –no-install-recommends install libreoffice``

Configuration

For example, to replace the native invoice report by a custom py3o report, add the following XML file in your custom module:

:literal:`` <?xml version=”1.0” encoding=”utf-8”?> <odoo> <record id=”account.account_invoices” model=”ir.actions.report”> <field name=”report_type”>py3o</field> <field name=”py3o_filetype”>odt</field> <field name=”module”>my_custom_module_base</field> <field name=”py3o_template_fallback”>report/account_invoice.odt</field> </record> </odoo>``

where my_custom_module_base is the name of the custom Odoo module. In this example, the invoice ODT file is located in my_custom_module_base/report/account_invoice.odt.

It’s also possible to reference a template located in a trusted path of your Odoo server. In this case you must let the module entry empty and specify the path to the template as py3o_template_fallback.

:literal:`` <?xml version=”1.0” encoding=”utf-8”?> <odoo> <record id=”account.account_invoices” model=”ir.actions.report”> <field name=”report_type”>py3o</field> <field name=”py3o_filetype”>odt</field> <field name=”py3o_template_fallback”>/odoo/templates/py3o/report/account_invoice.odt</field> </record> </odoo>``

Moreover, you must also modify the Odoo server configuration file to declare the allowed root directory for your py3o templates. Only templates located into this directory can be loaded by py3o report.

:literal:`` [options] … [report_py3o] root_tmpl_path=/odoo/templates/py3o``

If you want an invoice in PDF format instead of ODT format, the XML file should look like:

:literal:`` <?xml version=”1.0” encoding=”utf-8”?> <odoo> <record id=”account.account_invoices” model=”ir.actions.report”> <field name=”report_type”>py3o</field> <field name=”py3o_filetype”>pdf</field> <field name=”module”>my_custom_module_base</field> <field name=”py3o_template_fallback”>report/account_invoice.odt</field> </record> </odoo>``

If you want to add a new py3o PDF report (and not replace a native report), the XML file should look like this:

:literal:`` <?xml version=”1.0” encoding=”utf-8”?> <odoo> <record id=”partner_summary_report” model=”ir.actions.report”> <field name=”name”>Partner Summary</field> <field name=”model”>res.partner</field> <field name=”report_name”>res.partner.summary</field> <field name=”report_type”>py3o</field> <field name=”py3o_filetype”>pdf</field> <field name=”module”>my_custom_module_base</field> <field name=”py3o_template_fallback”>report/partner_summary.odt</field> <!– Add entry in “Print” drop-down list –> <field name=”binding_type”>report</field> <field name=”binding_model_id” ref=”base.model_res_partner”/> </record> </odoo>``

## Configuration parameters

py3o.conversion_command The command to be used to run the conversion, libreoffice by default. If you change this, whatever you set here must accept the parameters –headless –convert-to $ext $file and put the resulting file into $file’s directory with extension $ext. The command will be started in $file’s directory.

Usage

The templating language is [extensively documented](http://py3otemplate.readthedocs.io/en/latest/templating.html), the records are exposed in libreoffice as objects, on which you can also call functions.

## Available functions and objects

user Browse record of current user

lang The user’s company’s language as string (ISO code)

b64decode base64.b64decode

format_multiline_value(string) Generate the ODF equivalent of <br/> and   for multiline fields (ODF is XML internally, so those would be skipped otherwise)

html_sanitize(string) Sanitize HTML string

time Python’s time module

display_address(partner) Return a formatted string of the partner’s address

o_format_lang(value, lang_code=False, digits=None, grouping=True, monetary=False, dp=False, currency_obj=False, no_break_space=True) Return a formatted numeric or monetary value according to the context language and timezone

o_format_date(value, lang_code=False, date_format=False) Return a formatted date or time value according to the context language and timezone

## Sample report templates

Sample py3o report templates for the main Odoo native reports (invoice, sale order, purchase order, picking, etc.) are available on the Github project [odoo-py3o-report-templates](https://github.com/akretion/odoo-py3o-report-templates).

Known issues / Roadmap

• generate barcode ?

• add more detailed example in demo file to showcase features

• add migration guide aeroo -> py3o

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

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.