本教程详细介绍了如何在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'，以避免用户在下载文件时离开当前页面。
总结
通过以上步骤，您可以在Odoo 14的自定义模块中轻松实现点击按钮下载静态文件的功能。核心在于正确配置静态文件的存放路径，并在后端Python方法中返回一个ir.actions.act_url类型的动作，指向该静态文件的公共URL。这种方法简洁高效，适用于大多数静态文件下载需求。
