Paramètres communs à tous les champs

Avant de détailler chaque type, voici les paramètres que tu rencontreras sur n'importe quel champ Odoo :

name = fields.Char(
    string='Libellé affiché',   # Label dans les vues (défaut : nom de l'attribut)
    required=True,               # Champ obligatoire (NOT NULL côté ORM)
    readonly=True,               # Non modifiable par l'utilisateur
    copy=False,                  # Exclu lors du duplicate d'un record
    default='valeur',            # Valeur par défaut (scalaire ou callable)
    index=True,                  # Crée un index PG (btree) sur la colonne
    tracking=True,               # Trace les changements dans le chatter mail
    help='Texte d\'aide tooltip', # Tooltip dans les formulaires
)

2. Text et Html — texte long

Les deux sont stockés en TEXT PostgreSQL, mais l'interface les traite différemment :

• Text → textarea simple, pas de formatage
• Html → éditeur WYSIWYG Odoo (Quill/OWL) avec gras, listes, liens…

# Texte brut — note de résolution sans mise en forme
resolution_note = fields.Text(string='Note de résolution')

# HTML riche — corps du ticket avec formatage
body_html = fields.Html(string='Corps HTML', sanitize=True)

4. Monetary — montant en devise

Monetary est un Float enrichi : il connaît sa devise et formate l'affichage (1 500,00 €). En base, c'est un NUMERIC, mais Odoo utilise la précision définie par la devise (ex. 2 décimales pour EUR).

# Le montant — lié à la devise via currency_field
estimated_cost = fields.Monetary(
    string='Coût estimé',
    currency_field='currency_id',   # NOM de l'attribut Python, pas le champ PG
)

# Le Many2one devise — obligatoire pour Monetary
currency_id = fields.Many2one(
    comodel_name='res.currency',
    string='Devise',
    default=lambda self: self.env.company.currency_id,
)

Le default lambda récupère la devise de la société courante au moment de la création du record. Si tu travailles en multi-sociétés, l'utilisateur peut changer la devise manuellement dans le formulaire.

6. Date et Datetime

La distinction principale : Date stocke juste le jour (YYYY-MM-DD), Datetime stocke date + heure.

# Date : uniquement YYYY-MM-DD, pas de fuseau horaire
deadline = fields.Date(string='Échéance', tracking=True)

# Datetime : date + heure UTC en base
# Odoo convertit automatiquement vers le fuseau de l'utilisateur à l'affichage
resolved_at = fields.Datetime(string='Résolu le', readonly=True)

from odoo import fields

# Bonne pratique : utiliser fields.Datetime.now() côté serveur
self.resolved_at = fields.Datetime.now()   # retourne datetime UTC

# Comparer avec une date du jour
today = fields.Date.today()                # retourne date YYYY-MM-DD

Exemple pratique : marquer un ticket comme résolu

def action_close(self):
    """Passe le ticket en 'done' et enregistre la date/heure de résolution."""
    self.write({
        'state': 'done',
        'resolved_at': fields.Datetime.now(),
    })

Mise en pratique — helpdesk_ticket.py complet

Voici le fichier complet après T10, version 19.0.1.2.0 :

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.",
    )

    # ── Champs de base (T08/T09) ──────────────────────────────────────────────
    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')
    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,
    )

    # ── Champs non-relationnels (T10) ─────────────────────────────────────────

    deadline = fields.Date(string='Échéance', tracking=True)
    resolved_at = fields.Datetime(string='Résolu le', readonly=True)
    hours_spent = fields.Float(string='Heures passées', digits=(6, 2))
    incident_count = fields.Integer(string='Nb incidents liés', default=0)
    is_urgent = fields.Boolean(string='Urgent', default=False, tracking=True)

    channel = fields.Selection(
        selection=[
            ('email', 'Email'),
            ('phone', 'Téléphone'),
            ('portal', 'Portail'),
            ('chat', 'Chat'),
        ],
        string='Canal',
        tracking=True,
    )

    resolution_note = fields.Text(string='Note de résolution')
    body_html = fields.Html(string='Corps HTML', sanitize=True)
    screenshot = fields.Binary(string="Capture d'écran", attachment=True)
    avatar = fields.Image(string='Avatar', max_width=256, max_height=256)

    estimated_cost = fields.Monetary(
        string='Coût estimé',
        currency_field='currency_id',
    )
    currency_id = fields.Many2one(
        comodel_name='res.currency',
        string='Devise',
        default=lambda self: self.env.company.currency_id,
    )

Récapitulatif — choisir le bon type