1 — models.Model : le modèle persistant

C'est la classe que tu utiliseras dans 90% des cas. Elle crée une table PostgreSQL dédiée et chaque instance (un "record") est stockée durablement en base.

Caractéristiques

• Une table PostgreSQL est créée automatiquement à l'installation du module
• Les records persistent — ils survivent au redémarrage du serveur
• Toutes les fonctionnalités Odoo sont disponibles : vues, recherche, ACL, ORM

Exemple — le ticket helpdesk

On crée notre premier modèle dans models/helpdesk_ticket.py :

from odoo import models, fields


class HelpdeskTicket(models.Model):
    """Ticket de support — modèle persistant."""
    _name = 'helpdesk.ticket'
    _description = 'Ticket Helpdesk'
    _inherit = ['mail.thread', 'mail.activity.mixin', 'odooskills.helpdesk.mixin']

    name = fields.Char(string='Sujet', required=True, tracking=True)
    description = fields.Text(string='Description')
    category_id = fields.Many2one(
        comodel_name='helpdesk.ticket.category',
        string='Catégorie',
        ondelete='restrict',
    )
    partner_id = fields.Many2one('res.partner', string='Client')
    state = fields.Selection(
        selection=[
            ('new', 'Nouveau'),
            ('in_progress', 'En cours'),
            ('done', 'Résolu'),
        ],
        default='new',
        required=True,
        tracking=True,
    )

Et un modèle compagnon pour les catégories dans models/helpdesk_ticket_category.py :

from odoo import models, fields


class HelpdeskTicketCategory(models.Model):
    """Catégorie de ticket — modèle persistant simple."""
    _name = 'helpdesk.ticket.category'
    _description = 'Catégorie de ticket helpdesk'

    name = fields.Char(string='Nom', required=True)
    color = fields.Integer(string='Couleur')

3 — models.AbstractModel : le mixin réutilisable

Un AbstractModel n'a aucune table en base. Il sert uniquement à partager du code — champs et méthodes — entre plusieurs modèles qui l'héritent.

Caractéristiques

• Pas de table PostgreSQL (pas de records non plus)
• Les modèles qui l'héritent reçoivent ses champs et ses méthodes
• Très utilisé dans Odoo : mail.thread, mail.activity.mixin, portal.mixin... sont tous des AbstractModel

Exemple — mixin helpdesk

On veut ajouter des champs communs (active, priority) à plusieurs modèles helpdesk sans dupliquer le code. Un mixin est parfait :

from odoo import models, fields


class HelpdeskMixin(models.AbstractModel):
    """Mixin réutilisable : pas de table en base, uniquement des
    champs et méthodes injectés dans les modèles qui l'héritent."""
    _name = 'odooskills.helpdesk.mixin'
    _description = 'Mixin helpdesk — champs communs'

    active = fields.Boolean(default=True)
    priority = fields.Selection(
        selection=[
            ('0', 'Normale'),
            ('1', 'Haute'),
            ('2', 'Urgente'),
        ],
        default='0',
    )

Dans helpdesk.ticket, on l'ajoute à _inherit :

class HelpdeskTicket(models.Model):
    _name = 'helpdesk.ticket'
    _inherit = ['mail.thread', 'mail.activity.mixin', 'odooskills.helpdesk.mixin']
    # ticket hérite automatiquement des champs active et priority

5 — Manifest et droits d'accès

Le fichier __manifest__.py déclare le module et ses dépendances :

{
    'name': 'OdooSkills Helpdesk',
    'version': '19.0.1.0.0',
    'category': 'Services/Helpdesk',
    'summary': 'Module fil rouge du blog OdooSkills — tickets de support',
    'author': 'OdooSkills',
    'license': 'LGPL-3',
    'depends': ['base', 'mail'],
    'data': [
        'security/ir.model.access.csv',
    ],
    'installable': True,
    'application': True,
}

Tout modèle Model ou TransientModel doit avoir au moins une règle d'accès dans security/ir.model.access.csv. Sans ça, Odoo refuse les opérations et log des warnings à l'installation :

id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
access_helpdesk_ticket_user,helpdesk.ticket.user,model_helpdesk_ticket,base.group_user,1,1,1,1
access_helpdesk_ticket_category_user,helpdesk.ticket.category.user,model_helpdesk_ticket_category,base.group_user,1,1,1,1
access_helpdesk_ticket_close_wizard_user,helpdesk.ticket.close.wizard.user,model_helpdesk_ticket_close_wizard,base.group_user,1,1,1,1

Pour aller plus loin

• Article suivant (T09) — Les attributs de modèles : _order, _rec_name, _sql_constraints, _check_company_auto et leurs usages avancés
• Code source du module — disponible sur le dépôt GitHub d'OdooSkills, chaque article correspond à un commit
• Ressources officielles :
  • Documentation ORM Odoo 19
  • Tutoriels développeur Odoo 19