odoo Actions学习总结

环境

odoo-14.0.post20221212.tar

Actions(动作)

action定义系统响应用户操作的行为：登录、操作按钮、选择发票等…

action可以存储在数据库中，也可以作为字典直接返回，例如按钮方法。所有Action都有两个强制属性：

• type
  当前Action的类别，决定可以使用哪些字段以及如何解释action
  
• name
  action的名称，在客户端的界面中显示对action的简短用户可读描述
  

Bindings(绑定)

除了两个强制属性外，所有action有用于在任意模型的上下文菜单中显示动作的可选属性：

• binding_model_id
  指定action绑定的模型，格式：moduleName.modelName。注解对于“Server Actions”，请使用model_id
  
• binding_type指定绑定的类型，主要是放置action的上下文菜单

• action (默认)
  设置Action将出现在绑定模型的Action上下文菜单。
  
• report
  设置Action将出现在绑定模型的Print上下文菜单。
  

• binding_view_types
  以逗号分隔的视图类型列表，即Action需要显示的上下文菜单所在的视图，主要是“列表”和“表单”。默认为list,form（列表和表单）
  

Window Actions (ir.actions.act_window)

最常见的动作类型，用于通过视图呈现模型的可视化：Window Action为模型定义了一组视图类型（以及可能的特定视图）（以及可能特定的模型记录）。

包含字段:

• res_model
  action触发的要显示的视图关联的模型
  
• views
(view_id，view_type)对的列表。每对视图的第二个元素是视图的类别（tree，form，graph， ……），第一个元素是可选的数据库id（或False）。如果未提供id，则客户端应获取所请求模型的指定类型的默认视图（这由 fields_view_get()自动完成)。列表的第一种类型是默认视图类型，在执行操作时默认打开。每个视图类型在列表中最多应出现一次。当action配置如下时，打开的依旧是tree视图，也就说view_mode似乎是如下文所述，type为ir.actions.act_window的情况下，被忽略了，不起作用

{
    'type': 'ir.actions.act_window',
    'views': [[False, "tree"], [False, "form"]],
    'view_mode': 'form',
    #...
}

• res_id (可选)
  如果默认视图为 form，指定需要加载的记录(否则创建一个条新记录)
  
• search_view_id (可选)
  (id, name) 对, id 为动作需要加载的指定搜索视图的数据库ID。默认获取模型的默认搜索视图。
  
• target (可选)
  视图是否应在主内容区域（current）、以全屏模式（fullscreen）或对话框/弹出窗口（new）中打开。使用main而不是current以清除导航面包屑（实际发现，使用current会导致面导航面包屑不断重复，形如 顾客信息/导入记录/顾客信息/导入数据/...）。默认为new。
  
• context (可选)
  传递给视图的附加上下文
  
• domain (可选)
  隐式添加到所有视图搜索查询的过滤domain
  
• limit (可选)
  默认情况下要在列表中显示的记录数。在web客户端中默认为80
  
• name（可选），action名称，界面显示时拼接到当前面包屑导航(现有导航面包屑 / name值)。默认值为“Unnamed”，注意：如果name值为空字符串，则默认为 Unnamed
  

例如，要使用列表和表单视图打开客户（设置了customer标志的partner）：

{
    "type": "ir.actions.act_window",
    "res_model": "res.partner",
    "views": [[False, "tree"], [False, "form"]],
    "domain": [["customer", "=", true]],
}

或者在新对话框中打开特定产品的表单视图(单独获取):

{
    "type": "ir.actions.act_window",
    "res_model": "product.product",
    "views": [[False, "form"]],
    "res_id": a_product_id,
    "target": "new",
}

另一个例子，在当前页面中打开estate.customer模块的默认列表视图

{
    'type': 'ir.actions.act_window',
    'name': _('导入数据'),
    'res_model': 'estate.customer',
    'views': [[False, "tree"]],
    'view_mode': 'tree',
    'context': self._context,
    'target': 'main'
}

参考连接：

https://www.odoo.com/documentation/14.0/zh_CN/developer/howtos/web.html?highlight=do_action#the-action-manager

在数据库window action中，操作有几个不同的字段，这些字段应被客户端忽略，主要用于组成view列表

• view_mode (默认= tree,form )
  以逗号分隔的视图类型列表，格式为字符串（注意不要包含空格）。所有这些类型都必须在生成的views列表中（至少有一个Falseview_id）
  
• view_ids
  M2M(技术上不是M2M：添加了一个sequence字段，可以只由一个视图类型组成，没有视图id) to view objects，定义views的初始内容。
  注解：Act_window视图也可以通过ir.actions.Act_window.view干净地定义。如果您计划为模型允许多个视图，优先使用ir.actions.cact_window.wiew而不是view_ids action。

<record model="ir.actions.act_window.view" id="test_action_tree">
   <field name="sequence" eval="1"/>
   <field name="view_mode">tree</field>
   <field name="view_id" ref="view_test_tree"/>
   <field name="act_window_id" ref="test_action"/>
</record>

• view_id
  添加到views列表中的特定视图，以防其类型是 view_mode 列表的一部分，并且尚未由view_ids中的某个视图填充
  

这些主要用于从数据文件定义action：

<record model="ir.actions.act_window" id="test_action">
    <field name="name">A Test Action</field>
    <field name="res_model">some.model</field>
    <field name="view_mode">graph</field>
    <field name="view_id" ref="my_specific_view"/>
</record>

将使用“my_specific_view”视图，即使这不是模型的默认视图。

views序列的服务器端组成如下：

• 从view_ids获取每个(id, type)(按sequence排序)
• 如果定义了view_id，并且其类型尚未被填充，则追加其(id,type)
• 对于view_mode中的每个未填充类型，追加(False，type)

应用实践举例

在estate模块的estate.property模型的表单视图中，为Action添加菜单"选取offers"，如下：


action配置：

<?xml version="1.0" encoding="UTF-8"?>
<odoo>
    <data>
        <record id="action_demo_wizard" model="ir.actions.act_window">
            <field name="name">选取offers</field>
            <field name="res_model">demo.wizard</field>
            <field name="type">ir.actions.act_window</field>
            <field name="view_mode">form</field>
            <field name="target">new</field>
            <field name="binding_model_id" ref="estate.model_estate_property"/>
            <field name="binding_view_types">form</field>
        </record>
    </data>
</odoo>

参考连接

https://www.odoo.com/documentation/14.0/zh_CN/developer/reference/addons/actions.html