odoo13-addon-report-py3o 13.0.1.0.5

安装

安装所需的 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 服务器的受信任路径中的模板。在这种情况下，您必须让模块条目为空，并将模板的路径指定为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 问题上跟踪错误。如果遇到问题，请检查您的问题是否已被报告。如果您首先发现它，请通过提供详细且受欢迎的 反馈来帮助我们粉碎它。

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

学分

维护者

该模块由 OCA 维护。

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

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

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