odoo 开发入门教程系列-一些用户界面
一些用户界面数据文件 (XML)
参考: 该主题关联文档可以查看Data Files.
上一章，我们通过CSV文件添加了数据。当需要添加数据格式简单时，用CSV格式还是很方便的，当数据格式更复杂时(比如视图架构或者一个邮件模板)，我们使用XML格式。比如包含HTML tags的 help field。虽然可以通过CSV文件加载这样的数据，但是使用XML更方便。
类似CSV文件，XML文件也必须按约定添加到合适的目录，并在 __manifest__.py中进行定义。数据文件中的内容也是在模块安装或者更新时按序加载。因此，对CSV文件所做的所有说明对XML文件都适用。当数据链接到视图时，我们将它们添加到views文件夹中
本章，我们将通过XML文件加载我们第一个action和菜单。Actions 和菜单为数据库中的标准记录。
注解：
当程序很注重性能时，CSV格式优先于XML格式。这是因为，在odoo中加载CSV文件比加载XML文件更快。
odoo中，用户接口(action，菜单和视图)大部分是通过创建和组装XML文件中的记录来定义的。常见的模式为 菜单> action > 视图。为了访问记录，用户在几个菜单级中导航。最深层是触发打开记录列表的action。
操作(Actions)
参考: 主题相关文档可以查看 Actions.
动作可以通过三种方式触发 :
[*]点击菜单项目(链接接到指定动作)
[*]点击视图按钮(如果与action关联)
[*]对象的上下文action
本章仅涵盖第一种情况。 我们Real Estate例子中，希望将一个菜单连接到 estate.property model, 以便创建一个新记录。 action可以视为菜单和model之间的链接
test.model 的基本action:
<record id="test_model_action" model="ir.actions.act_window">
<field name="name">Test action</field>
<field name="res_model">test.model</field>
<field name="view_mode">tree,form</field>
</record>
[*]id外部标识。它可以用于引用记录（不需要知道其在数据库中的标识符）。
[*]modelir.actions.act_window (Window Actions (ir.actions.act_window))的一个固定值
[*]name action名称
[*]res_model action应用的范围。
[*]view_mode 可获取的视图。本例中为列表(树)和表格视图。
odoo中到处都可以找到例子，但是这个 简单action的好例子。关注XML 数据文件结构，因为你在后续的练习中会用到。
<?xml version="1.0"?>
<odoo>
<record id="crm_lost_reason_view_search" model="ir.ui.view">
<field name="name">crm.lost.reason.view.search</field>
<field name="model">crm.lost.reason</field>
<field name="arch" type="xml">
<search string="Search Opportunities">
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><field name="name"/>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><filter string="Include archived" name="archived" domain="['|', ('active', '=', True), ('active', '=', False)]"/>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><separator/>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><filter string="Archived" name="inactive" domain="[('active', '=', False)]"/>
</search>
</field>
</record>
<record id="crm_lost_reason_view_form" model="ir.ui.view">
<field name="name">crm.lost.reason.form</field>
<field name="model">crm.lost.reason</field>
<field name="arch" type="xml">
<form string="Lost Reason">
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><sheet>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> <button name="action_lost_leads" type="object"
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> icon="fa-star">
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><field name="leads_count" />
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> Leads
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> </button>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> <widget name="web_ribbon" title="Archived" bg_color="bg-danger" attrs="{'invisible': [('active', '=', True)]}"/>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> <label for="name"/>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> <h1 >
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> <field name="name" />
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> </h1>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> <field name="active" invisible="1"/>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem>
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem></sheet>
</form>
</field>
</record>
<record id="crm_lost_reason_view_tree" model="ir.ui.view">
<field name="name">crm.lost.reason.tree</field>
<field name="model">crm.lost.reason</field>
<field name="arch" type="xml">
<tree string="Channel" editable="bottom">
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><field name="name"/>
</tree>
</field>
</record>
<record id="crm_lost_reason_action" model="ir.actions.act_window">
<field name="name">Lost Reasons</field>
<field name="res_model">crm.lost.reason</field>
<field name="view_mode">tree,form</field>
<field name="help" type="html">
<p >
Define a new lost reason
</p><p>
Use lost reasons to explain why an opportunity is lost.
</p><p>
Some examples of lost reasons: "We don't have people/skill", "Price too high"
</p>
</field>
</record>
<record id="menu_crm_lost_reason" model="ir.ui.menu">
<field name="action" ref="crm.crm_lost_reason_action"/>
</record>
</odoo>练习
为 estate.property model创建action。
在适当的位置(本例中为odoo14/custom/estate/models/views)创建 estate_property_views.xml
<?xml version="1.0"?>
<odoo>
<record id="link_estate_property_action" model="ir.actions.act_window">
<field name="name">Properties</field>
<field name="res_model">estate.property</field>
<field name="view_mode">tree,form</field>
</record>
</odoo>修改odoo14/custom/estate/__manifest__.py
#!/usr/bin/env python
# -*- coding:utf-8 -*-
{
'name': 'estate',
'depends': ['base'],
'data':['security/ir.model.access.csv',
'views/estate_property_views.xml'
]
}重启服务并观察文件加载日志。
菜单(Menus)
参考: 和本主题关联文档可以查看Shortcuts.
为了减少菜单(ir.ui.menu)定义和链接到对应action的复杂性，我们可以使用 shortcut
test_model_action 一个的基础菜单:
test_model_menu_action 菜单被链接到 test_model_action ，action链接到model test.model。正如前面所述， action可以看做是菜单和model之间的连接。
注意：这里的id的值和action的值不能设置成一样，否则会报错。
然而，菜单总是遵循一种体系结构，实际上有三个层次的菜单：
[*]根菜单，显示在App切换器中（Odoo社区版切换器是一个下拉菜单）
[*]第一级菜单，显示在顶部栏中
[*]动作菜单
最容易的方式是在XML文件中定义结构来创建菜单。
为 test_model_action 定义的一个基础菜单结构:
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem>第三级菜单的名称，直接从action获取，即为action属性值
练习
添加菜单
在合适的目录(本例中为odoo14/custom/estate/models/views)创建 estate_menus.xml 文件
<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem><menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> 修改odoo14/custom/estate/__manifest__.py
#!/usr/bin/env python
# -*- coding:utf-8 -*-
{
'name': 'estate',
'depends': ['base'],
'data':['security/ir.model.access.csv',
'views/estate_property_views.xml',
'views/estate_menus.xml'
]
}重启odoo服务，查看效果
字段，属性和视图(Fields, Attributes And View)
到目前为止，我们只对房产广告使用了通用视图，但在大多数情况下，我们希望对视图进行微调。Odoo有许多微调方式，但通常第一步是确保：
[*]某些字段有默认值
[*]某些字段只读
[*]当记录重复时，某些字段不能被拷贝
在我们的房产业务案例中，我们希望：:
[*]售价只读(往后将自动填充)
[*]当记录重复时，可用日期和售价不能被拷贝
[*]卧室数量应该默认为2
[*]默认可用日期应该为3个月
一些新属性
在进一步进行视图设计之前，让我们回到模型定义。我们看到一些属性，如required=True，会影响数据库中的表模式。其他属性也将影响视图或提供默认值。
练习 -- 添加一些属性到字段。
查找一些合适的属性 (查看字段) 来:
[*]设置售价为只读
[*]阻止复制可用日期和售价
修改odoo14\custom\estate\models\estate_property.py 中EstateProperty类属性expected_price，selling_price的值如下：
expected_price = fields.Float('expected price', digits=(8, 2),required=True)
selling_price = fields.Float('selling price', digits=(8, 2), readonly=True, copy=False)重启服务和并刷新浏览器界面，我们可以看到无法设置任何售价。复制记录时，可用日期应为空。
预期效果可参考该动画连接：https://www.odoo.com/documentation/14.0/zh_CN/_images/attribute_and_default.gif
默认值
可以为任何字段设置默认值。字段定义中，添加 default=X， 其中的X 可以是Python文本值(boolean, integer, float, string) ，也可以是一个以model对象自身为入参并返回一个值的函数：
name = fields.Char(default="Unknown")
last_seen = fields.Datetime("Last Seen", default=lambda self: fields.Datetime.now())例中name字段默认值为‘Unknown’，而last_seen 字段默认值为当前时间
练习 -- 设置默认值
添加适当的默认值:
[*]卧室数量默认值为 2
[*]可用日期默认为3个月内
修改odoo14\custom\estate\models\estate_property.py 中EstateProperty类属性bedrooms，selling_price的值如下：
bedrooms = fields.Integer(default=2)
date_availability = fields.Datetime('Availability Date', copy=False, default= lambda self: fields.Datetime.today())重启服务和并刷新浏览器界面验证
保留字段
参考: 主题相关文档可参考 保留字段名称.
odoo为预定义行为保留了一些字段名称。当需要相关行为时，需要在模型中定义这些保留字段。
练习 -- 添加active字段
添加一个 active 字段到estate.property 模型。
修改odoo14\custom\estate\models\estate_property.py 中EstateProperty类，增加active属性
active = fields.Boolean('Active')重启服务，刷新浏览器界面，新增一条记录，新增时勾选Active复选框，即active=True，验证效果。
预期效果可参考该动画链接：https://www.odoo.com/documentation/14.0/zh_CN/_images/inactive.gif
注意，已存在的记录的active字段默认值为False
练习--为active字段添加设置
为active字段设置默认值
为 active 字段设置适当的属性值，让它不再出现在页面。
练习 -- 添加state字段
为estate.property model添加state 字段(字段名可自定义)，一个选择列表。可选值: New, Offer Received, Offer Accepted, Sold 和Canceled。必选字段，且不能被拷贝，默认值New
修改odoo14\custom\estate\models\estate_property.py 中EstateProperty类，修改active字段，增加state字段
active = fields.Boolean('Active', default=True, invisible=True) # 注意：实践发现，invisible字段不起作用 state = fields.Selection( string='State', selection=[('New','New'),<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> ('Offer Received','Offer Received'),<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> ('Offer Accepted', 'Offer Accepted'),<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> ('Sold','Sold'),<menuitem id="test_menu_root" name="Test">
<menuitem id="test_first_level_menu" name="First Level">
<menuitem id="test_model_menu_action" action="test_model_action"/>
</menuitem>
</menuitem> ('Canceled', 'Canceled')], copy=False )重启服务，验证效果
来源:https://www.cnblogs.com/shouke/p/17253318.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！
页:
[1]