Odoo销售订单模块中添加自定义按钮以下载选择的发货单

在Odoo的ERP系统中，销售订单和发货单是销售管理流程中的重要组成部分。为了提高工作效率，可以通过自定义按钮的方式，让用户能够方便地下载选择的发货单。本教程将详细介绍如何在销售订单列表视图中添加一个自定义按钮，并实现下载发货单的功能。

准备工作

在开始编写代码之前，需要确保已经有一个Odoo环境，并且熟悉Odoo的基本模块开发流程。此外，了解Odoo的前端技术和后端业务逻辑也是必要的。

添加自定义按钮到销售订单视图

首先，需要在销售订单的列表视图中添加一个自定义按钮。这可以通过修改或创建一个新的XML模板文件来实现。

1. 在模块的views目录下创建一个新的XML文件，例如my_module/views.xml。
2. 在该文件中，导入必要的元素，并扩展销售订单的列表视图，添加自定义按钮：

<odoo>
    <record id="view_order_form_with_download_button" model="ir.ui.view">
        <field name="name">sale.order.form.with_download_button</field>
        <field name="model">sale.order</field>
        <field name="inherit_id" ref="sale.view_order_form"/>
        <field name="arch" type="xml">
            <xpath expr="//form" position="inside">
                <button name="download_delivery_orders" string="Download Delivery Orders" type="object" class="oe_stat_button" groups="base.group_system"/>
            </xpath>
        </field>
    </record>
</odoo>

在这个例子中，inherit_id指向了Odoo内置的销售订单表单视图，xpath用于在表单内部添加新的按钮。name属性定义了按钮的内部名称，string属性定义了按钮显示的文本，type="object"表示这是一个操作按钮，class="oe_stat_button"为按钮添加了样式。

实现下载发货单的功能

接下来，需要为刚才添加的按钮编写JavaScript代码，以便实现下载发货单的功能。

1. 在模块的static/src/js目录下创建一个新的JavaScript文件，例如my_module/DownloadDeliveryOrders.js。
2. 在该文件中，编写JavaScript代码来处理按钮点击事件：

odoo.define('my_module.DownloadDeliveryOrders', function(require) {
    'use strict';

    var core = require('web.core');
    var SaleOrderController = require('sale.controller');

    var DownloadDeliveryOrders = SaleOrderController.include({
        // 重写父类的方法来添加自定义按钮的行为
        download_delivery_orders: function(crnt, form) {
            var selected_ids = form.$('.o_list_view input:checked');
            var delivery_order_ids = [];

            // 获取选中行的ID
            selected_ids.each(function(index, element) {
                if (element.checked) {
                    var record_id = $(element).val();
                    delivery_order_ids.push(record_id);
                }
            });

            // 检查是否有选中的行
            if (delivery_order_ids.length === 0) {
                alert("Please select at least one delivery order to download.");
                return;
            }

            // 调用后端方法来下载发货单
            core.ajax({
                url: '/my_module/delivery_orders/download',
                data: {
                    'ids': delivery_order_ids.join(',')
                },
                type: 'GET'
            }).then(function(result) {
                // 创建一个a标签用于下载文件
                var a = document.createElement('a');
                a.href = result.data;
                a.download = result.filename;
                a.click();
            });
        }
    });

    return DownloadDeliveryOrders;
});

在这段代码中，首先通过require引入了必要的模块。然后，通过include扩展了Odoo内置的销售订单控制器，重写了download_delivery_orders方法来添加下载功能。
在download_delivery_orders方法中，首先获取所有被选中的行的ID，然后调用Odoo的ajax方法向后端发送请求，下载发货单文件。

后端处理下载请求

为了处理前端发送的下载请求，需要在模块的Python控制器中添加一个新的方法。

1. 在模块的controllers目录下创建或修改一个Python文件，例如my_module/controllers.py。
2. 在该文件中，添加一个新的方法来处理下载请求：

from odoo import http

class MyModuleController(http.Controller):
    
    @http.route('/my_module/delivery_orders/download', auth='public', methods=['GET'])
    def download_delivery_orders(self, ids):
        # ids是一个包含选中发货单ID的列表
        # 在这里实现将发货单转换为PDF或其他格式文件的逻辑
        # 然后返回文件的内容和文件名
        # 以下是一个示例代码，实际逻辑需要根据具体需求来实现
        pdf_content = self._generate_pdf(ids)
        filename = 'delivery_orders.pdf'
        return http.send_file(pdf_content, filename)

    def _generate_pdf(self, ids):
        # 这里应该是生成PDF文件的逻辑
        # 以下是一个示例代码，实际逻辑需要根据具体需求来实现
        pdf = '...'
        return pdf

在这个例子中，download_delivery_orders方法接收一个名为ids的参数，该参数是一个包含选中发货单ID的列表。然后，调用一个名为_generate_pdf的私有方法来生成PDF文件，最后通过http.send_file方法返回文件内容和文件名。

总结

通过上述教程，了解了如何在Odoo销售订单模块中添加自定义按钮，并实现了下载选择的发货单的功能。这包括了如何在视图中添加按钮，如何编写JavaScript代码来处理按钮点击事件，以及如何在后端处理下载请求。这些知识可以帮助开发者更好地扩展和自定义Odoo系统，提高销售管理的效率和用户体验。