odoo10-addon-report-py3o 10.0.2.0.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.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>

其中 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.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>

此外，您还必须修改 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.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>

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

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

用法

模板语言有详细的文档 extensively documented，记录作为 objects 在 libreoffice 中公开，您还可以在它们上调用函数。

已知问题/路线图

• 生成条码？

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

• 添加迁移指南 aeroo -> py3o

错误跟踪器

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

致谢

维护者

本模块由OCA维护。

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

要为此模块做出贡献，请访问 https://odoo-community.org。