odoo14-addon-report-py3o 14.0.1.0.4

安装

安装所需的 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 中作为 objects 暴露，你也可以在这些对象上调用函数。

已知问题/路线图

• 生成条形码？

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

• 添加aeroo -> py3o迁移指南

错误追踪器

错误在GitHub Issues上追踪。如有问题，请先查看是否已报告。如果您是第一个发现它的，请通过提供详细且受欢迎的反馈来帮助我们解决这个问题。

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

致谢

维护者

此模块由OCA维护。

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

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

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