odoo开发教程十：Actions

actions定义了系统对于用户的操作的响应：登录、按钮、选择项目等。

一：窗口action(ir.actions.act_window )

最常用的action类型，用于将model的数据展示出来。

字段列表：
1.res_model -- 需要在view里显示数据的model
2.views -- 一个(view_id, view_type) 列表，view_type代表视图类型如：form,tree,gragh...，view_id是可选的数据库id或False，如果没有指定id，客户端会自动用fields_view_get()获取相应类型的默认视图，type参数列表的第一个会被默认用来展示
3.res_id (可选) -- 当默认的视图类型是form时，可用于指定加载的数据
4.search_view_id (可选) -- (id, name)，id是储存在数据库的搜索视图，默认会读取model的默认搜索视图
5.target (可选) -- 定义视图是 在当前视图上打开(current)、使用全屏模式(fullscreen)、使用弹出框(new)、可使用main代替current来清除面包屑导航
6.context (可选) -- 额外的需要传给视图的环境数据
7.domain (可选) -- 自动添加到视图搜索中的查询
8.limit (可选) -- 在客户端显示的数据量，默认80
9.auto_search(可选) -- 搜索是否在加载默认视图后立即执行，默认True

• view_mode -- 以逗号分隔的视图类型列表，所有类型的视图会被展示出来
• view_ids -- 视图对象的一系列的字段，用于定义视图的默认内容
• view_id -- 将指定的view加入到视图中，以防不被view_ids所包含
  上述参数一般在使用数据文件定义action的时候使用：

二：链接Action(ir.actions.act_url)

可以通过odoo的链接打开一个网站页面，可通过两个字段来自定义：

• url -- 当激活action时所打开的链接
• target -- new：在新窗口打开，self：替换当前页面内容，默认new

三：服务器Action (ir.actions.server)

可以通过action定位来触发复杂的服务端代码：

• id -- 服务端action在数据库存储的id

• context (可选) -- 执行服务端action的上下文环境
  储存在数据库中的action可以基于state执行一些特别的动作，部分字段在state之间是相互共享的

• model_id -- 与action相关联的model，在 evaluation contexts中可用

• condition (可选) -- 使用服务端的 evaluation contexts 来执行python代码，如果是False则阻止action执行，默认值是True

code -- 当调用action时执行的python代码

• object_create -- 使用钩子创建一条新记录（通过create或copy方法）

  • use_create
    1.new - 基于指定的 model_id创建一条记录
    2.new_other - 基于指定的crud_model_id创建一条记录
    3.copy_current - 复制action所引用的记录
    4.copy_other - 复制一个通过ref_object获得的记录

  • fields_lines --当创建或复制记录时需要修改的字段，One2many 会有以下字段：
    1.col1 -- 在use_create里所包含的需要被重赋值的ir.model.fields
    2.value -- 字段对应的值，基于type进行解析
    3.type -- 取值value:就是value字段的值，取值equation：value字段会当成python来解析

  • crud_model_id -- 当use_create为new_other时，表示用于创建新记录的model id
  • ref_object -- 当use_create为copy_other时用于指定创建记录时引用的记录
  • link_new_record -- 是否用用link_field_id将新记录和当前记录进行many2one关联，默认False
  • link_field_id -- 指定当前记录与新记录进行many2one关联的字段

• object_write -- 与object_create相似，只是只修改当前记录而不创建新记录

  • use_create
    1.current - 修改更新到当前记录
    2.other - 修改更新到通过crud_model_id 或 ref_object指定的新记录
    3.expression - 修改更新到通过crud_model_id 以及 write_expression筛选过后的记录
  • write_expression - 返回一条记录或对象id的python表达式
  • fields_lines,crud_model_id,ref_object与object_create一致

• multi
  将通过child_ids many2many关系定义的action一个个执行，如果有action自己返回action，最后一个action被返回给客户端作为将前multi action的下一个action

• trigger 发送一个信号给工作流

  • wkf_transition_id - 用于触发的与workflow.transition有Many2one关系的id
  • use_relational_model - 如果是base（默认），则触发当前记录的维护信号；如果是relational，则触发通过wkf_model_id 和 wkf_field_id筛选出来的当前记录的字段

• client_action -- 返回通过action_id定义的action

四：报表Action (ir.actions.report.xml)

此action为打印报表的触发器：

• name(必选) -- 在一个列表里进行查找时使用
• model (必选) -- 报表所反映的数据来源model
• report_type (必选) -- qweb-pdf | qweb-html
• report_name -- 报表命名，用于输出的pdf文件名
• groups_id -- 可以读取或使用当前报表的用户组，Many2many字段
• paperformat_id -- 报表所使用的纸张格式，默认使用公司的格式，Many2one字段
• attachment_use -- 当取值true的时候只在第一次请求时生成报表，之后直接从保存的报表打印，可用于生成后不会有改变的报表
• attachment -- 使用python表达式来定义报表名字，该记录可用变量object访问

五：客户端Actions (ir.actions.client)

触发一个完全在客户端实现的action：

• tag -- action在客户端的标识符，一般是一个专用的字符串
• params (可选) -- 用来传给客户端的python数据字典格式数据
• target (可选) -- current:当前内容区打开action,fullscreen:以全屏模式打开，new：以弹出框打开