1. Many2one — clé étrangère

C'est la relation la plus courante. Un ticket est assigné à un seul utilisateur. Côté PostgreSQL, c'est une simple colonne INTEGER (l'id du record lié) avec une contrainte FOREIGN KEY.

user_id = fields.Many2one(
    comodel_name='res.users',   # modèle cible — OBLIGATOIRE
    string='Assigné à',
    tracking=True,
    ondelete='set null',        # comportement si l'utilisateur est supprimé
    index=True,                 # FK souvent filtrée → index recommandé
)

Le paramètre ondelete

Il définit ce qu'Odoo fait au record parent quand le record lié est supprimé :

Le paramètre domain

Filtre les valeurs proposées dans le widget Many2one des vues :

# N'affiche que les utilisateurs internes (pas les portails/public)
user_id = fields.Many2one(
    comodel_name='res.users',
    string='Assigné à',
    domain=[('share', '=', False)],
    ondelete='set null',
)

3. Many2many — table de liaison

Un ticket peut avoir plusieurs tags ; un tag peut être sur plusieurs tickets. Ni le ticket ni le tag ne porte de FK — Odoo crée automatiquement une table de liaison avec les deux FK.

Le modèle tag

# helpdesk_ticket_tag.py
class HelpdeskTicketTag(models.Model):
    _name = 'helpdesk.ticket.tag'
    _description = 'Tag de ticket helpdesk'
    _order = 'name'

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

Le champ Many2many sur le ticket

# Dans helpdesk_ticket.py
tag_ids = fields.Many2many(
    comodel_name='helpdesk.ticket.tag',
    string='Tags',
)
# → Odoo crée automatiquement la table : helpdesk_ticket_helpdesk_ticket_tag_rel
# avec deux colonnes : helpdesk_ticket_id  et  helpdesk_ticket_tag_id

Nommer la table de liaison manuellement

Par défaut Odoo génère un nom à partir des deux modèles. Si le nom généré dépasse 63 caractères (limite PG) ou si tu veux le contrôler :

tag_ids = fields.Many2many(
    comodel_name='helpdesk.ticket.tag',
    relation='helpdesk_ticket_tag_rel',  # nom exact de la table de liaison
    column1='ticket_id',                 # colonne FK vers le modèle courant
    column2='tag_id',                    # colonne FK vers le modèle cible
    string='Tags',
)

Many2many dans les deux sens

On peut aussi exposer la relation depuis le modèle tag pour voir quels tickets ont ce tag :

# Dans helpdesk_ticket_tag.py — la même table de liaison, sens inverse
ticket_ids = fields.Many2many(
    comodel_name='helpdesk.ticket',
    relation='helpdesk_ticket_helpdesk_ticket_tag_rel',  # même table !
    column1='helpdesk_ticket_tag_id',
    column2='helpdesk_ticket_id',
    string='Tickets',
)

Lire et écrire des champs relationnels en ORM

Lire

ticket = self.env['helpdesk.ticket'].browse(1)

# Many2one → retourne un recordset (1 record ou vide)
print(ticket.user_id.name)       # "Alice Dupont"
print(ticket.category_id.id)     # 3

# One2many → retourne un recordset (0..N records)
for comment in ticket.comment_ids:
    print(comment.body)

# Many2many → retourne un recordset (0..N records)
for tag in ticket.tag_ids:
    print(tag.name)

Écrire — commandes spéciales M2m / O2m

Pour écrire dans des champs One2many ou Many2many, Odoo utilise des commandes numériques :

ticket.write({
    # Many2one : passer l'id directement
    'user_id': 5,

    # Many2many : commandes de liaison
    'tag_ids': [
        (4, tag_id),      # (4, id) → ajouter un lien existant
        (3, tag_id),      # (3, id) → supprimer un lien (sans supprimer le record)
        (5, 0, 0),        # (5) → vider tous les liens
        (6, 0, [1, 2]),   # (6, 0, ids) → remplacer par cette liste exacte
    ],

    # One2many : commandes de création/modification/suppression
    'comment_ids': [
        (0, 0, {'body': 'Nouveau commentaire'}),   # (0) → créer
        (1, comment_id, {'body': 'Modifié'}),       # (1, id) → modifier
        (2, comment_id, 0),                         # (2, id) → supprimer
    ],
})

Upgrade du module

On passe en 19.0.1.3.0. Après le -u, Odoo crée :

• La table helpdesk_ticket_tag
• La table helpdesk_ticket_comment avec sa FK ticket_id
• La table de liaison helpdesk_ticket_helpdesk_ticket_tag_rel
• Les colonnes user_id sur helpdesk_ticket

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

# Vérifier les nouvelles tables
# psql -d ta_base -c "\dt helpdesk*"