等都有类似特性.

相应地, name属性是经常用到的资源查找方式, 但是也可以使用其他的方式, 例如如果需要查找显示某些特定字符串的label或者CSS类名, 就可以使用string.

position属性用于指定新增元素的位置, 可以有以下的选择:

1.after: 在匹配元素之后, 与匹配元素具有相同的父元素;

2.befor: 在匹配元素之前, 与匹配元素具有相同的父元素;

3.inside(默认值): 作为匹配元素内容;

4.replace: 替换匹配元素的内容, 如果值为空将会删除匹配的元素;

5.attributes: 修改匹配元素的属性.

position属性的这几种可选值大部分容易理解, 只对attributes进行说明. 如果position属性设定为attributes, 那么需要使用value设定该属性的新值. 例如下面的代码将invisible属性设置为1:

1

新建一个views文件夹, 在其中新增一个todo_view.xml文件, 将基本视图扩展代码写入其中:

Todo Task form – User extension

todo.task

I have to...

最后, 在__openerp__.py中增加data描述:

'data': ['views/todo_view.xml'],

更新模块, 创建新任务, 发现新增特性已经应用了, 如下图.

新增一个任务, 然后设定为完成, 切换到管理员角色可以看到包括已完成任务在内的所有任务, 但是现在点击清除已完成任务, 不会将非admin用户的任务的activity设置为False, 满足预期的业务逻辑要求.

但现在存在一个问题: 如果使用admin用户创建一个任务, 并将Responsible设定为另一个用户(例如aaa), 以aaa登录并不能看到这个由admin分配的任务. 这是由于之前设定了行级访问规则, 其中的下面这一句设定导致不能显示, 这个问题在本文最后一部分解决.

[('create_uid','=',user.id)]

List/Tree视图和搜索视图扩展

向todo_view.xml中增加下面的内容扩展List/Tree视图:

Todo Task tree – User extension

todo.task

向todo_view.xml中增加下面的内容扩展搜索视图:

Todo Task tree – User extension

todo.task

domain="[('user_id','in',[uid,False])]" />

domain="[('user_id','=',False)]" />

更新模块, 看效果.

关于扩展模型的更多讨论

前面介绍的模型继承是最基本的模型继承方式, 但是还有更强力的混合类继承和代理继承方式. 前者通过继承将某个模型的所有功能特性加入另一个模型中, 后者通过一种透明的方式访问另一个模型中的数据.

利用原型继承实现模型特性的拷贝

之前使用_inherit属性来扩展一个模型, 定义一个继承todo.task模型的类, 然后向该其添加了一些特性, 这种方法中类的_name属性没有进行设定, 仍然是todo.task.

如果使用模型的_name属性, 可以创建混合类(mixin class).

from openerp import models

class TodoTask(models.Model):

_name = 'todo.task'

_inherit = 'mail.thread'

以上代码将模型mail.thread的特性拷贝到模型todo.task, 使todo.task具有了mail.thread的功能特性. mail.thread实现了消息和关注功能, 这个功能是可重用的, 所以可以非常方便地将该特性添加到其他模型上.

上面提到的拷贝意味着继承的新模型中可以获得被继承的所有字段和方法, 也即被继承模型中的字段也将在继承的新模型对应的数据库表中创建, 并且新模型中也包括未继承前的所有字段. 旧模型和继承后的新模型的数据被分别保存, 不会产生冲突. 下图是一个示意图.

上图中最上方可以看到一个名为”gogogo”的任务中, 用户aaa发送了两条消息给所有关注该任务的用户. 在数据库的todo_task表(旧模型)中, 只保存旧的字段, 而社交网络数据则保存在mail_message表(新模型中包括)中并与todo_task中的记录关联起来.

混合模型一般用于抽象模型, 例如mail.thread. 抽象模型与通常的模型类似, 只是抽象模型不在数据库中创建相应的数据表, 所以抽象模型更像是一个模板, 描述重用于普通模型时的字段和业务逻辑, 抽象模型中定义的字段只会在继承自它的普通模型中创建.

一般使用混合(mixin)继承时, 很少继承自普通模型, 因为这种继承机制将会复制相同的数据结构. 如果必须继承普通模型, 那么应该使用odoo提供你的代理继承机制, 这种机制能够避免数据结构的复制.

使用代理继承嵌入模型

代理继承使用_inherits属性(多一个s)将继承的模型映射到字段.

from openerp import models, fields

class User(models.Model):

_name = 'res.users'

_inherits = {'res.partner': 'partner_id'}

partner_id = fields.Many2one('res.partner')

例如以上的代码是标准的Users模型(res.users), 其中嵌入了了一个Partner模型. 当创建一个新的User时, 一个Partner将会同时创建, 并且partner_id中将会保存这个Partner的引用, 这种机制类似OO中的多态概念.

嵌入的模型(Partner)中的所有字段就像是User的字段一样, 可以以相同的形式直接使用. 例如, partner的name和address字段使用起来与使用User本身的字段一样, 只不过它们的数据实际上保存在关联的Partner模型中. 这样没有数据结构的复制.

注意, 代理继承中只有字段被继承, 方法是不能继承的!

为TODO应用增加社交网络功能

基本步骤

社交网络模块(技术名称mail)提供的消息板可以在很多页面的底部看到, 也被称作Open Chatter.

社交网络消息功能通过mail模块的mail.thread模型提供, 这是一个抽象模型, 可以用以下步骤将其添加到其他模型:

Step 1. 模块中添加对mail模块的依赖;

Step 2. 模型集成于mail.thread模型;

Step 3. 向该模型的form视图中添加Followers和Thread widgets;

Step 4. 为followers设定行级访问规则(可选).

Step1 to Step3

Step1, todo_task依赖于todo_app, 而todo_app依赖于mail, 所以不需要再做;

Step2, 之前我们的模型已经使用_inherit继承了todo.task模型, 因为odoo的_inherit可以接受多个模型继承, 使用列表即可, 所以对todo_task.py进行如下修改:

由:

_inherit = 'todo.task'

改为:

_name = 'todo.task'

_inherit = ['todo.task', 'mail.thread']注意: 创建抽象模型: 派生自models.AbstractModel而不是models.Model即可.

Step3, 使用视图继承将社交网络小组件(widgets)摆放在form底部, 打开todo_view.xml, 添加下面的内容到view_form_todo_task_inherited的arch部分:

message_follower_ids和message_ids这两个字段在mail.thread模型中定义.

更新模块, 看效果. 关注一个任务, 然后登录其他用户打开这个任务, 在下方的社交组件处向关注这个任务的用户发送消息, 其他所有关注该任务的用户都可以收到这条消息了.

修改菜单项

与视图不同, 一般数据记录没有XML的arch结构, 所以不能通过XPath表达式扩展和修改. 想要修改这些数据, 需要使用另一种方式.

利用可以完成模型上的插入或更新操作: 如果x不存在, 插入记录; 否则, 对其进行更新.

例如下面的代码修改菜单项, 将其添加到todo_user模块的todo_view.xml中:

My To-Do

id="todo_app.action_todo_task">

{'search_default_filter_my_tasks': True}

Step4, 修改行级访问规则

在之前的To-Do引用中, 应用了一条行级访问规则, 使得任务只对创建它的用户可见, 但是现在增建了社交网络, 用户之间可以加入协作, 任务需要对其他的用户可见, 例如被分配为任务责任人的让用户或关注任务的用户.

这里需要做的工作于上一节修改菜单项类似: 重写todo_app.todo_task_user_rule, 修改domain_force字段为新的值(现在是任务创建用户ID与当前用户相同). 但是由于todo_app中设定了, 所以不能进行写操作, 这里需要做的是: 删除之前的行级访问规则并且创建一个新的.

为了保持模块组织性, 新建一个security子目录并在其中创建一个名为todo_access_rules.xml的文件, 内容如下:

ToDo Tasks only for owner

eval="[(4, ref('base.group_user'))]"/>

['|',('user_id','in', [user.id,False]),

('message_follower_ids','in',[user.partner_id.id])]

以上代码首先删除已有的todo_task_user_rule记录, 然后创建一条新的记录.需要注意的是对于Followers的处理, 因为followers是partners, 并不是User对象, 所以需要使用user.partner_id.id而不是user.id.

还可以在开发时将改为, 正式发布时再改回来.

最后, 修改__openerp__.py中的data属性:

'data': [

'views/todo_view.xml',

'security/todo_access_rules.xml',

],

更新模块, 看效果吧, 之前提到的由于行级访问控制规则引起的现象没有了, 一切都如计划运行.