odoo16-python框架-动作

最新推荐文章于 2024-01-05 16:28:42 发布

Odoo老赵

最新推荐文章于 2024-01-05 16:28:42 发布

阅读量883

点赞数

分类专栏： odoo16官方文档翻译计划文章标签： python odoo

本文链接：https://blog.csdn.net/jiafeitutu/article/details/131930373

版权

odoo16官方文档翻译计划专栏收录该内容

29 篇文章 41 订阅

订阅专栏

总结

1 模型和视图的设计之美

view_ids, view_id,view_mode 最终目的都是为了生成views, 也就是视图.

模型是死的,像男人,一成不变

视图像女人,千变万化, 姿态万千

一阴一阳之谓道,设计之美又在这里得到了体现

2 所有的动作都可以通过web界面来配置

可以通过在"设置-技术-动作" 定义. 定义好之后会出现在对应模型的动作列表中

动作

动作定义了系统响应用户操作的行为比如,登录、操作按钮、选择发票、…

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

type

当前操作的类别决定了可以使用哪些字段以及如何解释操作

name

简短的用户可读的操作描述，可以显示在客户端界面中

客户端可以通过4种形式获得动作:

False 如果当前打开了任何操作对话框，关闭它
字符换: 如果客户端action匹配，将其解释为客户端action的标记，否则将其视为数字
数字: 从数据库中读取相应的动作记录，可以是数据库标识符或外部id
字典: 将其视为客户端操作描述符并执行

1 绑定 Bindings

除了它们的两个强制属性，所有动作还共享可选属性，用于在任意模型的上下文菜单中显示动作:

1.1 binding_model_id

指定操作绑定到哪个模型

注意: 对于 Server Actions,使用model_id

1.2 binding_type

指定绑定的类型，主要是操作将出现在哪个上下文菜单下

action(default)

指定该动作将出现在绑定模型的action上下文菜单中。

report

指定该操作将出现在绑定模型的“打印”上下文菜单中。

这两个都是在form视图中才有的.

1.3 binding_view_types

一个逗号分隔的视图类型列表，操作将出现在上下文菜单中，主要是“list”和/或“form”。默认为列表，表单(列表和表单)

2 窗口动作(ir.actions.act_window)

最常见的动作类型，用于通过视图呈现模型的可视化:

特定的视图类型,如tree.form
特定的记录(通过domain来过滤)

有如下字段:

2.1 res_model

视图对应的模型名称

2.2 views(*)

(view_id, view_type)对的列表。每对中的第二个元素是视图(tree、from、graph等)的类别，第一个元素是可选的数据库id(或False)。如果没有提供id，客户端应该为所请求的模型获取指定类型的默认视图(这是由fields_view_get()自动完成的)。列表的第一种类型是默认视图类型，在执行动作时默认打开。每种视图类型在列表中最多只能出现一次

2.3 res_id(可选的)

如果默认视图是form，则指定要加载的记录(否则应该创建一个新记录)

2.4 `search_view_id` (optional)

(id, name)对，id是要为操作加载的特定搜索视图的数据库标识符。默认为获取模型的默认搜索视图

2.5 `target` (optional)

视图是否应该在主内容区(current)、全屏模式(fullscreen)或对话框/弹出(new)中打开。使用main代替current来清除面包屑。默认为current。

经过测试: 对于URL ACTIONS来说,只有new可以用,其他都报错

2.6`context` (optional)

传递给视图的其他上下文数据

2.7 `domain` (optional)

过滤域以隐式添加到所有视图搜索查询

2.8 `limit` (optional)

默认情况下在列表中显示的记录数。在web客户端中默认为80

2.9 案例

打开合作伙伴中的消费者的视图:

{
    "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",
}

数据库存储的窗口动作有几个不同的字段，应该被客户端忽略，主要用于组成视图列表:

view_mode (default= tree,form )

以逗号分隔的视图类型列表(/!)\没有空格/!)。所有这些类型都将出现在生成的视图列表中(至少有一个False view_id)。

view_ids

M2M用于视图对象，定义了视图的初始内容

<record id="hr_leave_allocation_overtime_action" model="ir.actions.act_window">
    <field name="name">New Allocation Request</field>
    <field name="res_model">hr.leave.allocation</field>
    <field name="view_mode">form</field>
    <field name="view_ids" eval="[(5, 0, 0), (0, 0, {'view_mode': 'form', 'view_id': ref('hr_leave_allocation_overtime_view_form')})]"/>
    <field name="target">new</field>
</record>

又他们碰到eval了,这是啥意思呢?

注意 :

Act_window视图也可以通过ir.actions.act_window.view清晰地定义。

如果您计划为您的模型允许多个视图，最好使用ir.actions.act_window_view，而不是操作view_ids

<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>

这里有个实际的例子

<record id="hr_expense_actions_all" model="ir.actions.act_window">
<field name="name">Expenses Analysis</field>
<field name="res_model">hr.expense</field>
<field name="view_mode">graph,pivot,tree,form</field>
<field name="search_view_id" ref="hr_expense_view_search"/>
<field name="help" type="html">
<p class="o_view_nocontent_empty_folder">
No data yet!
</p><p>
Create new expenses to get statistics.
</p>
</field>
</record>

<record id="hr_expense_actions_all_graph" model="ir.actions.act_window.view">
<field name="view_mode">graph</field>
<field name="view_id" ref="hr_expense.hr_expense_view_graph"/>
<field name="act_window_id" ref="hr_expense_actions_all"/>
</record>

<record id="hr_expense_actions_all_pivot" model="ir.actions.act_window.view">
<field name="view_mode">pivot</field>
<field name="view_id" ref="hr_expense.hr_expense_view_pivot"/>
<field name="act_window_id" ref="hr_expense_actions_all"/>
</record>

<record id="hr_expense_actions_all_tree" model="ir.actions.act_window.view">
<field name="view_mode">tree</field>
<field name="view_id" ref="hr_expense_view_expenses_analysis_tree"/>
<field name="act_window_id" ref="hr_expense_actions_all"/>
</record>

view_id

指定一个特定的视图id, 它的类型在view_mode中, 并且没有在view_ids中被填充.

大多时候用于指定一个非默认视图

<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 "视图，即使那不是模型的默认视图。

视图序列的服务器端组成如下:

从view_ids中获取each (id, type)(按顺序排序)
如果view_id已经定义，并且它的类型还没有被填充，那么就添加它的(id, type)
对于view_mode中每个未填充的类型，append (False, type)

view_ids, view_id,view_mode 最终目的都是为了生成views, 也就是视图.

模型是死的,像男人,一成不变

视图像女人,千变万化, 姿态万千

一阴一阳之谓道,设计之美又在这里得到了体现

3 URL动作(ir.actions.act_url)

允许通过Odoo操作打开URL(网站/网页)。可以通过两个字段进行定制:

3.1 url

动作时要打开的地址

3.2 target:

new 在新窗口/页面中打开该地址(默认值)
self 将当前内容替换为该页

{
    "type": "ir.actions.act_url",
    "url": "https://odoo.com",
    "target": "self",
}

4 服务器动作(ir.actions.server)

class odoo.addons.base.models.ir_actions.IrActionsServer(env, ids, prefetch_ids)[source]

服务器端的动作。服务器动作在基本模型上工作，并提供可以自动执行的各种类型的操作，例如使用基本操作规则，或者通过在“More”上下文菜单中手动添加操作。

从Odoo 8.0开始，在操作表单视图上增加了一个“创建菜单操作”按钮。它在基本模型的More菜单中创建了一个条目。这允许创建服务器操作并通过界面轻松地在批量模式下运行它们。

fatux: 没见过

可用的操作有:

’ Execute Python Code ':将被执行的Python代码块
’ Create a new Record ':用新值创建一个新记录
’ Write on a Record ':更新记录的值
’ Execute几个动作’:定义一个触发其他几个服务器动作的动作

允许从任何有效的操作位置触发复杂的服务器代码。只有两个字段与客户端相关:

id: 要执行的服务器端动作的在数据库中的ID

context (optional)

运行服务器操作时要使用的上下文数据

数据库内的记录非常丰富，可以根据它们的状态执行许多特定或通用的操作。一些字段(和相应的行为)在状态之间是共享的:

model_id 链接到动作的Odoo模型。

state:

code:执行通过code参数给出的python代码。
object_create:根据fields_lines规范创建一个新的模型crud_model_id记录。
object_write:根据fields_lines规范更新当前记录
multi:执行通过child_ids参数给出的几个动作。

4.2 State fields

根据其状态，行为通过不同的字段定义。每个字段后面都给出了相关的状态。

code :

指定一段Python代码在调用该动作时执行

<record model="ir.actions.server" id="print_instance">
    <field name="name">Res Partner Server Action</field>
    <field name="model_id" ref="model_res_partner"/>
    <field name="state">code</field>
    <field name="code">
        raise Warning(record.name)
    </field>
</record>

代码段可以定义一个名为action的变量，它将作为下一个要执行的操作返回给客户端

<record model="ir.actions.server" id="print_instance">
    <field name="name">Res Partner Server Action</field>
    <field name="model_id" ref="model_res_partner"/>
    <field name="state">code</field>
    <field name="code">
        if record.some_condition():
            action = {
                "type": "ir.actions.act_window",
                "view_mode": "form",
                "res_model": record._name,
                "res_id": record.id,
            }
    </field>
</record>

如果满足某些条件，会要求客户打开表格进行记录

`crud_model_id` (create)(required)

在其中创建新记录的模型

`link_field_id` (create)

Many2one 到ir.model.fields，指定当前记录的m2o字段，新创建的记录应该设置在该字段上(模型应该匹配)。

`fields_lines` (create/write)

创建或复制记录时重写的字段。One2many 有如下字段:

col1

在相关模型中设置的Ir.model.fields (crud_model_id用于创建，model_id用于更新)

value

字段的值，通过类型解释

`type` (value|reference|equation)

value :value字段被解释为文字值(可能被转换)

equation: value字段被解释为Python表达式并求值

reference: ?

`child_ids` (multi)

指定要在multi状态中执行的多个子操作(ir.actions.server)。如果子操作本身返回操作，则最后一个操作将作为multi自己的下一个操作返回给客户端

Evaluation context

在服务器动作的表达式上下文中有许多可用的key:

model: 通过model_id链接到操作的模型对象
Record /records :触发动作的Record /records,t可以为空。
env Odoo环境
datetime, dateutil, time, timezone对应的Python模块
Log: Log (message, level=‘info’)日志功能，记录调试信息。日志表
Warning异常的警告构造函数

fatux: 终于整理完了,感觉挺乱的,没怎么理明白,以后碰到实际案例再说吧

5 报表动作(ir.actions.report)

触发报表的打印。在form视图的打印菜单里

如果您通过而不是标记定义报表，并且希望操作显示在模型视图的Print菜单中，那么您还需要从Bindings中指定binding_model_id。没有必要将binding_type设置为report，因为ir.actions.report将隐式默认为该值。

5.1 `name` (mandatory)

未指定print_report_name时用作文件名。否则，当在某种类型的列表中查找报表时，仅作为助记符/描述有用

5.2 `model` (mandatory)

你的报告将涉及的模型

5.3 `report_type` (default=qweb-pdf)

PDF报告使用qweb-pdf, HTML报告使用qweb-html

5.4 `report_name` (mandatory)

用于呈现报告的qweb模板的名称(外部id)

5.5 print_report_name

定义报表名称的Python表达式。

5.6 groups_id

Many2many字段到允许查看/使用当前报表的组

5.7 multi

如果设置为True，则该操作将不会显示在表单视图上。

5.8 paperformat_id

Many2one字段转换为您希望用于此报告的纸张格式(如果未指定，将使用公司格式)。

5.9 attachment_use

如果设置为True，则报告只在第一次请求时生成一次，然后从存储的报告中重新打印，而不是每次都重新生成。

5.10 attachment

定义报表名称的Python表达式;record 可以作为变量对象访问

6 客户端动作(ir.actions.client)

触发一个完全在客户端实现的操作。

6.1 tag

操作的客户端标识符，一个客户端应该知道如何做出反应的任意字符串

6.2 `params` (optional)

与客户端动作标记一起发送给客户端的附加数据的Python字典

6.3 `target` (optional)

current: 当前主内容区域
fullscreen: 全屏
new: 对话框/弹窗
main: 代替current, 清除面包屑导航

默认值是current

{
    "type": "ir.actions.client",
    "tag": "pos.ui"
}

告诉客户端启动销售点接口，服务器不知道POS接口是如何工作的。

7 定时任务(ir.cron)

动作在预定义的频率上自动触发。

name : 自动动作的名称(主要用于日志显示)
interval_number: 两次执行操作之间的interval_type uom数
interval_type:频率间隔的测量单位(minutes, hours, days, weeks, months)
numbercall:此操作运行的次数。如果期望该操作无限期地运行，则设置为-1。
doall:布尔值, 表示在服务器重启的情况下是否必须执行错过的操作。
model_id: 将调用此操作的模型
code:操作的代码内容。可以是对模型方法的简单调用:
nextcall: 此操作的下一个计划执行日期(日期/时间格式)