掌握 Odoo QWeb 模板编写生成 PDF 报表
解决 Odoo 报表开发难题：本技能指导 AI 编写标准的 QWeb XML 模板，自动生成包含 ir.actions.report 配置的 PDF 报表，支持动态字段显示、条件渲染及邮件模板构建。
为什么需要这个技能
在 Odoo 开发中，自定义 PDF 报表（如发票、交货单、证书）是核心需求。QWeb 是 Odoo 原生的模板引擎，能够自动处理数据绑定和格式化。若手动编写 XML 结构，极易出现字段未绑定、条件标签漏写 t-as 或 HTML 转义导致标签不渲染等低级错误。本技能让 AI 能够直接输出结构正确、包含完整 ir.actions.report 记录的 XML 代码，大幅缩短开发周期。
适用场景
- 定制 PDF 报表：创建发票、送货单、客户卡片等文档，替代静态的
report_xlsx或纯 HTML 文件。 - 邮件模板：构建由工作流动作触发的 QWeb 邮件模板，确保变量作用域正确。
- 动态页面设计：在 Odoo 网站模块中设计带有动态内容的页面布局。
- 模板调试：当报表渲染失败时，提供错误或断裂的模板代码，让 AI 快速定位并修复
t-if、t-foreach等指令问题。
核心工作流
- 明确数据模型：告知 AI 报表绑定的模型（如
hospital.patient）及需要展示的关键字段。 - 生成完整记录：让 AI 输出
<record>标签定义的ir.actions.report记录，包含report_type、report_name等必要配置。 - 编写 QWeb 模板：生成嵌套在
<t>标签中的 XML 内容，使用t-field绑定数据，利用t-out输出纯文本或使用t-esc输出 HTML（需注明 Odoo 版本）。 - 条件逻辑处理：针对
t-if语句，务必要求 AI 添加t-as别名以便在循环体内访问当前记录。
下载和安装
下载 odoo-qweb-templates 中文版 Skill ZIP
解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的说明文档。
你可能还需要
暂无推荐