SuperAPI AI 工具集

odoo-qweb-templates

编程与开发

查看项目

更新于 10-16 01:50

技能介绍

用途:Odoo QWeb 模板技能,面向需要编写 PDF 报表、邮件模板或网站动态页面的场景,也用于调试 QWeb 渲染错误(如 t-if、t-foreach 问题)。

主要能力:可生成完整的 ir.actions.report 记录与 QWeb 模板,示例覆盖自定义 PDF 报表(含报表动作与 web.html_container、web.external_layout 调用)、条件渲染,以及修复传入的损坏模板。

使用方式:通过提及 @odoo-qweb-templates 并描述所需报表或模板来激活;随后可获得报表动作记录与模板;也可粘贴报错模板进行排查。

最佳实践:模型字段用 t-field,Odoo 会自动格式化日期、金额与布尔值;非字段字符串的安全 HTML 输出在 Odoo 15+ 用 t-out,Odoo 14 及以下用 t-esc;PDF 报表调用 web.external_layout 以自动包含公司页眉页脚与 logo;Python 报表辅助函数内可翻译字面量用 _lt()。避免在 QWeb 中使用原始 Python 表达式,t-foreach 不要遗漏 t-as,需要渲染 HTML 内容时不要用 t-esc。

限制:不涵盖动态 QWeb 页面的网站控制器路由(需 Python http.route 知识);邮件模板 QWeb 的变量作用域与报表 QWeb 不同(object 与 docs),本技能主要面向 PDF 报表;QWeb JavaScript(看板/表单组件使用)属于不同引擎,本技能仅覆盖服务端 QWeb;不涵盖 wkhtmltopdf 的页面尺寸、边距、页眉页脚重叠等 PDF 渲染配置。具体安装命令与价格暂未提供。