报告

# Odoo 电子邮件模板和 QWeb 报告技能 (v2.0) 跨版本 14-19 创建、管理、调试和迁移 Odoo 电子邮件模板和 QWeb 报告的综合技能。具有 wkhtmltopdf 配置、阿拉伯语/RTL 支持、双语报告模式和智能版本感知语法。 ## 配置 * **支持的版本**：Odoo 14、15、16、17、18、19 * **主要版本**：Odoo 17 * **模板数据库**：分析了 400 多个模板 * **模式库**：50+ 电子邮件模式、30+ QWeb 模式 * **核心模型** : `mail.template` * **渲染引擎**：inline_template (Jinja2)、QWeb ** ** ## 快速参考 ### 模板架构 ┌──────────────────────────────────────────────────────────────────────────────┐ │ ODOO 电子邮件模板架构 │ ├──────────────────────────────────────────────────────────────────────────────┤ │ │ │ 邮件.模板 │ │ ├── 继承：mail.render.mixin (渲染引擎) │ │ ├── 继承：template.reset.mixin (重置 - Odoo 16+) │ │ │ │ │ ├── 标头字段（inline_template 引擎）： │ │ │ • 主题 • email_from • email_to │ │ │ • email_cc •reply_to •partner_to │ │ │ │ │ ├── 内容字段（QWeb 引擎）： │ │ │ • body_html │ │ │ │ │ ├── 附件字段： │ │ │ • Attachment_ids（静态） │ │ │ • 报告模板 (Odoo 14-16) / 报告模板_ids (Odoo 17+) │ │ │ • 报告名称（动态文件名） │ │ │ │ │ └── 配置： │ │ • email_layout_xmlid • auto_delete • mail_server_id │ │ • use_default_to • Scheduled_date │ │ │ └──────────────────────────────────────────────────────────────────────────────┘ ### 渲染流程 mail.template.send_mail_batch(res_ids) │ ├─► _generate_template(res_ids, render_fields) │ │ │ ├─► _classify_per_lang() # 按语言分组 │ │ │ ├─► _render_field() 对于每个： │ │ • 主题 (inline_template) │ │ • body_html (qweb) │ │ • email_from、email_to 等。 │ │ │ ├─► _generate_template_recipients() │ │ │ ├─► _generate_template_attachments() │ │ • 静态附件 │ │ • 报告 PDF 生成 │ │ │ └─► 返回渲染值字典 │ ├─► 创建mail.mail记录 │ ├─► 应用email_layout_xmlid（如果设置） │ └─► ir.qweb._render(layout_xmlid, context) │ └─► 通过mail_server_id 或默认发送 ** ** ## 两个渲染引擎 ### 1\.内联模板引擎（类似 Jinja2） **用于**：`subject`、`email_from`、`email_to`、`email_cc`、`reply_to`、`partner_to`、`lang`、`scheduled_date` # 简单的字段访问 {{ 对象.名称 }} {{ object.partner_id.name }} {{ object.company_id.name }} # 方法调用 {{ object.get_portal_url() }} {{ object.email_formatted }} # 条件表达式（类似三元） {{ object.state == '草稿' 和 '报价' 或 '订单' }} # 或链（后备） {{（object.user_id.email_formatted 或 object.company_id.email_formatted 或 user.email_formatted） }} # 上下文访问 {{ ctx.get('形式') 和 '形式' 或 '' }} # 字符串操作 {{ (object.name 或 '').replace('/', '-') }} ### 2\. QWeb引擎 **用于**：`body_html` **输出标签**： **条件标签**：这是一个草案。此已发送。这已得到证实。 **循环标签**： **属性标签**：查看 ** ** ## 版本决策矩阵特色|奥杜 14 |奥杜 15 |奥杜 16 |奥杜 17 |奥杜 18 |奥杜 19 ---|---|---|---|---|---|--- `t-out` 语法 |尼 | **是** | **是** | **是** | **是** | **是** `t-esc`（旧版）| **是** | **是** | **是** | **是** | **是** | **是** `render_engine='qweb'` |尼 | **是** | **是** | **是** | **是** | **是** `模板类别` |尼 |尼 | **是** | **是** | **是** | **是** `report_template_ids` M2M |尼 |尼 |尼 | **是** | **是** | **是** 公司品牌颜色|尼 |尼 |尼 |尼 |尼 | **是** `email_primary_color` |尼 |尼 |尼 |尼 |尼 | **是** `电子邮件辅助颜色` |尼 |尼 |尼 |尼 |尼 | **是** `mail_notification_layout_with_responsible_signature` |尼 |尼 | **是** | **是** | **是** | **是** 增强沙箱的安全性 |尼 |尼 | **是** | **是** | **是** | **是** ** ** ## 电子邮件布局模板 ### 可用布局布局|宽度|使用案例 ---|---|--- `mail.mail_notification_layout` | 900 像素 |带页眉/页脚的完整通知 `mail.mail_notification_light` | 590 像素 |简单的通知 `mail.mail_notification_layout_with_responsible_signature` | 900 像素 |使用记录的“user_id”签名 ### 布局上下文变量 { # 消息信息 'message': mail.message, # 带正文的消息对象, record_name 'subtype': mail.message.subtype, # 消息子类型 # 显示控制 'has_button_access': Boolean, # 显示操作按钮 'button_access': { # CTA 按钮配置 'url'：字符串， “标题”：字符串 }, 'subtitles': List[String], # 标题字幕 # 记录信息 'record': 记录, # 文档 'record_name': String, # 显示名称 'model_description': String, # 人类可读的模型 # 追踪 'tracking_values': [ # 字段更改（字段名称、旧值、新值）、 ], # 签名 'email_add_signature': Boolean, # 包含签名 'signature': HTML, # 用户签名 # 公司 'company': res.company, # 公司对象 'website_url': String, # 基本 URL # 品牌推广（Odoo 19+） 'company.email_primary_color': String, # 按钮文本颜色 'company.email_secondary_color': String, # 按钮背景 # 实用程序 'is_html_empty': Function, # 检查空 HTML } ** ** ## 命令参考 ### 模板创建命令命令 |描述 ---|--- `/创建电子邮件模板` |为任何型号创建新的电子邮件模板 `/create-qweb-report` |创建新的 QWeb PDF 报告 `/创建通知` |创建带有布局的通知模板 `/创建摘要电子邮件` |创建摘要/摘要电子邮件模板 ### 模板管理命令命令 |描述 ---|--- `/列表模板` |列出模型或模块的所有模板 `/分析模板` |分析现有模板的问题 `/调试模板` |调试模板渲染问题 `/预览模板` |生成模板输出的预览 ### 迁移命令命令 |描述 ---|--- `/迁移模板` |在 Odoo 版本之间迁移模板 `/修复模板` |修复常见模板问题 `/验证模板` |验证模板语法和上下文 ### QWeb 报告命令命令 |描述 ---|--- `/创建报告操作` |使用菜单/按钮创建报告操作 `/风格报告` |将 CSS 样式添加到 QWeb 报告 `/添加页眉页脚` |添加页眉/页脚到报告 ** ** ## 模板模式库 ### 模式 1：基本通知电子邮件 <数据无更新=“1”> <记录id =“email_template_basic_notification”模型=“mail.template”> 基本通知 <字段名称=“model_id”ref=“model_your_model”/> {{ object.name }} - 通知 {{（object.company_id.email 或 user.email_formatted）}} {{ object.partner_id.email }} mail.mail_notification_layout <字段名称=“body_html”类型=“html”>

亲爱的，

这是有关 的通知。

谨致问候，

<字段名称=“auto_delete”eval=“True”/> ### 模式 2：带有报告附件的文档电子邮件 <数据无更新=“1”> <记录 id="email_template_document" model="mail.template"> 发送文档 <字段名称=“model_id”ref=“model_your_model”/> <字段名称=“主题”> {{ object.state in ('草稿', '已发送') 和 '报价' 或 '订单' }} {{ object.name }} {{（object.user_id.email_formatted 或 user.email_formatted）}} {{ object.partner_id.id }} {{ (object.name 或 'Document').replace('/', '-') }} mail.mail_notification_layout <字段名称=“body_html”类型=“html”>

亲爱的，

请查收附件中的 相当于。

如果您有任何疑问，请随时与我们联系。

### 模式 3：订单行表 <标题> <正文> ### 模式 4：CTA 按钮
产品数量价格

总计：

在线查看 ### 模式 5：基于状态的条件内容
草案：该文件尚未确认。

等待确认：请查看并确认。

已完成：此文档已被处理。
### 模式 6：支付信息块

付款信息

参考：

银行账户：

银行：

应付金额：

** ** ## QWeb 报告模式 ### 模式 1：基本报告结构 <记录 id="action_report_document" model="ir.actions.report"> 文档报告你的.model qweb-pdf module_name.report_document_template module_name.report_document_template '文档 - %s' % object.name <字段名称=“binding_model_id”ref=“model_your_model”/> 报告 <模板 id="report_document_template">

日期：

参考：
### 模式 2：带表格的报告

<标题> <正文>

<表类=“表表-sm”>
### 模式 3：分页符控制

新页面内容

描述数量单价金额

小计

税收

总计

本节结束

** ** ## 验证规则 ### 强制飞行前检查在创建任何模板之前，Claude 必须验证： ┌────────────────────────────────────────────────────────────────┐ │ 模板验证清单 │ ├────────────────────────────────────────────────────────────────┤ │ │ │ 1. 模型验证 │ │ □ 目标 Odoo 版本中存在模型 │ │ □ 模型有必填字段（partner_id 等）│ │ □ 模型继承mail.thread（如果有通知） │ │ │ │ 2. 现场验证 │ │ □ 所有 {{ object.field }} 引用都存在 │ │ □ 所有 t-out="object.field" 引用均存在 │ │ □ 相关字段有效 (object.partner_id.name) │ │ │ │ 3. 语法验证 │ │ □ QWeb 标签正确关闭 │ │ □ Jinja2 表达式平衡 {{ }} │ │ □ t-esc (Odoo 14) 和 t-out (Odoo 15+) 不可混合 │ │ │ │ 4. 版本兼容性 │ │ □ 报告模板与报告模板_ids (Odoo 17+) │ │ □ 模板_类别 (Odoo 16+) │ │ □ 公司品牌颜色 (Odoo 19+) │ │ │ │ 5. 安全验证 │ │ □ 没有不安全的 eval() 或 exec() │ │ □ 禁止任意文件访问 │ │ □ 沙箱安全表达式 │ │ │ └────────────────────────────────────────────────────────────────┘ ** ** ## 错误恢复 ### 常见错误及解决方案错误 |原因 |解决方案 ---|---|--- `AttributeError: 'NoneType' 没有属性 'name'` |空字段访问 |使用`object.field_id.name或''` `QWebException：t-esc 已弃用` | Odoo 15+ 中的旧语法 |将“t-esc”替换为“t-out” `KeyError：'format_amount'` |缺少上下文助手 |确保“mail.render.mixin”被继承 `验证错误：无效的 XML` |格式错误的 QWeb |检查XML结构，关闭所有标签 `NameError：名称'对象'未定义` |错误的渲染上下文 |使用模板的模型上下文 ### 调试模板渲染 # 在 Odoo shell 中模板 = env['mail.template'].browse(TEMPLATE_ID) record = env['your.model'].browse(RECORD_ID) # 渲染和检查渲染 = template._render_field( 'body_html', [记录.id], 计算_lang=真）打印（渲染[记录.id]） ** ** ## 特定于模块的模板 ### 销售模块模板ID |目的|型号 ---|---|--- `email_template_edi_sale` |发送报价/订单 |销售订单 `mail_template_sale_confirmation` |订单确认 |销售订单 `邮件模板_销售_付款_执行` |付款已收到 |销售订单 ### 购买模块模板ID |目的|型号 ---|---|--- `email_template_edi_purchase` |发送询价 |采购订单 `email_template_edi_purchase_done` |发送订单 |采购订单 `email_template_edi_purchase_reminder` |发货提醒|采购订单 ### 会计模块模板ID |目的|型号 ---|---|--- `email_template_edi_invoice` |发送发票 |帐户.移动 `email_template_edi_credit_note` |发送贷方通知单 |帐户.移动 `mail_template_data_ payment_receipt` |付款收据 |账户付款 ### 人力资源招聘模板ID |目的|型号 ---|---|--- `email_template_data_applicant_employee` |向员工申请 |人力资源雇员 `email_template_data_applicant_congratulations` |恭喜| hr.申请人 `email_template_data_applicant_refuse` |拒绝通知| hr.申请人 ** ** ## 最佳实践 ### 1\.始终使用后备 ### 2\.使用格式助手 ### 3\.尊重翻译
亲爱的，
### 4\.使用布局来保持一致性 mail.mail_notification_layout ### 5\.处理空 HTML
### 6\.特定于版本的语法 ### 7\.报告附件处理 ### 8\.动态文件名 # 安全文件名生成 {{ (object.name 或 'Document').replace('/', '-') }} ** ** ## wkhtmltopdf 设置和配置 ### ⚠️ 重要：PDF 报告需要 wkhtmltopdf Odoo 使用 wkhtmltopdf 将 QWeb HTML 转换为 PDF。如果没有正确的配置，PDF 生成将会失败。 ### 安装 # 窗口 winget 安装 wkhtmltopdf.wkhtmltox # 或从以下位置下载：https://wkhtmltopdf.org/downloads.html # Ubuntu/Debian sudo apt-get install wkhtmltopdf # macOS 酿造安装wkhtmltopdf ### Odoo 配置（强制）添加到您的`odoo.conf`： [选项] # 窗口 bin_path = C:\Program Files\wkhtmltopdf\bin # Linux bin_path = /usr/local/bin # macOS（自制） bin_path = /opt/homebrew/bin ### 验证服务器重启后，检查日志：将使用 C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe 中的 Wkhtmltopdf 二进制文件 ### 常见错误错误 |原因 |解决方案 ---|---|--- `无法找到 Wkhtmltopdf` | bin_path 未配置 |将 bin_path 添加到 odoo.conf `PDF 生成超时` |请求网络资源|删除外部 URL（字体、图像） `生成空白 PDF` | CSS/SCSS 错误 |检查浏览器控制台，验证 SCSS `使用代码 1 退出` | HTML 语法错误 |验证 QWeb 模板 XML ### 主要限制：离线模式 **wkhtmltopdf 无需网络访问即可运行**。这意味着： * ❌ Google Fonts CDN 将不会加载 * ❌ 外部图像不会渲染 * ❌ 外部 CSS 不适用 * ✅ 使用 `web.external_layout` 作为字体 * ✅ 将图像嵌入为 base64 或使用 Odoo 附件 ** ** ## 阿拉伯语/RTL 和多语言报告 ### ⚠️ 关键：UTF-8 编码要求阿拉伯文本显示为“ÙØ§ØªÙˆØ±Ø©”而不是“فרר”，表示 UTF-8 → Latin-1 编码损坏。 ### 强制模板包装 **始终**使用此结构来支持非拉丁文本： <模板id =“报告文档”>
### ❌错误的模式（会导致编码问题） <模板id =“报告文档”> 报告 <正文> فатяр <模板id =“报告文档”> ### 双语标签图案日期 |塔里希
阿拉伯文

日期
### RTL 文本对齐
暂无说明，留下第一条！
<风格> .rtl { 方向：rtl;文本对齐：右对齐； } .ltr { 方向：ltr;文本对齐：左对齐； } ### 货币符号损坏如果“$”显示为“$”或类似内容： * **原因**：相同的 UTF-8 编码问题 * **解决方案**：使用`web.html_container`包装器 ** ** ## 纸张格式配置 ### 自定义纸张格式模板 <记录id =“paperformat_custom”模型=“report.paperformat”> 自定义发票格式 <字段名称=“默认”eval=“False”/> <字段名称=“格式”>A4 肖像 <字段名称=“margin_top”>20 <字段名称=“margin_bottom”>20 <字段名称=“margin_left”>15 <字段名称=“margin_right”>15 <字段名称=“header_line”eval=“False”/> <字段名称=“header_spacing”>0 <字段名称=“dpi”>90 ### 将论文格式链接到报告 <记录 id="action_report_invoice" model="ir.actions.report"> 自定义发票帐户.移动 qweb-pdf module.report_invoice_template ### 标准纸张格式格式|尺寸|使用案例 ---|---|--- 'A4' | 210 × 297 毫米 |标准国际 '信' | 216 × 279 毫米 |美国标准 `法律` | 216 × 356 毫米 |法律文件 'A5' | 148 × 210 毫米 |小文件 `定制` |设置页宽/页高 |特殊尺寸 ### 方向选项 * `Portrait` \- 垂直（默认） * `Landscape` \- 水平（宽表格、图表） ** ** ## 报告 SCSS 样式 ### 正确的资源包 # __manifest__.py { “资产”：{ 'web.report_assets_common'：[ '模块/静态/src/scss/report_styles.scss', ], }, } ### ⚠️ 关键：Google 字体陷阱 // ❌ BROKEN - URL 中的分号破坏 SCSS 解析 @import url('https://fonts.googleapis.com/css2?family=Poppins:wght@300;400;500;600;700&display=swap'); // ✅ 已修复 - 使用权重范围语法 @import url('https://fonts.googleapis.com/css2?family=Poppins:wght@300..700&display=swap'); // ✅ 最好 - 不要使用 Google 字体（wkhtmltopdf 处于离线状态！） // 通过 web.external_layout 依赖系统字体 ### 为什么外部字体失败 1. wkhtmltopdf 离线运行（无网络访问） 2. Google Fonts CDN 请求超时 3.结果：回退到系统字体 ### 推荐字体堆栈 // 可用于 PDF 生成的安全字体 $report-font-family: 'DejaVu Sans', 'Arial', 'Helvetica', sans-serif; .page { 字体系列：$报告字体系列； } ### 配色方案图案 // 定义一次颜色 $primary-color: #1a5276; // 深蓝色 $次要颜色：#d5dbdb； // 浅灰色 $强调色：#f39c12； // 橙色/金色 $边框颜色：#bdc3c7； $text-dark: #2c3e50; $文本静音：#7f8c8d； // 表头 .table-header, thead tr { 背景颜色：$primary-color；颜色: 白色; } // 标记单元格 .label-cell { 背景颜色：$次要颜色；颜色：$primary-color；字体粗细：粗体； } // 交替行 tbody tr:nth-child(偶数) { 背景颜色：rgba（$次要颜色，0.3）； } ### 打印特定样式 @媒体打印{ // 确保颜色打印 * { -webkit-print-color-adjust：准确！重要；打印颜色调整：精确！重要； } // 分页符 .page-break-before { page-break-before: 总是; } .page-break-after { page-break-after: 总是; } .no-break { 分页内部：避免； } } ** ** ## 调试报告工作流程 ### 系统诊断步骤 ┌────────────────────────────────────────────────────────────────┐ │ 报告调试工作流程 │ ├────────────────────────────────────────────────────────────────┤ │ │ │ 第 1 步：检查基础设施 │ │ ────────────────────────────── │ │ □ wkhtmltopdf安装了吗？ → wkhtmltopdf --版本 │ │ □ odoo.conf 中的 bin_path？ │ │ □ 配置更改后服务器重新启动？ │ │ □ 服务器日志显示wkhtmltopdf 路径？ │ │ │ │ 第 2 步：验证模板结构 │ │ ──────────────────────────────────── │ │ □ 使用web.html_container 包装器？ │ │ □ 使用web.external_layout？ │ │ □ t-foreach 文档有循环吗？ │ │ □ div.page 内的内容？ │ │ │ │ 第 3 步：检查报告操作 │ │ ──────────────────────────── │ │ □ 报告名称与模板 ID 匹配吗？ │ │ □ 报告文件与模板ID 匹配吗？ │ │ □ binding_model_id 正确吗？ │ │ □ 报告类型 = 'qweb-pdf'? │ │ │ │ 第 4 步：在 Shell 中测试渲染 │ │ ──────────────────────────── │ │ python odoo-bin shell -d 数据库 │ │ >>> 报告 = env.ref('module.report_action') │ │ >>> pdf, _ = report._render_qweb_pdf([record_id]) │ │ >>> # 检查控制台是否有错误 │ │ │ │ 第 5 步：浏览器缓存 │ │ ────────────────────── │ │ □ 清除浏览器缓存(Ctrl+Shift+R) │ │ □ 如果需要，清除 Odoo 资源缓存 │ │ │ └────────────────────────────────────────────────────────────────┘ ### 针对特定问题的调试 **编码问题（阿拉伯语、中文等）**：症状： ÙØ§ØªÙˆØ±Ø© 而不是 فกา 原因：缺少 web.html_container 修复：添加作为最外层包装器 **空白 PDF** ：症状：PDF 生成但为空原因： 1. CSS 语法错误 → 检查 SCSS 中 URL 中的分号 2. 缺少模板→验证report_name与模板id匹配 3.没有记录→检查docs变量有记录 **字体未渲染**：症状：PDF 中的字体错误原因：外部字体 URL（wkhtmltopdf 离线）修复：仅使用 web.external_layout 或系统字体 **超时/挂起**：症状：PDF 生成挂起或超时原因：正在获取外部资源修复：删除所有外部 URL（CDN、外部图像） ### 清除资源缓存 # Odoo 外壳 env['ir.attachment'].search([ ('url', '喜欢', '/web/assets/') ]).unlink() env.cr.commit() ** ** ## 双语发票模板（完整示例）基于经过验证的 Sadad_invoice 实现： <记录 id="paperformat_bilingual_invoice" model="report.paperformat"> A4双语发票 <字段名称=“格式”>A4 肖像 <字段名称=“margin_top”>25 <字段名称=“margin_bottom”>25 <字段名称=“margin_left”>15 <字段名称=“margin_right”>15 <字段名称=“dpi”>90 <记录 id="action_report_bilingual_invoice" model="ir.actions.report"> 双语发票帐户.移动 qweb-pdf module.report_bilingual_invoice_document module.report_bilingual_invoice_document <字段名称=“binding_model_id”ref=“account.model_account_move”/> 报告 '发票 - %s' % object.name <模板 id="report_bilingual_invoice_document"> <模板id =“report_bilingual_invoice_content”>

销售发票|巴蒂尔·巴蒂亚特

发票日期 |塔里埃·拉德·塔拉截止日期 |塔里埃·拉萨斯塔·塔尔

客户|详情

<标题> <正文>

#
大佬

描述

拉克罗

数量

兴趣

单价

大佬

小计

付款条件 |详情：
** ** ## 报告验证清单 ### 飞行前检查（强制） ┌────────────────────────────────────────────────────────────────┐ │ QWEB 报告验证清单 │ ├────────────────────────────────────────────────────────────────┤ │ │ │ 1. 基础设施 │ │ □ wkhtmltopdf 已安装并位于路径中 │ │ □ bin_path 在odoo.conf 中配置 │ │ □ 配置更改后服务器重新启动 │ │ □ 服务器日志确认 wkhtmltopdf 路径 │ │ │ │ 2. 模板结构（适用于非拉丁文本） │ │ □ web.html_container 作为最外层包装器 │ │ □ t-foreach 文档循环 │ │ □ 公司标题/字体的 web.external_layout │ │ □ 页内内容 │ │ │ │ 3. 编码验证 │ │ □ 不使用自定义标签 │ │ □ 不通过 CDN 导入外部字体 │ │ □ 阿拉伯文/中文文本正确呈现 │ │ □ 货币符号显示正确（无 $） │ │ │ │ 4. SCSS/CSS 验证 │ │ □ 使用 web.report_assets_common 捆绑包 │ │ □ @import URL 中没有分号 │ │ □ 无外部CDN资源 │ │ □ 仅系统字体（DejaVu、Arial 等）│ │ │ │ 5. 报告行动字段 │ │ □ 报告名称='模块.模板_id' │ │ □ report_file = 'module.template_id' │ │ □ binding_model_id = ref('module.model_xxx') │ │ □ report_type = 'qweb-pdf' │ │ □ paperformat_id 链接（如果自定义） │ │ │ │ 6. 清单文件 │ │ □ 取决于包括目标模块（帐户、销售等） │ │ □ 正确顺序的数据文件（操作前的纸质格式） │ │ □ 资产包 = web.report_assets_common │ │ │ └────────────────────────────────────────────────────────────────┘ ### 生成后测试 # 1.更新模块 python -m odoo -c conf/project.conf -d 数据库 -u 模块 --stop-after-init # 2. 验证服务器日志中的 wkhtmltopdf # 查找：“将在...使用 Wkhtmltopdf 二进制文件” # 3.生成测试PDF # 导航至记录 > 打印菜单 > 选择报告 # 4. 验证PDF内容 # - 所有文本均正确显示（尤其是非拉丁文） # - 货币符号正确 # - 布局与设计相匹配 # - 分页符工作正常 ** ** ## 文件位置参考 ### 核心模板位置 odoo/插件/邮件/ ├── 型号/ │ ├── mail_template.py # 主模型 │ └── mail_render_mixin.py # 渲染引擎 ├── 数据/ │ └── mail_template_data.xml # 基础模板 └── 浏览次数/ └── mail_template_views.xml # UI 视图 odoo/插件/销售/ └── 数据/ └── mail_template_data.xml # 销售模板 odoo/插件/购买/ └── 数据/ └── mail_template_data.xml # 购买模板 odoo/插件/帐户/ └── 数据/ └── mail_template_data.xml # 会计模板 ** ** ## 相关文档文件|路径|目的 ---|---|--- 电子邮件研究| `C:\odoo\researches\ODOO_EMAIL_TEMPLATES_COMPLETE_RESEARCH.md` |完整的研究文档 Odoo 17 克劳德.md | `odoo17\CLAUDE.md` |开发命令设计系统| `odoo17\DESIGN_SYSTEM_RULES.md` |主题样式规则 ** ** ## 变更日志 ### v2.0.0 - 主要增强功能版本（2026 年 1 月）基于 Sadad_invoice_report 开发的经验教训。 **新部分：** * **wkhtmltopdf 设置和配置** * 安装命令（Windows、Linux、macOS） * Odoo `bin_path` 配置（强制） * 常见错误及解决方法 * 离线模式限制说明 * **阿拉伯语/RTL 和多语言报告** * 关键：UTF-8 编码要求 * `web.html_container` \+ `web.external_layout` 模式 * 导致编码损坏的错误模式 * 双语标签图案（并排、堆叠） * RTL文本对齐 * **纸张格式配置** * 自定义纸张格式模板 * 链接到报告操作 * 标准格式参考（A4、Letter、Legal） * **报告 SCSS 样式** * 正确的资源包（`web.report_assets_common`） * Google Fonts 陷阱（分号破坏 SCSS） * 为什么外部字体在 wkhtmltopdf 中失败 * 推荐字体堆栈 * 配色方案图案 * 打印特定样式 * **调试报告工作流程** * 系统的5步诊断 * 针对特定问题的调试指南 * 资产缓存清理 * **双语发票模板** * 基于sadad_invoice的完整工作示例 * 包含论文格式、报告行动、模板 * 经过验证的 UTF-8/阿拉伯语支持 * **报告验证清单** * 6类飞行前检查 * 生成后测试步骤 **预防的问题：** 问题 |节省时间 ---|--- 阿拉伯语文本编码腐败| 2小时以上 wkhtmltopdf 配置 | 30分钟 Google 字体/外部资源 | 1小时 SCSS分号解析| 1小时 ### v1.0.0 - 初始版本 * 电子邮件模板模式（50+） * QWeb 报告模式（30+） * 版本决策矩阵 (Odoo 14-19) * 命令参考 * 验证规则 * 模块特定模板 ** ** ** ** ## 报告中的二维码和条形码 ### ZATCA/沙特电子发票二维码（法律要求）沙特阿拉伯的 ZATCA 要求所有 B2C 发票上都有二维码。使用 Odoo 的内置条形码 API： ### 可用的条形码类型类型 |使用案例 ---|--- `二维码` |发票、付款、URL 的二维码 `代码128` |产品条形码 (GS1-128) `EAN13` |零售产品代码 `EAN8` |简短的零售产品代码 `代码39` |字母数字代码 “国际乒联” |运输/物流 ### Python：使用 qrcode 库自定义 QR 码 # 在报表模型或控制器中导入二维码导入base64 从 io 导入 BytesIO def _get_qr_code_base64(self, 数据: str) -> str: """生成 QR 码并作为 Base64 字符串返回以嵌入报告中。""" qr = qrcode.QRCode(版本=1，box_size=10，边框=4) qr.add_data(数据) qr.make（适合=真） img = qr.make_image(fill_color="黑色", back_color="白色") 缓冲 = BytesIO() img.save（缓冲，格式=“PNG”）返回base64.b64encode(buffered.getvalue()).decode() ### wkhtmltopdf 条码注释 > 使用“--disable-external-links”时，外部图像 URL（例如“https://...”）不会在 wkhtmltopdf 中呈现。始终使用 Odoo 的内部`/report/barcode/` 路由来呈现服务器端。 ** ** ## 报告向导（用户可配置的报告）当报告需要用户输入（日期范围、分组、语言选择）时，请使用“TransientModel”向导： ### 1\.向导模型 # 向导/report_wizard.py 从 odoo 导入 api、字段、模型类 MyReportWizard(models.TransientModel): _name = 'my.report.wizard' _description = '我的报告向导' date_from = fields.Date( string='起始日期', 必需=真，默认=fields.Date.context_today，） date_to = fields.Date( string='迄今为止', 必需=真，默认=fields.Date.context_today，） Partner_ids = fields.Many2many( 'res.partner', 字符串='合作伙伴', help='留空以包含所有合作伙伴', ） report_type = fields.Selection([ ('总结', '总结'), ('详细', '详细'), ], string='报告类型', 默认='摘要', required=True) def action_print_report(自身): """生成并返回报告操作。""" self.ensure_one() 数据 = { “形式”：{ 'date_from': str(self.date_from), 'date_to': str(self.date_to), 'partner_ids': self.partner_ids.ids, 'report_type': self.report_type, } } 返回 self.env.ref('my_module.action_my_report').report_action( 自我，数据=数据） ### 2\.向导视图 <记录id =“view_my_report_wizard_form”模型=“ir.ui.view”> my.report.wizard.formmy.report.wizard <字段名称=“拱形”类型=“xml”> <组> <字段名称=“date_from”/> <字段名称=“日期”/> <组字符串=“过滤器”> <字段名称=“partner_ids”小部件=“many2many_tags”/> <字段名称=“报告类型”/> <页脚> <按钮名称=“action_print_report”类型=“对象” string="打印报告" class="btn-primary"/> <按钮字符串=“取消”类=“btn-secondary” 特别=“取消”/> <记录id =“action_open_my_report_wizard”模型=“ir.actions.act_window”> 我的报告 my.report.wizard 表单 <字段名称=“目标”>新 ### 3\.报告模板接收向导数据 <模板id =“report_my_report”>
报告：至
### 4\.报告操作（针对向导） <记录 id="action_my_report" model="ir.actions.report"> 我的报告 my.report.wizard qweb-pdf my_module.report_my_report my_module.report_my_report ### 向导的清单条目 “数据”：[ 'security/ir.model.access.csv', # 添加：access_my_report_wizard,... '向导/report_wizard_views.xml', '报告/my_report.xml', '视图/menus.xml', ], ** ** _Odoo 报告插件 v2.0_ _TaqaTechno - 专业电子邮件模板和 QWeb 报告_ _支持 Odoo 14-19 |阿拉伯语/RTL 就绪_

小计 |抱歉，暂无相关信息

税务 |阿尔及利亚

总计 |阿拉伯语

发票日期 \|塔里埃·拉德·塔拉		截止日期 \|塔里埃·拉萨斯塔·塔尔
客户\|详情

小计 \|抱歉，暂无相关信息
税务 \|阿尔及利亚
总计 \|阿拉伯语

产品	数量	价格



总计：

付款信息

新页面内容

销售发票|巴蒂尔·巴蒂亚特

报告： 至

报告：至

奥杜报告

包含技能