odoo16自动打印报表

作者： 分类：所有,ajax 字数：9483

'# odoo16自动打印报表

一、背景与问题

在Odoo16中，报表系统是企业应用的核心功能之一。传统开发模式中，用户需要手动点击"打印"按钮才能生成报表，这在自动化办公场景中显然不够高效。特别是在电商、物流、制造业等场景中，业务流程往往需要在关键节点自动生成并打印报表。

例如：

  • 订单确认后自动打印发货单
  • 仓储出库时自动生成盘点报表
  • 财务处理完成后自动打印凭证

然而，这种自动化需求在实际开发中面临诸多挑战：

  1. 如何在业务流程中自动触发报表生成
  2. 如何确保报表内容与业务数据实时同步
  3. 如何处理打印过程中的异常和重试机制
  4. 如何保证打印结果的格式和安全性

二、基本原理

Odoo16的报表系统基于以下核心技术栈：

  1. QWeb模板引擎：通过XML定义报表结构
  2. PDF生成系统：基于weasyprint或wkhtmltopdf
  3. 报告控制器：处理打印请求并生成文件
  4. 打印服务接口：提供打印功能的统一入口
  5. 工作流集成：与业务模型的事件触发机制

核心流程如下：

  1. 在业务模型中定义打印触发点（如onchange、create等）
  2. 通过report.print方法生成PDF文件
  3. 调用打印机服务进行打印（可选）
  4. 记录打印日志和状态

三、环境准备

确保开发环境满足以下要求：

# 安装Odoo16
sudo apt install -y python3-pip
pip install odoo==16.0

# 安装依赖库
pip install weasyprint

创建自定义模块结构：

custom_report/
├── __init__.py
├── __manifest__.py
├── models/
│   └── report_model.py
├── controllers/
│   └── report_controller.py
├── views/
│   └── report_views.xml
├── templates/
│   └── report_template.xml
└── static/
    └── assets/

四、核心实现

1. 报表模板定义（XML）

创建templates/report_template.xml：

<template id="report_template">
  <t t-call="web.Odoocss">
    <t t-set="doc" t-value="doc"/>
    <t t-set="company" t-value="doc.company"/>
    <t t-set="order" t-value="doc.order"/>
    
    <div class="page">
      <h1>订单报表</h1>
      <p>客户: <t t-esc="order.partner_id.name"/></p>
      <p>订单号: <t t-esc="order.name"/></p>
      <p>金额: <t t-esc="order.amount_total"/></p>
      <p>打印时间: <t t-esc="doc.print_time"/></p>
    </div>
  </t>
</template>

关键点：

  • 使用t-set定义变量
  • 通过doc对象获取业务数据
  • 模板支持复杂格式控制

2. 生成PDF的Python实现

在models/report_model.py中：

from odoo import models, fields, api
from odoo.addons.report.controllers import main as report_controller
import base64

class ReportModel(models.Model):
    _name = 'report.model'
    _description = '自定义报表模型'

    @api.model
    def generate_report(self, order_id):
        """生成PDF报表"""
        order = self.env['sale.order'].browse(order_id)
        doc = {
            'company': self.env.company,
            'order': order,
            'print_time': fields.Datetime.now()
        }
        
        # 生成PDF
        pdf = report_controller.ReportController()._render_template(
            'report_template', 
            doc, 
            {
                'landscape': False,
                'dpi': 96,
                'margins': (1, 1, 1, 1)
            }
        )
        
        # 保存PDF文件
        report = self.env['ir.attachment'].create({
            'name': f'Order_{order.name}.pdf',
            'type': 'binary',
            'datas': base64.b64encode(pdf).decode('utf-8'),
            'res_model': 'sale.order',
            'res_id': order.id,
            'mimetype': 'application/pdf'
        })
        
        return report.id

关键点：

  • 使用_render_template方法生成PDF
  • 通过ir.attachment保存文件
  • 返回文件ID用于后续操作

3. 自动打印触发机制

在models/report_model.py中添加：

@api.model
def auto_print(self, order_id):
    """自动打印报表"""
    report_id = self.generate_report(order_id)
    
    # 调用打印服务
    try:
        self.env['ir.attachment'].browse(report_id).print()
    except Exception as e:
        self.env['ir.logging'].create({
            'name': 'Print Error',
            'type': 'error',
            'dbname': self.env.cr.dbname,
            'channel': 'report',
            'level': 'error',
            'message': str(e)
        })

关键点：

  • 调用print()方法触发打印
  • 异常处理机制
  • 日志记录功能

五、完整案例

1. 自动打印订单发票案例

创建模块custom_invoice_print，包含以下文件：

models/sale_order.py

from odoo import models, fields, api
from odoo.addons.report.controllers import main as report_controller
import base64

class SaleOrder(models.Model):
    _inherit = 'sale.order'

    @api.model
    def action_print_invoice(self):
        """自动生成并打印发票"""
        self.ensure_one()
        
        # 生成PDF
        pdf = report_controller.ReportController()._render_template(
            'report_invoice_template', 
            {
                'order': self,
                'print_time': fields.Datetime.now()
            }, 
            {
                'landscape': False,
                'dpi': 96,
                'margins': (1, 1, 1, 1)
            }
        )
        
        # 保存PDF
        attachment = self.env['ir.attachment'].create({
            'name': f'Invoice_{self.name}.pdf',
            'type': 'binary',
            'datas': base64.b64encode(pdf).decode('utf-8'),
            'res_model': 'sale.order',
            'res_id': self.id,
            'mimetype': 'application/pdf'
        })
        
        # 触发打印
        attachment.print()

views/sale_order_views.xml

<record id="view_order_form" model="ir.ui.view">
    <field name="name">sale.order.form</field>
    <field name="model">sale.order</field>
    <field name="arch" type="xml">
        <form string="销售订单" version="4.0">
            <sheet>
                <group>
                    <field name="name"/>
                    <field name="partner_id"/>
                    <field name="amount_total"/>
                    <button name="action_print_invoice" 
                            string="自动打印发票" 
                            type="object"
                            icon="terp-go-down"/>
                </group>
            </sheet>
        </form>
    </field>
</record>

templates/report_invoice_template.xml

<template id="report_invoice_template">
  <t t-call="web.Odoocss">
    <t t-set="doc" t-value="doc"/>
    <t t-set="order" t-value="doc.order"/>
    
    <div class="page">
      <h1>销售发票</h1>
      <p>客户: <t t-esc="order.partner_id.name"/></p>
      <p>订单号: <t t-esc="order.name"/></p>
      <p>金额: <t t-esc="order.amount_total"/></p>
      <p>打印时间: <t t-esc="doc.print_time"/></p>
    </div>
  </t>
</template>

六、源码解析

以_render_template方法为例，其核心逻辑在report.controllers.main模块中：

def _render_template(self, template, values, options):
    """Render a QWeb template and return the bytes of the resulting PDF."""
    # 加载模板
    template = self.env['ir.qweb']._load_template(template)
    
    # 渲染模板
    html = template.render(values)
    
    # 生成PDF
    pdf = self._render_qweb_pdf(template, values, options)
    
    return pdf

关键点：

  • 使用_load_template加载模板
  • 通过render方法生成HTML
  • 调用_render_qweb_pdf生成PDF

七、进阶使用

1. 多模板支持

def generate_report(self, order_id, template_name='report_template'):
    """生成指定模板的PDF"""
    order = self.env['sale.order'].browse(order_id)
    doc = {
        'company': self.env.company,
        'order': order,
        'print_time': fields.Datetime.now()
    }
    
    pdf = report_controller.ReportController()._render_template(
        template_name, 
        doc, 
        {
            'landscape': False,
            'dpi': 96,
            'margins': (1, 1, 1, 1)
        }
    )
    
    return pdf

2. 异步打印

from threading import Thread

def auto_print(self, order_id):
    """异步打印报表"""
    Thread(target=self._async_print, args=(order_id,)).start()

def _async_print(self, order_id):
    try:
        report_id = self.generate_report(order_id)
        self.env['ir.attachment'].browse(report_id).print()
    except Exception as e:
        self.env['ir.logging'].create({
            'name': 'Print Error',
            'type': 'error',
            'dbname': self.env.cr.dbname,
            'channel': 'report',
            'level': 'error',
            'message': str(e)
        })

八、性能与工程实践

1. 性能优化

  • 使用缓存机制避免重复生成相同内容
  • 对高频访问的报表进行预生成
  • 使用异步任务处理耗时操作
from odoo import api, models, fields
import asyncio

class ReportCache(models.Model):
    _name = 'report.cache'
    _description = '报表缓存'

    @api.model
    def get_cached_report(self, order_id):
        """获取缓存报表"""
        report = self.search([('order_id', '=', order_id)], limit=1)
        if report:
            return report.datas
        return None

2. 安全风险

  • 需要严格控制打印权限
  • 避免敏感数据泄露
  • 防止恶意用户滥用打印功能
@api.model
def auto_print(self, order_id):
    """安全打印报表"""
    if not self.env.user.has_group('base.group_user'):
        raise exceptions.AccessDenied("无权限进行打印操作")
    
    order = self.env['sale.order'].browse(order_id)
    if not order.exists():
        raise exceptions.UserError("订单不存在")
    
    # 执行打印逻辑

九、常见问题与踩坑

1. 模板加载失败

# 错误示例
template = self.env['ir.qweb']._load_template('report_template')

# 正确方式
template = self.env['ir.qweb']._load_template('report_template', lang=self.env.lang)

2. PDF生成失败

# 错误示例
pdf = report_controller.ReportController()._render_template(
    'report_template', 
    doc, 
    {'landscape': True}
)

3. 打印服务异常

# 错误处理示例
try:
    attachment.print()
except Exception as e:
    self.env['ir.logging'].create({
        'name': 'Print Error',
        'type': 'error',
        'dbname': self.env.cr.dbname,
        'channel': 'report',
        'level': 'error',
        'message': str(e)
    })

十、最佳实践

  1. 关键业务节点触发打印：在订单确认、出库、支付完成等节点自动打印
  2. 模板版本管理：为不同业务场景准备多个模板，通过配置控制使用
  3. 日志记录：记录每次打印操作的详细信息，便于后续审计
  4. 异常处理：对打印过程中的各种异常进行捕获和重试
  5. 安全控制：严格限制打印权限，防止数据泄露
  6. 性能优化：对高频访问的报表进行缓存，降低系统负载

十一、总结

Odoo16的自动打印报表功能是企业数字化转型的重要环节。通过深入理解QWeb模板、PDF生成机制和打印服务接口，我们可以实现复杂的自动化打印需求。在实际开发中，需要根据业务场景选择合适的实现方式：对于简单需求可以直接调用内置功能，而对于复杂场景需要自定义模板和处理逻辑。

本方案提供了完整的实现范例，包括模板定义、PDF生成、自动触发、异常处理等核心要素。同时，也深入分析了性能优化、安全风险等关键问题，为开发者提供了可落地的解决方案。在实际项目中，应根据业务复杂度和性能需求选择合适的实现方式，避免过度设计，同时确保系统的稳定性和可维护性。

none
最后修改于：2026年09月25日 15:05

评论已关闭

推荐阅读

AIGC实战——Transformer模型
2024年12月01日
python , AI , 机器学习
Socket TCP 和 UDP 编程基础（Python）
2024年11月30日
python , tcp , udp
如何使用 ChatGPT 进行学术润色？你需要这些指令
2024年12月01日
AI
最新 Python 调用 OpenAi 详细教程实现问答、图像合成、图像理解、语音合成、语音识别（详细教程）
2024年11月24日
python , AI
ChatGPT 和 DALL·E 2 配合生成故事绘本
2024年12月01日
python , AI
omegaconf，一个超强的 Python 库！
2024年11月24日
python
【视觉AIGC识别】误差特征、人脸伪造检测、其他类型假图检测
2024年12月01日
python , AI
［超级详细］如何在深度学习训练模型过程中使用 GPU 加速
2024年11月29日
python , AI , 机器学习
Python 物理引擎pymunk最完整教程
2024年11月27日
python
MediaPipe 人体姿态与手指关键点检测教程
2024年11月27日
python
深入了解 Taipy：Python 打造 Web 应用的全面教程
2024年11月26日
python
基于Transformer的时间序列预测模型
2024年11月25日
python , Matplotlib , 机器学习
Python在金融大数据分析中的AI应用（股价分析、量化交易）实战
2024年11月25日
python , Matplotlib , 机器学习
AIGC Gradio系列学习教程之Components
2024年12月01日
python , AI
Python3 `asyncio` — 异步 I/O，事件循环和并发工具
2024年11月30日
python
llama-factory SFT系列教程：大模型在自定义数据集 LoRA 训练与部署
2024年12月01日
python , AI , 机器学习
Python 多线程和多进程用法
2024年11月24日
python
Python socket详解，全网最全教程
2024年11月27日
python , http , websocket
python之plot()和subplot()画图
2024年11月26日
python , Matplotlib
理解 DALL·E 2、Stable Diffusion 和 Midjourney 工作原理
2024年12月01日
python , AI , 机器学习
Copyright © 2026 Tech Blog
All Right Reserved | 京ICP备19053165号