Odoo ir actions 分析

源代码位置：openerp/addons/base/ir/ir_actions.py

根类型:ir.actions.actions

 class actions(osv.osv):
     _name = 'ir.actions.actions'
     _table = 'ir_actions'
     _order = 'name'
     _columns = {
         'name': fields.char('Name', required=True),
         'type': fields.char('Action Type', required=True),
         'usage': fields.char('Action Usage'),
         'help': fields.text('Action description',
             help='Optional help text for the users with a description of the target view, such as its usage and purpose.',
             translate=True),
     }

继承自ir.actions.actions 的类型有：ir.actions.report.xml，ir.actions.act_window，ir.actions.act_window_close，ir.actions.act_url，ir.actions.server，ir.actions.client　6种

1 .ir.actions.report.xml :用于打印报表的动作　在定义中可知，8.0中支持的报表类型有以下几种：

 'report_type': fields.selection([('qweb-pdf', 'PDF'),
                     ('qweb-html', 'HTML'),
                     ('controller', 'Controller'),
                     ('pdf', 'RML pdf (deprecated)'),
                     ('sxw', 'RML sxw (deprecated)'),
                     ('webkit', 'Webkit (deprecated)'),
                     ],

2.ir.actions.act_window:用于展现页面的动作　

 'name': fields.char('Action Name', required=True, translate=True),
         'type': fields.char('Action Type', required=True),
         'view_id': fields.many2one('ir.ui.view', 'View Ref.', ondelete='set null'),
         'domain': fields.char('Domain Value',
             help="Optional domain filtering of the destination data, as a Python expression"),
         'context': fields.char('Context Value', required=True,
             help="Context dictionary as Python expression, empty by default (Default: {})"),
         'res_id': fields.integer('Record ID', help="Database ID of record to open in form view, when ``view_mode`` is set to 'form' only"),
         'res_model': fields.char('Destination Model', required=True,
             help="Model name of the object to open in the view window"),
         'src_model': fields.char('Source Model',
             help="Optional model name of the objects on which this action should be visible"),
         'target': fields.selection([('current','Current Window'),('new','New Window'),('inline','Inline Edit'),('inlineview','Inline View')], 'Target Window'),
         'view_mode': fields.char('View Mode', required=True,
             help="Comma-separated list of allowed view modes, such as 'form', 'tree', 'calendar', etc. (Default: tree,form)"),
         'view_type': fields.selection((('tree','Tree'),('form','Form')), string='View Type', required=True,
             help="View type: Tree type to use for the tree view, set to 'tree' for a hierarchical tree view, or 'form' for a regular list view"),
         'usage': fields.char('Action Usage',
             help="Used to filter menu and home actions from the user form."),
         'view_ids': fields.one2many('ir.actions.act_window.view', 'act_window_id', 'Views'),
         'views': fields.function(_views_get_fnc, type='binary', string='Views',
                help="This function field computes the ordered list of views that should be enabled " \
                     "when displaying the result of an action, federating view mode, views and " \
                     "reference view. The result is returned as an ordered list of pairs (view_id,view_mode)."),
         'limit': fields.integer('Limit', help='Default limit for the list view'),
         'auto_refresh': fields.integer('Auto-Refresh',
             help='Add an auto-refresh on the view'),
         'groups_id': fields.many2many('res.groups', 'ir_act_window_group_rel',
             'act_id', 'gid', 'Groups'),
         'search_view_id': fields.many2one('ir.ui.view', 'Search View Ref.'),
         'filter': fields.boolean('Filter'),
         'auto_search':fields.boolean('Auto Search'),
         'search_view' : fields.function(_search_view, type='text', string='Search View'),
         'multi': fields.boolean('Restrict to lists', help="If checked and the action is bound to a model, it will only appear in the More menu on list views"),
     }

比较重要的列：

target:current(在当前页面显示),new(在新页面中显示，即弹窗方式),inline(内嵌),inlineview(内嵌视图)．

view_mode:视图模式　可选值:tree,form,graph,calendar,gantt,kanban

view_type:视图类型　可选值:tree,form tree是指分层的树形视图，form是传统的列表类型

view_ids:指定绑定的视图id

limit:指定默认列表视图的显示行数

multi：True　如果绑定了model，将只在列表视图的more按钮列表中显示．

3.ir.actions.act_window_close

关闭窗口的动作

4.ir.actions.act_url

 _name = 'ir.actions.act_url'
     _table = 'ir_act_url'
     _inherit = 'ir.actions.actions'
     _sequence = 'ir_actions_id_seq'
     _order = 'name'
     _columns = {
         'name': fields.char('Action Name', required=True, translate=True),
         'type': fields.char('Action Type', required=True),
         'url': fields.text('Action URL',required=True),
         'target': fields.selection((
             ('new', 'New Window'),
             ('self', 'This Window')),
             'Action Target', required=True
         )
     }
     _defaults = {
         'type': 'ir.actions.act_url',
         'target': 'new'
     }

暂不清楚，还没遇见过，应该是指定URL跳转之类的动作

5.ir.actions.server

执行服务器动作：可用的动作包括

执行python代码块,触发工作流,执行客户端动作,创建并复制一条新记录，修改记录，执行多个服务器动作等．

可以利用ir.actions.server在视图的more加入自定义按钮．

  'name': fields.char('Action Name', required=True, translate=True),
         'condition': fields.char('Condition',
                                  help="Condition verified before executing the server action. If it "
                                  "is not verified, the action will not be executed. The condition is "
                                  "a Python expression, like 'object.list_price > 5000'. A void "
                                  "condition is considered as always True. Help about python expression "
                                  "is given in the help tab."),
         'state': fields.selection(_get_states_wrapper, 'Action To Do', required=True,
                                   help="Type of server action. The following values are available:\n"
                                   "- 'Execute Python Code': a block of python code that will be executed\n"
                                   "- 'Trigger a Workflow Signal': send a signal to a workflow\n"
                                   "- 'Run a Client Action': choose a client action to launch\n"
                                   "- 'Create or Copy a new Record': create a new record with new values, or copy an existing record in your database\n"
                                   "- 'Write on a Record': update the values of a record\n"
                                   "- 'Execute several actions': define an action that triggers several other server actions\n"
                                   "- 'Send Email': automatically send an email (available in email_template)"),
         'usage': fields.char('Action Usage'),
         'type': fields.char('Action Type', required=True),
         # Generic
         'sequence': fields.integer('Sequence',
                                    help="When dealing with multiple actions, the execution order is "
                                    "based on the sequence. Low number means high priority."),
         'model_id': fields.many2one('ir.model', 'Base Model', required=True, ondelete='cascade',
                                     help="Base model on which the server action runs."),
         'model_name': fields.related('model_id', 'model', type='char',
                                      string='Model Name', readonly=True),
         'menu_ir_values_id': fields.many2one('ir.values', 'More Menu entry', readonly=True,
                                              help='More menu entry.', copy=False),
         # Client Action
         'action_id': fields.many2one('ir.actions.actions', 'Client Action',
                                      help="Select the client action that has to be executed."),
         # Python code
         'code': fields.text('Python Code',
                             help="Write Python code that the action will execute. Some variables are "
                             "available for use; help about pyhon expression is given in the help tab."),
         # Workflow signal
         'use_relational_model': fields.selection([('base', 'Use the base model of the action'),
                                                   ('relational', 'Use a relation field on the base model')],
                                                  string='Target Model', required=True),
         'wkf_transition_id': fields.many2one('workflow.transition', string='Signal to Trigger',
                                              help="Select the workflow signal to trigger."),
         'wkf_model_id': fields.many2one('ir.model', 'Target Model',
                                         help="The model that will receive the workflow signal. Note that it should have a workflow associated with it."),
         'wkf_model_name': fields.related('wkf_model_id', 'model', type='char', string='Target Model Name', store=True, readonly=True),
         'wkf_field_id': fields.many2one('ir.model.fields', string='Relation Field',
                                         oldname='trigger_obj_id',
                                         help="The field on the current object that links to the target object record (must be a many2one, or an integer field with the record ID)"),
         # Multi
         'child_ids': fields.many2many('ir.actions.server', 'rel_server_actions',
                                       'server_id', 'action_id',
                                       string='Child Actions',
                                       help='Child server actions that will be executed. Note that the last return returned action value will be used as global return value.'),
         # Create/Copy/Write
         'use_create': fields.selection([('new', 'Create a new record in the Base Model'),
                                         ('new_other', 'Create a new record in another model'),
                                         ('copy_current', 'Copy the current record'),
                                         ('copy_other', 'Choose and copy a record in the database')],
                                        string="Creation Policy", required=True,
                                        help=""),
         'crud_model_id': fields.many2one('ir.model', 'Target Model',
                                          oldname='srcmodel_id',
                                          help="Model for record creation / update. Set this field only to specify a different model than the base model."),
         'crud_model_name': fields.related('crud_model_id', 'model', type='char',
                                           string='Create/Write Target Model Name',
                                           store=True, readonly=True),
         'ref_object': fields.reference('Reference record', selection=_select_objects, size=128,
                                        oldname='copy_object'),
         'link_new_record': fields.boolean('Attach the new record',
                                           help="Check this if you want to link the newly-created record "
                                           "to the current record on which the server action runs."),
         'link_field_id': fields.many2one('ir.model.fields', 'Link using field',
                                          oldname='record_id',
                                          help="Provide the field where the record id is stored after the operations."),
         'use_write': fields.selection([('current', 'Update the current record'),
                                        ('expression', 'Update a record linked to the current record using python'),
                                        ('other', 'Choose and Update a record in the database')],
                                       string='Update Policy', required=True,
                                       help=""),
         'write_expression': fields.char('Expression',
                                         oldname='write_id',
                                         help="Provide an expression that, applied on the current record, gives the field to update."),
         'fields_lines': fields.one2many('ir.server.object.lines', 'server_id',
                                         string='Value Mapping',
                                         copy=True),

         # Fake fields used to implement the placeholder assistant
         'model_object_field': fields.many2one('ir.model.fields', string="Field",
                                               help="Select target field from the related document model.\n"
                                                    "If it is a relationship field you will be able to select "
                                                    "a target field at the destination of the relationship."),
         'sub_object': fields.many2one('ir.model', 'Sub-model', readonly=True,
                                       help="When a relationship field is selected as first field, "
                                            "this field shows the document model the relationship goes to."),
         'sub_model_object_field': fields.many2one('ir.model.fields', 'Sub-field',
                                                   help="When a relationship field is selected as first field, "
                                                        "this field lets you select the target field within the "
                                                        "destination document model (sub-model)."),
         'copyvalue': fields.char('Placeholder Expression', help="Final placeholder expression, to be copy-pasted in the desired template field."),
         # Fake fields used to implement the ID finding assistant
         'id_object': fields.reference('Record', selection=_select_objects, size=128),
         'id_value': fields.char('Record ID'),
     }

6.ir.actions.client

 _columns = {
         'name': fields.char('Action Name', required=True, translate=True),
         'tag': fields.char('Client action tag', required=True,
                            help="An arbitrary string, interpreted by the client"
                                 " according to its own needs and wishes. There "
                                 "is no central tag repository across clients."),
         'res_model': fields.char('Destination Model',
             help="Optional model, mostly used for needactions."),
         'context': fields.char('Context Value', required=True,
             help="Context dictionary as Python expression, empty by default (Default: {})"),
         'params': fields.function(_get_params, fnct_inv=_set_params,
                                   type='binary',
                                   string="Supplementary arguments",
                                   help="Arguments sent to the client along with"
                                        "the view tag"),
         'params_store': fields.binary("Params storage", readonly=True)
     }
     _defaults = {
         'type': 'ir.actions.client',
         'context': '{}',

     }

客户端动作