AgentSkillsCN

Creating Models

循序渐进地指导如何创建包含字段、约束与方法的新 Odoo 模型。

SKILL.md
--- frontmatter
name: Creating Models
description: Step-by-step guide to create a new Odoo model with fields, constraints, and methods.
globs: ["models/**/*.py", "__manifest__.py"]

Creating Odoo Models

Steps

  1. Create the Python file in models/ directory (e.g. models/my_model.py).

  2. Define the model class:

    python
    from odoo import models, fields, api, _
    from odoo.exceptions import ValidationError
    
    class MyModel(models.Model):
        _name = 'my.model'
        _description = 'My Model'
        _order = 'sequence, name'
    
        name = fields.Char(string='Name', required=True)
        sequence = fields.Integer(default=10)
        active = fields.Boolean(default=True)
        state = fields.Selection([
            ('draft', 'Draft'),
            ('confirmed', 'Confirmed'),
            ('done', 'Done'),
        ], default='draft', string='Status', tracking=True)
        partner_id = fields.Many2one('res.partner', string='Partner')
        line_ids = fields.One2many('my.model.line', 'model_id', string='Lines')
        tag_ids = fields.Many2many('my.model.tag', string='Tags')
        total = fields.Float(compute='_compute_total', store=True)
    
        @api.depends('line_ids.amount')
        def _compute_total(self):
            for record in self:
                record.total = sum(record.line_ids.mapped('amount'))
    
        @api.constrains('name')
        def _check_name(self):
            for record in self:
                if record.name and len(record.name) < 3:
                    raise ValidationError(_("Name must be at least 3 characters."))
    
        def action_confirm(self):
            self.write({'state': 'confirmed'})
    
  3. Register in __init__.py: Add from . import my_model in models/__init__.py.

  4. Add to manifest: Ensure models/ is imported in the module's root __init__.py.

  5. Add security: Create ACL in security/ir.model.access.csv.

  6. Create views: Add form and list views in views/my_model_views.xml.

Checklist

  • _name and _description set
  • Fields defined with proper types and attributes
  • Computed fields have @api.depends
  • Constraints use @api.constrains
  • Model registered in __init__.py chain
  • ACL entry in ir.model.access.csv
  • Views created (at minimum form + list)
  • Added to __manifest__.py data list