Odoo 14: 在自定义模块中实现点击按钮下载静态文件教程-Python教程-PHP中文网

Odoo 14: 在自定义模块中实现点击按钮下载静态文件教程

碧海醫心

发布： 2025-10-13 10:05:10

原创

604人浏览过

Odoo 14: 在自定义模块中实现点击按钮下载静态文件教程

本教程详细介绍了如何在odoo 14自定义模块中，通过点击按钮实现从服务器下载静态文件。文章涵盖了静态文件的正确存放路径、后端 python方法中`ir.actions.act_url`动作的配置，以及如何构建下载链接，确保用户能够轻松获取如pdf手册或excel模板等文件。

在Odoo自定义模块开发中，经常会遇到需要让用户从系统中下载预设的静态文件（例如产品手册、操作指南PDF、Excel模板等）的需求。实现这一功能通常涉及在前端界面添加一个按钮，并在后端定义一个方法来触发文件下载。本文将详细指导您如何在Odoo 14中完成这一任务。

1. 静态文件的存放位置

Odoo模块遵循特定的文件结构。静态文件（如CSS、JS、图片、文档等）应放置在模块根目录下的static文件夹内。为了更好的组织性和可访问性，建议将可下载的静态文件放置在static/src/目录下。

例如，如果您的模块名为my_custom_module，并且您要下载一个名为manual.pdf的PDF文件，那么该文件的完整路径应为：

my_custom_module/static/src/manual.pdf

登录后复制

2. 后端Python方法的实现

要实现点击按钮下载文件的功能，我们需要在Odoo模型的Python文件中定义一个方法，该方法将返回一个特定的动作字典，指示Odoo执行URL重定向以触发文件下载。

from odoo import models, fields, api

class MyCustomModel(models.Model):
    _name = 'my.custom.model'
    _description = 'My Custom Model Description'

    name = fields.Char('Name')

    def download_static_file(self):
        """
        点击按钮后触发此方法，用于下载静态文件。
        """
        return {
            'type': 'ir.actions.act_url',
            'url': '/my_custom_module/static/src/manual.pdf',
            'target': 'self', # 或 'new'
        }

登录后复制

代码解析：

type: 'ir.actions.act_url': 这是Odoo中用于执行URL重定向或打开新页面的标准动作类型。当Odoo客户端接收到这种类型的动作时，它会尝试打开指定的URL。
url: '/my_custom_module/static/src/manual.pdf': 这是最关键的部分。它定义了要下载文件的HTTP路径。
- 路径以/开头，表示这是一个相对于Odoo服务器根目录的绝对路径。
- my_custom_module是您的模块名称。
- static/src/是您存放静态文件的子目录。
- manual.pdf是您要下载的文件的实际名称。 Odoo会自动处理对static目录中文件的请求，将其映射到正确的物理路径。
target: 'self': 这个参数控制文件下载的窗口行为。
- 'self'：在当前窗口/标签页中打开URL。对于下载文件，这通常会触发浏览器的下载管理器。
- 'new'：在新窗口或新标签页中打开URL。这对于下载文件也是有效的，有时可以提供更好的用户体验，因为它不会中断用户当前的操作界面。

3. 前端视图中按钮的集成

虽然问题中假设按钮已创建，但在一个完整的教程中，我们仍需简要说明如何在XML视图中定义这个按钮，并将其与上述Python方法关联。

百度文心百中

百度大模型语义搜索体验中心

查看详情

在您的自定义视图（例如views/my_custom_model_views.xml）中，您可以添加一个按钮，其name属性指向您在Python中定义的方法：

<record id="my_custom_model_form_view" model="ir.ui.view">
    <field name="name">My Custom Model Form</field>
    <field name="model">my.custom.model</field>
    <field name="arch" type="xml">
        <form string="My Custom Model">
            <header>
                <button name="download_static_file" 
                        string="下载操作手册" 
                        type="object" 
                        class="oe_highlight"/>
            </header>
            <sheet>
                <group>
                    <field name="name"/>
                </group>
            </sheet>
        </form>
    </field>
</record>

登录后复制

按钮属性解析：

name="download_static_file": 这是最重要的属性，它将按钮的点击事件与Odoo模型中名为download_static_file的Python方法关联起来。
string="下载操作手册": 按钮上显示的文本。
type="object": 表明点击此按钮将调用模型上的一个方法（而不是执行一个Odoo动作）。
class="oe_highlight": Odoo的CSS类，用于高亮显示按钮。

4. 支持的文件类型

这种方法对于各种静态文件类型都有效。经过测试，.pdf和.xlsx文件都可以正常下载。实际上，只要浏览器能够识别并处理的文件类型（通常是下载），这种方法都适用。

5. 注意事项

路径准确性：请务必确保url中指定的模块名称、static/src/路径以及文件名与实际文件存放位置完全匹配。任何拼写错误都可能导致文件无法找到（404错误）。
模块安装/更新：在修改了模块的Python代码或添加了新的静态文件后，请确保更新您的模块，以便Odoo能够识别这些更改。
权限与安全性：放置在static目录下的文件通常是公开可访问的。这意味着任何知道URL的用户都可以下载这些文件。如果您的文件包含敏感信息，不应使用此方法，而应考虑更严格的权限控制机制（例如，通过控制器方法进行权限检查后再返回文件内容）。
用户体验：为下载按钮提供清晰的文本描述，并考虑使用target='new'，以避免用户在下载文件时离开当前页面。