Prérequis

• Module odooskills_helpdesk v19.0.1.6.0 de T14 installé.
• Les bases ORM : modèles (T08), champs (T10), contraintes (T12).
• Avoir déjà utilisé super() en Python.

2. Surcharger create avec @api.model_create_multi

Historiquement, create() recevait un seul dictionnaire. Depuis Odoo 13+, la forme batch est recommandée, et en Odoo 19 c'est la seule forme acceptée pour une nouvelle surcharge : create(vals_list) — une liste de dicts.

from odoo import api, models, fields


class HelpdeskTicket(models.Model):
    _inherit = 'helpdesk.ticket'

    @api.model_create_multi
    def create(self, vals_list):
        """Génère automatiquement une référence si absente."""
        for vals in vals_list:
            if not vals.get('reference'):
                vals['reference'] = self.env['ir.sequence'].sudo().next_by_code(
                    'helpdesk.ticket'
                ) or '/'
        tickets = super().create(vals_list)
        for ticket in tickets:
            ticket.message_post(body=f"Ticket créé — {ticket.reference}")
        return tickets

Points clés :

• Décorateur obligatoire — sans @api.model_create_multi, Odoo émet un deprecation warning à l'install et refuse carrément la classe dans certains cas.
• Signature (self, vals_list) — self est vide ici, vals_list est une liste de dicts, une par record à créer.
• super().create(vals_list) — passe la main à l'ORM qui retourne le recordset des tickets créés (plusieurs d'un coup si batch).
• sudo() sur ir.sequence — un utilisateur lambda n'a pas accès en écriture aux séquences. C'est l'un des rares cas légitimes de sudo().

4. write : figer un état final

Pattern très fréquent : un ticket résolu ne doit plus être modifié — sauf la note de résolution et les tags. On surcharge write :

from odoo.exceptions import ValidationError


class HelpdeskTicket(models.Model):
    _inherit = 'helpdesk.ticket'

    _EDITABLE_WHEN_DONE = {'resolution_note', 'tag_ids', 'message_follower_ids'}

    def write(self, vals):
        protected = set(vals) - self._EDITABLE_WHEN_DONE
        if protected:
            for ticket in self:
                if ticket.state == 'done':
                    raise ValidationError(
                        f"Ticket {ticket.reference} résolu : seuls "
                        f"{', '.join(sorted(self._EDITABLE_WHEN_DONE))} "
                        "restent modifiables."
                    )
        if vals.get('state') == 'done':
            vals.setdefault('resolved_at', fields.Datetime.now())
        return super().write(vals)

Observations :

• Signature (self, vals) — un seul dict, pas une liste. La forme batch n'existe pas pour write : self est déjà un recordset de N éléments, vals s'applique à chacun.
• Boucle for ticket in self — nécessaire car les records du recordset peuvent être dans des états différents.
• Whitelist plutôt que blacklist — on liste les champs autorisés, pas les interdits. Safer (un nouveau champ est protégé par défaut).
• vals.setdefault plutôt que vals[...] = ... — si l'appelant fournit déjà resolved_at, on respecte sa valeur.

6. Les décorateurs @api à connaître

Upgrade du module et test rapide

./odoo-bin -c config/odoo.conf -u odooskills_helpdesk -d ta_base --stop-after-init

# Dans un shell Odoo : créer un ticket — la référence doit être auto-générée
./odoo-bin shell -c config/odoo.conf -d ta_base
>>> t = env['helpdesk.ticket'].create({'name': 'Test T15'})
>>> t.reference            # → 'HLP/2026/00001'
>>> t.message_ids.mapped('body')   # → ['Ticket créé — HLP/2026/00001']
>>> t.action_start()
>>> t.state                # → 'in_progress'
>>> t.action_resolve()
>>> t.resolved_at          # → datetime auto-rempli par write()
>>> t.unlink()             # → ValidationError : état 'done'

Voir aussi dans cette série