odoo-addon-report-py3o 16.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。