Package: odoo10-addon-report-py3o
Report Py3oThe py3o reporting engine is a reporting engine for Odoo based onLibreoffice:the report is created with Libreoffice (ODT or ODS),the report is stored on the server in OpenDocument format (.odt or .ods file)the report is sent to the user in OpenDocument format or in any output format supported by Libreoffice (PDF, HTML, DOC, DOCX, Docbook, XLS, etc.)The key advantages of a Libreoffice based reporting engine are:no need to be a developer to create or modify a report: the report is created and modified with Libreoffice. So this reporting engine has a full WYSIWYG report development tool!For a PDF report in A4/Letter format, it’s easier to develop it with a tool such as Libreoffice that is designed to create A4/Letter documents than to develop it in HTML/CSS, also some print peculiarities (backgrounds, margin boxes) are not very well supported by the HTML/CSS based solutions.If you want your users to be able to modify the document after its generation by Odoo, just configure the document with ODT output (or DOC or DOCX) and the user will be able to modify the document with Libreoffice (or Word) after its generation by Odoo.Easy development of spreadsheet reports in ODS format (XLS output possible).This reporting engine is an alternative toAeroo: these two reporting engines have similar features but their implementation is entirely different. You cannot use aeroo templates as drop in replacement though, you’ll have to change a few details.InstallationInstall the required python libs:pip install py3o.template
pip install py3o.formatsTo allow the conversion of ODT or ODS reports to other formats (PDF, DOC, DOCX, etc.), install libreoffice:apt-get --no-install-recommends install libreofficeConfigurationFor example, to replace the native invoice report by a custom py3o report, add the following XML file in your custom module:<?xml version="1.0" encoding="utf-8"?>
<odoo>

<record id="account.account_invoices" model="ir.actions.report.xml">
    <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>wheremy_custom_module_baseis the name of the custom Odoo module. In this example, the invoice ODT file is located inmy_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 themoduleentry empty and specify
the path to the template aspy3o_template_fallback.<?xml version="1.0" encoding="utf-8"?>
<odoo>

<record id="account.account_invoices" model="ir.actions.report.xml">
    <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.[options]
...

[report_py3o]
root_tmpl_path=/odoo/templates/py3oIf you want an invoice in PDF format instead of ODT format, the XML file should look like:<?xml version="1.0" encoding="utf-8"?>
<odoo>

<record id="account.account_invoices" model="ir.actions.report.xml">
    <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:<?xml version="1.0" encoding="utf-8"?>
<odoo>

<record id="partner_summary_report" model="ir.actions.report.xml">
    <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>
</record>

<!-- Add entry in "Print" drop-down list -->
<record id="button_partner_summary_report" model="ir.values">
    <field name="key2">client_print_multi</field>
    <field name="model">res.partner</field>
    <field name="name">Partner Summary</field>
    <field name="value" eval="'ir.actions.report.xml,%d'%partner_summary_report" />
</record>

</odoo>Configuration parameterspy3o.conversion_commandThe command to be used to run the conversion,libreofficeby default. If you change this, whatever you set here must accept the parameters--headless--convert-to$ext $fileand put the resulting file into$file’s directory with extension$ext. The command will be started in$file’s directory.UsageThe templating language isextensively documented, the records are exposed in libreoffice asobjects, on which you can also call functions.Available functions and objectsuserBrowse record of current userlangThe user’s company’s language as string (ISO code)b64decodebase64.b64decodeformat_multiline_value(string)Generate the ODF equivalent of<br/>and&nbsp;for multiline fields (ODF is XML internally, so those would be skipped otherwise)html_sanitize(string)Sanitize HTML stringtimePython’stimemoduledisplay_address(partner)Return a formatted string of the partner’s addressSample report templatesSample py3o report templates for the main Odoo native reports (invoice, sale order, purchase order, picking, …) are available on the Github projectodoo-py3o-report-templates.Known issues / Roadmapgenerate barcode ?add more detailed example in demo file to showcase featuresadd migration guide aeroo -> py3oBug TrackerBugs are tracked onGitHub Issues. In case of trouble, please
check there if your issue has already been reported. If you spotted it first,
help us smashing it by providing a detailed and welcomed feedback.CreditsContributorsFlorent Aide (XCG Consulting)Laurent Mignon <laurent.mignon@acsone.eu>,Alexis de Lattre <alexis.delattre@akretion.com>,Guewen Baconnier <guewen.baconnier@camptocamp.com>Omar Castiñeira <omar@comunitea.com>Holger Brunn <hbrunn@therp.nl>MaintainerThis 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.To contribute to this module, please visithttps://odoo-community.org.