2 — _rec_name : le champ "nom" du record

Chaque enregistrement Odoo a un nom affiché : c'est ce qui apparaît dans les Many2one (champ relation), dans le breadcrumb et dans la fonction display_name. Par défaut, Odoo cherche un champ name.

Si ton modèle n'a pas de champ name, il faut soit en créer un, soit pointer _rec_name sur un autre champ :

# Cas 1 : champ name standard — _rec_name est implicite
class HelpdeskTicket(models.Model):
    _name = 'helpdesk.ticket'
    _rec_name = 'name'  # par défaut — optionnel d'écrire cette ligne

    name = fields.Char(required=True)


# Cas 2 : pas de champ name, on pointe ailleurs
class HelpdeskTicketHistory(models.Model):
    _name = 'helpdesk.ticket.history'
    _rec_name = 'event_type'

    event_type = fields.Char(required=True)
    ticket_id = fields.Many2one('helpdesk.ticket')

4 — _inherit : hériter de modèles existants

On l'a utilisé sans l'expliquer dans T08. _inherit prend une liste de modèles dont on veut hériter les champs et méthodes. Il existe trois cas d'usage :

Dans notre module, on utilise la forme mixin pour ajouter le chatter, les activités et les champs communs via notre AbstractModel :

class HelpdeskTicket(models.Model):
    _name = 'helpdesk.ticket'
    _inherit = [
        'mail.thread',                      # chatter + messages
        'mail.activity.mixin',              # activités planifiées
        'odooskills.helpdesk.mixin',        # notre mixin custom (active, priority)
    ]

L'article T13 couvrira l'héritage en profondeur (extension de modèles existants, prototypage). Ici, retenir juste la forme mixin.

6 — Mettre à jour le module helpdesk

On applique tous ces attributs à nos deux modèles persistants. Voici les fichiers mis à jour :

models/helpdesk_ticket.py

from odoo import models, fields


class HelpdeskTicket(models.Model):
    _name = 'helpdesk.ticket'
    _description = 'Ticket Helpdesk'
    _inherit = ['mail.thread', 'mail.activity.mixin', 'odooskills.helpdesk.mixin']
    _order = 'priority desc, create_date desc'
    _rec_name = 'name'

    _unique_reference = models.Constraint(
        'UNIQUE (reference)',
        "La référence du ticket doit être unique.",
    )

    name = fields.Char(string='Sujet', required=True, tracking=True)
    reference = fields.Char(string='Référence', copy=False, index=True)
    description = fields.Text(string='Description')
    # ... autres champs inchangés

models/helpdesk_ticket_category.py

from odoo import models, fields


class HelpdeskTicketCategory(models.Model):
    _name = 'helpdesk.ticket.category'
    _description = 'Catégorie de ticket helpdesk'
    _order = 'sequence, name'
    _rec_name = 'name'

    _unique_name = models.Constraint(
        'UNIQUE (name)',
        "Le nom de la catégorie doit être unique.",
    )

    name = fields.Char(string='Nom', required=True)
    sequence = fields.Integer(string='Séquence', default=10)
    color = fields.Integer(string='Couleur')

__manifest__.py

On incrémente la version pour signaler l'évolution :

{
    'name': 'OdooSkills Helpdesk',
    'version': '19.0.1.1.0',    # 1.0.0 → 1.1.0 : attributs + contrainte
    # ... reste inchangé
}

Lancer la mise à jour

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

Puis vérifier les contraintes et le champ reference en base :

psql -d odooskills_helpdesk_test -c "\d helpdesk_ticket" | grep -iE 'reference|unique'
 reference   | character varying |           |          |
   "helpdesk_ticket__reference_index" btree (reference)
   "helpdesk_ticket_unique_reference" UNIQUE CONSTRAINT, btree (reference)

Récapitulatif