odoo12-addon-report-py3o 12.0.2.1.2

安装

安装所需的Python库

pip install py3o.template
pip install py3o.formats

为了允许将ODT或ODS报告转换为其他格式（PDF、DOC、DOCX等），安装libreoffice

apt-get --no-install-recommends install libreoffice

配置

例如，要替换原生发票报告为自定义py3o报告，将以下XML文件添加到您的自定义模块中

<?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>

其中my_custom_module_base是自定义Odoo模块的名称。在此示例中，发票ODT文件位于my_custom_module_base/report/account_invoice.odt。

还可以引用位于Odoo服务器受信任路径中的模板。在这种情况下，必须将module条目留空，并将模板的路径指定为py3o_template_fallback。

<?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>

此外，您还必须修改Odoo服务器配置文件以声明py3o模板允许的根目录。只有位于此目录中的模板才能被py3o报告加载。

[options]
...

[report_py3o]
root_tmpl_path=/odoo/templates/py3o

如果要将发票保存为PDF格式而不是ODT格式，XML文件应如下所示

<?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>

如果想要添加新的py3o PDF报告（而不是替换原生报告），XML文件应如下所示

<?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>

使用

模板语言有广泛的文档，记录在libreoffice中作为对象暴露，您还可以在这些对象上调用函数。

已知问题/路线图

• 生成条码？

• 在演示文件中添加更多详细示例以展示功能

• 添加aeroo -> py3o迁移指南

错误跟踪器

问题跟踪在 GitHub Issues 上。如有问题，请先查看是否已有报告。如果是首次发现，请通过提供详细且受欢迎的 反馈 来帮助我们解决问题。

请不要直接联系贡献者寻求支持或技术问题的帮助。

致谢

维护者

此模块由OCA维护。

OCA，即Odoo社区协会，是一个非营利组织，其使命是支持Odoo功能的协作开发并推广其广泛应用。

此模块是GitHub上的OCA/reporting-engine项目的一部分。

欢迎您贡献力量。了解如何贡献，请访问 https://odoo-community.org/page/Contribute。