odoo wizard界面显示带复选框列表及勾选数据获取

孙锐锋

实践环境

Odoo 14.0-20221212 (Community Edition)
需求描述

如下图(非实际项目界面截图，仅用于介绍本文主题)，打开记录详情页(form视图)，点击某个按钮(图中的"选取ffers"按钮)，弹出一个向导(wizard)界面，并将详情页中内联tree视图（"Offers" Tab页）的列表记录展示到向导界面，且要支持复选框，用于选取目标记录，然执行目标操作。

详情页所属模型EstateProperty

1. class EstateProperty(models.Model):
2.     _name = 'estate.property'
3.     _description = 'estate property table'
4.     # ... 略
5.     offer_ids = fields.One2many("estate.property.offer", "property_id", string="PropertyOffer")
7.     def action_do_something(self, args):
8.         # do something
9.         print(args)

复制代码

OffersTab页Tree列表所属模型EstatePropertyOffer

1. class EstatePropertyOffer(models.Model):
2.     _name = 'estate.property.offer'
3.     _description = 'estate property offer'
4.    
5.     # ... 略
6.     property_id = fields.Many2one('estate.property', required=True)

复制代码

代码实现

代码组织结构

为了更好的介绍本文主题，下文给出了项目文件大致组织结构(为了让大家看得更清楚，仅保留关键文件)

1. odoo14         
2. ├─custom
3. │  ├─estate
4. │  │  │  __init__.py
5. │  │  │  __manifest__.py
6. │  │  │         
7. │  │  ├─models
8. │  │  │  estate_property.py
9. │  │  │  estate_property_offer.py
10. │  │  │  __init__.py
11. │  │  │         
12. │  │  ├─security
13. │  │  │      ir.model.access.csv
14. │  │  │      
15. │  │  ├─static
16. │  │  │  │      
17. │  │  │  └─src
18. │  │  │      │         
19. │  │  │      └─js
20. │  │  │              list_renderer.js
21. │  │  │              
22. │  │  ├─views
23. │  │  │      estate_property_offer_views.xml
24. │  │  │      estate_property_views.xml
25. │  │  │      webclient_templates.xml     
26. │  │  │         
27. │  │  └─wizards
28. │  │        demo_wizard.py
29. │  │        demo_wizard_views.xml
30. │  │        __init__.py
31. │  │         
32. ├─odoo
33. │  │  api.py
34. │  │  exceptions.py
35. │  │  ...略
36. │  │  __init__.py
37. │  │  
38. │  ├─addons
39. │  │  │  __init__.py
40. │  ...略
41. ...略      

复制代码

wizard简介

wizard(向导)通过动态表单描述与用户（或对话框）的交互会话。向导只是一个继承TransientModel而非model的模型。TransientModel类扩展Model并重用其所有现有机制，具有以下特殊性：

• wizard记录不是永久的；它们在一定时间后自动从数据库中删除。这就是为什么它们被称为瞬态(transient)。
  
• wizard可以通过关系字段（many2one或many2many）引用常规记录或wizard记录，但常规记录不能通过many2one字段引用wizard记录
  

详细代码

注意：为了更清楚的表达本文主题，代码文件中部分代码已略去
wizard实现

odoo14\custom\estate\wizards\demo_wizard.py

实现版本1

1. #!/usr/bin/env python
2. # -*- coding:utf-8 -*-
4. import logging
5. from odoo import models,fields,api
6. from odoo.exceptions import UserError
8. _logger = logging.getLogger(__name__)
10. class DemoWizard(models.TransientModel):
11.     _name = 'demo.wizard'
12.     _description = 'demo wizard'
14.     property_id = fields.Many2one('estate.property', string='property')
15.     offer_ids = fields.One2many(related='property_id.offer_ids')
17.     def action_confirm(self):
18.         '''选中记录后，点击确认按钮，执行的操作'''
20.         #### 根据需要对获取的数据做相应处理
21.         # ... 获取数据，代码略(假设获取的数据存放在 data 变量中)
22.      
23.         record_ids = []
24.         for id, value_dict in data.items():
25.             record_ids.append(value_dict.get('data', {}).get('id'))
26.         if not record_ids:
27.             raise UserError('请选择记录')
29.         self.property_id.action_do_something(record_ids)               
30.         return True      
31.    
33.     @api.model
34.     def action_select_records_via_checkbox(self, args):
35.         '''通过wizard窗口界面复选框选取记录时触发的操作
36.         @params: args 为字典
37.         '''
38.         # ...存储收到的数据（假设仅存储data部分的数据），代码略
39.         
40.         return True # 注意，执行成功则需要配合前端实现，返回True
42.     @api.model
43.     def default_get(self, fields_list):
44.         '''获取wizard 窗口界面默认值，包括记录列表 #因为使用了@api.model修饰符，self为空记录集，所以不能通过self.fieldName = value 的方式赋值'''
46.         res = super(DemoWizard, self).default_get(fields_list)
47.         record_ids = self.env.context.get('active_ids') # 获取当前记录ID列表(当前记录详情页所属记录ID列表) # self.env.context.get('active_id') # 获取当前记录ID
49.         property = self.env['estate.property'].browse(record_ids)
50.         res['property_id'] = property.id
52.         offer_ids = property.offer_ids.mapped('id')
53.         res['offer_ids'] = [(6, 0, offer_ids)]
54.         return res

复制代码

说明：

• 注意，不能使用类属性来接收数据，因为类属性供所有对象共享，会相互影响，数据错乱。
  
• action_select_records_via_checkbox函数接收的args参数，其类型为字典，形如以下，其中f412cde5-1e5b-408c-8fc0-1841b9f9e4de为UUID，供web端使用，用于区分不同页面操作的数据，'estate.property.offer_3'为供web端使用的记录ID，'data'键值代表记录的数据，其id键值代表记录在数据库中的主键id，context键值代表记录的上下文。arg数据格式为：
  1. {'uuid':{'recordID1':{'data': {}, 'context':{}}, 'recordID2': {'data': {}, 'context':{}}}}

  复制代码
  1. {'f412cde5-1e5b-408c-8fc0-1841b9f9e4de': {'estate.property.offer_3': {'data': {'price': 30000, 'partner_id': {'context': {}, 'count': 0, 'data': {'display_name': 'Azure Interior, Brandon Freeman', 'id': 26}, 'domain': [], 'fields': {'display_name': {'type': 'char'}, 'id': {'type': 'integer'}}, 'id': 'res.partner_4', 'limit': 1, 'model': 'res.partner', 'offset': -1, 'ref': 26, 'res_ids': [], 'specialData': {}, 'type': 'record', 'res_id': 26}, 'validity': 7, 'date_deadline': '2022-12-30', 'status': 'Accepted', 'id': 21}, 'context': {'lang': 'en_US', 'tz': 'Europe/Brussels', 'uid': 2, 'allowed_company_ids': [1], 'params': {'action': 85, 'cids': 1, 'id': 41, 'menu_id': 70, 'model': 'estate.property', 'view_type': 'form'}, 'active_model': 'estate.property', 'active_id': 41, 'active_ids': [41], 'property_pk_id': 41}}}}

  复制代码

实现版本2

1. #!/usr/bin/env python
2. # -*- coding:utf-8 -*-
4. import uuid
5. import logging
6. from odoo import models, fields, api
7. from odoo.exceptions import UserError, ValidationError, MissingError
9. _logger = logging.getLogger(__name__)
11. class DemoWizard(models.TransientModel):
12.     _name = 'demo.wizard'
13.     _description = 'demo wizard'
15.     property_id = fields.Many2one('estate.property', string='property')
16.     property_pk_id = fields.Integer(related='property_id.id') # 用于action_confirm中获取property
17.     offer_ids = fields.One2many(related='property_id.offer_ids')
19.     @api.model
20.     def action_confirm(self, data:dict):
21.         '''选中记录后，点击确认按钮，执行的操作'''
23.         #### 根据需要对获取的数据做相应处理
24.         record_ids = []
25.         for id, value_dict in data.items():
26.             record_ids.append(value_dict.get('data', {}).get('id'))
27.         if not record_ids:
28.             raise UserError('请选择记录')
29.             
30.         property_pk_id = None
31.         for id, value_dict in data.items():
32.             property_pk_id = value_dict.get('context', {}).get('property_pk_id')
33.             break
35.         if not property_pk_id:
36.             raise ValidationError('do something fail')
37.             
38.         property = self.env['estate.property'].browse([property_pk_id]) # 注意，，所以，这里不能再通过self.property_id获取了
39.         if property.exists():
40.             property.action_do_something(record_ids)
41.         else:
42.             raise MissingError('do something fail：当前property记录(id=%s)不存在' % property_pk_id)
43.         return True
45.    
46.     @api.model
47.     def default_get(self, fields_list):
48.         '''获取wizard 窗口界面默认值，包括记录列表'''
50.         res = super(DemoWizard, self).default_get(fields_list)
51.         record_ids = self.env.context.get('active_ids')
52.         
53.         property = self.env['estate.property'].browse(record_ids)
54.         res['property_id'] = property.id
55.         res['property_pk_id'] = property.id
57.         offer_ids = property.offer_ids.mapped('id')
58.         res['offer_ids'] = [(6, 0, offer_ids)]
59.         return res

复制代码

odoo14\custom\estate\wizards\__init__.py

1. #!/usr/bin/env python
2. # -*- coding:utf-8 -*-
4. from . import demo_wizard

复制代码

odoo14\custom\estate\__init__.py

1. #!/usr/bin/env python
2. # -*- coding:utf-8 -*-
4. from . import models
5. from . import wizards

复制代码

odoo14\custom\estate\wizards\demo_wizard_views.xml

实现版本1

对应demo_wizard.py实现版本1

1. <?xml version="1.0" encoding="UTF-8"?>
2. <odoo>
3.     <data>
4.         <record id="demo_wizard_view_form" model="ir.ui.view">
5.             <field name="name">demo.wizard.form</field>
6.             <field name="model">demo.wizard</field>
7.             <field name="arch" type="xml">
8.                 <form>
9.                     <field name="offer_ids">
10.                         <tree hasCheckBoxes="true" modelName="demo.wizard" modelMethod="action_select_records_via_checkbox" jsMethodOnModelMethodDone="enableActionConfirmButton()" jsMethodOnToggleCheckbox="disableActionConfirmButton()">
11.                             <field name="price" string="Price"/>
12.                             <field name="partner_id" string="partner ID"/>
13.                             <field name="validity" string="Validity（days）"/>
14.                             <field name="date_deadline" string="Deadline"/>
15.                             <button name="action_accept_offer" string=""  type="object" icon="fa-check" attrs="{'invisible': [('status', 'in', ['Accepted','Refused'])]}"/>
16.                             <button name="action_refuse_offer" string=""  type="object" icon="fa-times" attrs="{'invisible': [('status', 'in', ['Accepted','Refused'])]}"/>
17.                             <field name="status" string="Status"/>
18.                         </tree>
19.                     </field>
20.                     <footer>
21.                         <button name="action_confirm" type="object" string="确认(do something you want)" />
22.                         <button string="取消"  special="cancel"/>
23.                     </footer>
24.                 </form>
25.             </field>
26.         </record>
27.         
28.         <record id="action_demo_wizard" model="ir.actions.act_window">
29.             <field name="name">选取offers</field>
30.             <field name="res_model">demo.wizard</field>
31.             <field name="type">ir.actions.act_window</field>
32.             <field name="view_mode">form</field>
33.             <field name="target">new</field>            
34.         </record>
35.     </data>
36. </odoo>

复制代码

说明：

1. [/code]
2. [list]
3. [*]hasCheckBoxes  设置"true"，则显示复选框。以下属性皆在hasCheckBoxes  为"true"的情况下起作用。
4. [*]modelName 点击列表复选框时，需要访问的模型名称，需要配合modelMethod方法使用，缺一不可。可选
5. [*]modelMethod 点击列表复选框时，需要调用的模型方法，通过该方法收集列表勾选记录的数据。可选。
6. [*]jsMethodOnModelMethodDone 定义modelMethod方法执行完成后，需要调用的javascript方法([b]注意，包括参数，如果没有参数则写成()，形如 jsMethod()[/b])。可选。
7. [*]jsMethodOnToggleCheckbox 定义点击列表复选框时需要调用的javascript方法，比modelMethod优先执行([b]注意，包括参数，如果没有参数则写成()，形如 jsMethod()[/b])。可选。
8. [/list]以上参数同下文saveSelectionsToSessionStorage 参数可同时共存
9. 如果需要将action绑定到指定模型指定视图的Action，可以在ir.actions.act_window定义中添加binding_model_id和binding_view_types字段，如下：
10. [code]        <record id="action_demo_wizard" model="ir.actions.act_window">
11.             <field name="name">选取offers</field>
12.             <field name="res_model">demo.wizard</field>
13.             <field name="type">ir.actions.act_window</field>
14.             <field name="view_mode">form</field>
15.             <field name="target">new</field>            
16.             
17.             <field name="binding_model_id" ref="estate.model_estate_property"/>
18.             <field name="binding_view_types">form</field>
19.         </record>

复制代码

效果如下

参考连接：https://www.odoo.com/documentation/14.0/zh_CN/developer/reference/addons/actions.html
实现版本2

对应demo_wizard.py实现版本2

1. <?xml version="1.0" encoding="UTF-8"?>
2. <odoo>
3.     <data>
4.         <record id="demo_wizard_view_form" model="ir.ui.view">
5.             <field name="name">demo.wizard.form</field>
6.             <field name="model">demo.wizard</field>
7.             <field name="arch" type="xml">
8.                 <form>
9.                     <field name="property_pk_id" invisible="1"/>
10.                     <field name="offer_ids" context="{'property_pk_id': property_pk_id}">
11.                         <tree string="List" hasCheckBoxes="true" saveSelectionsToSessionStorage="true">
12.                             <field name="price" string="Price"/>
13.                             <field name="partner_id" string="partner ID"/>
14.                             <field name="validity" string="Validity（days）"/>
15.                             <field name="date_deadline" string="Deadline"/>
16.                             <button name="action_accept_offer" string=""  type="object" icon="fa-check" attrs="{'invisible': [('status', 'in', ['Accepted','Refused'])]}"/>
17.                             <button name="action_refuse_offer" string=""  type="object" icon="fa-times" attrs="{'invisible': [('status', 'in', ['Accepted','Refused'])]}"/>
18.                             <field name="status" string="Status"/>
19.                         </tree>
20.                     </field>
21.                     <footer>
22.                         <button name="action_confirm" onclick="do_confirm_action('demo.wizard','action_confirm')"  string="确认(do something you want)" />
23.                         <button string="取消"  special="cancel"/>
24.                     </footer>
25.                 </form>
26.             </field>
27.         </record>
28.         
29.         <record id="action_demo_wizard" model="ir.actions.act_window">
30.             <field name="name">选取offers</field>
31.             <field name="res_model">demo.wizard</field>
32.             <field name="type">ir.actions.act_window</field>
33.             <field name="view_mode">form</field>
34.             <field name="target">new</field>            
35.         </record>
36.     </data>
37. </odoo>

复制代码

说明：

• saveSelectionsToSessionStorage 为"true"则表示点击复选框时，将当前选取的记录存到浏览器sessionStorage中，可选
  

odoo14\custom\estate\security\ir.model.access.csv

1. id,name,model_id/id,group_id/id,perm_read,perm_write,perm_create,perm_unlink
2. # ...略
3. access_demo_wizard_model,access_demo_wizard_model,model_demo_wizard,base.group_user,1,1,1,1

复制代码

注意：wizard模型也是需要添加模型访问权限配置的
复选框及勾选数据获取实现

大致思路通过继承web.ListRenderer实现自定义ListRenderer，进而实现复选框展示及勾选数据获取。
odoo14\custom\estate\static\src\js\list_renderer.js

注意：之所以将uuid函数定义在list_renderer.js中，是为了避免因为js顺序加载问题，可能导致加载list_renderer.js时找不到uuid函数定义问题。

1. function uuid() {
2.         var s = [];
3.         var hexDigits = "0123456789abcdef";
4.         for (var i = 0; i < 36; i++) {
5.                 s[i] = hexDigits.substr(Math.floor(Math.random() * 0x10), 1);
6.         }
7.         s[14] = "4"; // bits 12-15 of the time_hi_and_version field to 0010
8.         s[19] = hexDigits.substr((s[19] & 0x3) | 0x8, 1); // bits 6-7 of the clock_seq_hi_and_reserved to 01
9.         s[8] = s[13] = s[18] = s[23] = "-";
11.         var uuid = s.join("");
12.         return uuid;
13. }
15. odoo.define('estate.ListRenderer', function (require) {
16.     "use strict";
18.         var ListRenderer = require('web.ListRenderer');
19.         ListRenderer = ListRenderer.extend({
20.             init: function (parent, state, params) {
21.                     this._super.apply(this, arguments);
22.                     this.hasCheckBoxes = false;
23.                         if ('hasCheckBoxes' in params.arch.attrs && params.arch.attrs['hasCheckBoxes']) {
24.                 this.objectID = uuid();
25.                 $(this).attr('id', this.objectID);
27.                             this.hasCheckBoxes = true;
28.                             this.hasSelectors = true;
29.                             this.records = {}; // 存放当前界面记录
30.                             this.recordsSelected = {}; // 存放选取的记录
31.                             this.modelName = undefined; // 定义点击列表复选框时需要访问的模型
32.                             this.modelMethod = undefined; // 定义点击列表复选框时需要调用的模型方法
33.                             this.jsMethodOnModelMethodDone = undefined; // 定义modelMethod方法执行完成后，需要调用的javascript方法
34.                             this.jsMethodOnToggleCheckbox = undefined; // 定义点击列表复选框时需要调用的javascript方法，比modelMethod优先执行
37.                             if ('modelName' in params.arch.attrs && params.arch.attrs['modelName']) {
38.                                 this.modelName = params.arch.attrs['modelName'];
39.                             }
40.                             if ('modelMethod' in params.arch.attrs && params.arch.attrs['modelMethod']) {
41.                                 this.modelMethod = params.arch.attrs['modelMethod'];
42.                             }
43.                             if ('jsMethodOnModelMethodDone' in params.arch.attrs && params.arch.attrs['jsMethodOnModelMethodDone']){
44.                                 this.jsMethodOnModelMethodDone = params.arch.attrs['jsMethodOnModelMethodDone'];
45.                             }
47.                             if ('jsMethodOnToggleCheckbox' in params.arch.attrs && params.arch.attrs['jsMethodOnToggleCheckbox']) {
48.                                 this.jsMethodOnToggleCheckbox = params.arch.attrs['jsMethodOnToggleCheckbox'];
49.                             }
50.                
51.                 if ('saveSelectionsToSessionStorage' in params.arch.attrs && params.arch.attrs['saveSelectionsToSessionStorage']) {
52.                                 this.saveSelectionsToSessionStorage = params.arch.attrs['saveSelectionsToSessionStorage'];
53.                             }
54.             }
55.                 },
56. //                _onToggleSelection: function (ev) {
57.             // 点击列表表头的全选/取消全选复选框时会调用该函数
58. //                    this._super.apply(this, arguments);
59. //        },
60.         _onToggleCheckbox: function (ev) {
61.             if (this.hasCheckBoxes) {
62.                 var classOfEvTarget = $(ev.target).attr('class');
63.                 /* cstom-control-input 刚好点中复选框input,
64.                 custom-control custom-checkbox 刚好点中复选框input的父元素div
65.                 o_list_record_selector 点击到复选框外上述div的父元素*/               
66.                 if (['custom-control custom-checkbox', 'custom-control-input', 'o_list_record_selector'].includes(classOfEvTarget)){
67.                     if (this.jsMethodOnToggleCheckbox) {
68.                         eval(this.jsMethodOnToggleCheckbox)
69.                     }
71.                     var id = $(ev.currentTarget).closest('tr').data('id'); // 'custom-control-input' == classOfEvTarget
72.                     var checked = !this.$(ev.currentTarget).find('input').prop('checked') // 获取复选框是否框选 'custom-control-input' != classOfEvTarget
73.                     if ('custom-control-input' ==  classOfEvTarget) {
74.                         checked = this.$(ev.currentTarget).find('input').prop('checked')
75.                     }
76.                     
77.                     if (id == undefined) {
78.                         if (checked == true) { // 全选
79.                             this.recordsSelected = JSON.parse(JSON.stringify(this.records));
80.                         } else { // 取消全选
81.                             this.recordsSelected = {};
82.                         }
83.                     } else {
84.                         if (checked == true) { // 勾选单条记录
85.                             this.recordsSelected[id] = this.records[id];
86.                         } else { // 取消勾选单条记录
87.                             delete this.recordsSelected[id];
88.                         }
89.                     }
91.                     if (this.saveSelectionsToSessionStorage) {
92.                         window.sessionStorage[this.objectID] = JSON.stringify(this.recordsSelected);
93.                     }
94.                     
95.                     // 通过rpc请求模型方法，用于传输界面勾选的记录数据
96.                     if (this.modelName && this.modelMethod) {
97.                         self = this;
98.                         this._rpc({
99.                                 model: this.modelName,
100.                                 method: this.modelMethod,
101.                                 args: [this.recordsSelected],
102.                             }).then(function (res) {
103.                                 if (self.jsMethodOnModelMethodDone) {
104.                                     eval(self.jsMethodOnModelMethodDone);
105.                                 }
106.                             });
107.                     }
108.                 }
109.             }
111.             this._super.apply(this, arguments);
113.         },
114.         _renderRow: function (record) {
115.             // 打开列表页时会渲染行，此时存储渲染的记录
116.             if (this.hasCheckBoxes) {
117.                 this.records[record.id] = {'data': record.data, 'context': record.context};
118.             }
119.             return this._super.apply(this, arguments);
120.         }
122.         });
124. odoo.__DEBUG__['services']['web.ListRenderer'] = ListRenderer; //覆盖原有的ListRender服务
125. });

复制代码

实践过程中，有尝试过以下实现方案，视图通过指定相同服务ID web.ListRenderer来覆盖框架自带的web.ListRenderer定义，这种实现方案只能在非Debug模式下正常工作，且会导致无法开启Debug模式，odoo.define实现中会对服务是否重复定义做判断，如果重复定义则会抛出JavaScript异常。

1. odoo.define('web.ListRenderer', function (require) {
2.     "use strict";
3.     //...略，同上述代码
4.     // odoo.__DEBUG__['services']['web.ListRenderer'] = ListRenderer;
5.     return ListRenderer;
6. });

复制代码

笔者后面发现，可以使用include替代extend方法修改现有的web.ListRenderer，如下

1. odoo.define('estate.ListRenderer', function (require) {
2.     "use strict";
4.         var ListRenderer = require('web.ListRenderer');
5.         ListRenderer = ListRenderer.include({//...略，同上述代码});
6.    
7.     // odoo.__DEBUG__['services']['web.ListRenderer'] = ListRenderer;  //不需要添加这行代码了
8. });

复制代码

odoo14\custom\estate\static\src\js\demo_wizard_views.js

实现版本1

供demo_wizard_views.xml实现版本1使用

1. function disableActionConfirmButton(){ // 禁用按钮
2.     $("button[name='action_confirm']").attr("disabled", true);
3. }
5. function enableActionConfirmButton(){ // 启用按钮
6.     $("button[name='action_confirm']").attr("disabled", false);
7. }

复制代码

这里的设计是，执行复选框操作时，先禁用按钮，不允许执行确认操作，因为执行复选框触发的请求可能没那么快执行完成，前端数据可能没完全传递给后端，此时去执行操作，可能会导致预期之外的结果。所以，等请求完成再启用按钮。
实现版本2

供demo_wizard_views.xml实现版本2使用

1. function do_confirm_action(modelName, modelMethod, context){
2.     $("button[name='action_confirm']").attr("disabled", true); // 点击按钮后，禁用按钮状态，比较重复点击导致重复发送请求   
3.     var wizard_dialog = $(event.currentTarget.offsetParent.parentElement.parentElement);
4.     var dataUUID = $(event.currentTarget.parentElement.parentElement.parentElement.parentElement).find('div.o_list_view').prop('id');
5.     var rpc = odoo.__DEBUG__.services['web.rpc'];
6.     rpc.query({
7.         model: modelName,
8.         method: modelMethod,
9.         args: [JSON.parse(window.sessionStorage.getItem(dataUUID) || '{}')]
10.     }).then(function (res)         if (res == true) {
11.             wizard_dialog.css('display', 'none'); // 隐藏对话框
12.             window.sessionStorage.removeItem(dataUUID);
13.         } else {
14.             $("button[name='action_confirm']").attr("disabled", false);
15.         }
16.     }).catch(function (err) {
17.         $("button[name='action_confirm']").attr("disabled", false);
18.     });
19. }

复制代码

odoo14\odoo\addons\base\rng\tree_view.rng

可选操作。如果希望hasCheckBoxes，modelName，modelMethod等也可作用于非内联tree视图，则需要编辑该文件，添加hasCheckBoxes，modelName，modelMethod等属性，否则，更新应用的时候会报错。
[code]