Prérequis

• Module odooskills_helpdesk v19.0.1.13.0 (T21).
• Module base_automation installé (natif, mais pas toujours présent : l'ajouter dans depends).
• Méthodes Python métier sur helpdesk.ticket (T15).

2. ir.actions.server — le bouton métier

Le pattern type : une méthode Python métier bien isolée, et une action serveur minimaliste qui l'appelle.

# models/helpdesk_ticket.py
def action_escalate_sla(self):
    """Escalade : bascule en priorité Urgente et poste un message.

    Appelable depuis une ir.actions.server (manuel) ou un ir.cron (batch).
    Idempotent : ignore les tickets déjà urgents ou résolus.
    """
    escalated = self.filtered(lambda t: t.state != 'done' and t.priority != '3')
    if not escalated:
        return False
    escalated.write({'priority': '3'})
    for ticket in escalated:
        ticket.message_post(
            body="⚠️ <strong>Escalade SLA automatique</strong> — priorité Urgente"
        )
    return True

Puis l'action serveur XML :

<record id="server_action_escalate_sla" model="ir.actions.server">
    <field name="name">Escalader en priorité Urgente</field>
    <field name="model_id" ref="model_helpdesk_ticket"/>
    <field name="binding_model_id" ref="model_helpdesk_ticket"/>
    <field name="binding_view_types">form,list</field>
    <field name="state">code</field>
    <field name="code">
if records:
    records.action_escalate_sla()
    </field>
</record>

Champs clés :

4. ir.cron — la tâche planifiée

On ajoute au modèle une méthode _cron_escalate_sla qui bouclera sur les tickets à risque :

@api.model
def _cron_escalate_sla(self):
    """Cron : escalade les tickets dont l'échéance est dans les 24h."""
    from datetime import timedelta
    threshold = fields.Date.today() + timedelta(days=1)
    tickets = self.search([
        ('state', '!=', 'done'),
        ('priority', '!=', '3'),
        ('deadline', '!=', False),
        ('deadline', '<=', threshold),
    ])
    if tickets:
        tickets.action_escalate_sla()
    return len(tickets)

Puis le cron XML :

<record id="ir_cron_escalate_sla" model="ir.cron">
    <field name="cron_name">Helpdesk — Escalade SLA automatique</field>
    <field name="name">Helpdesk — Escalade SLA automatique</field>
    <field name="model_id" ref="model_helpdesk_ticket"/>
    <field name="state">code</field>
    <field name="code">model._cron_escalate_sla()</field>
    <field name="interval_number">30</field>
    <field name="interval_type">minutes</field>
    <field name="active" eval="True"/>
</record>

Intervalles disponibles

interval_type ∈ {minutes, hours, days, weeks, months}. Jamais seconds — Odoo n'est pas un moteur temps réel.

Exécuter le cron maintenant pour tester

# Depuis un shell Odoo
./odoo-bin shell -c config/odoo.conf -d ma_db

# Python interactif
>>> env['helpdesk.ticket']._cron_escalate_sla()
2
>>> env.cr.commit()

Ou via l'UI, bouton Exécuter manuellement en haut de la form cron. Très utile en dev pour itérer sans attendre 30 min.

6. Bonnes pratiques

Idempotence

Un cron ou une automation peut tourner 10 fois avant que tu t'en aperçoives. Écris toujours ton code comme s'il allait s'exécuter N fois sans effet de bord. Exemple : records.filtered(lambda t: t.priority != '3') avant d'écrire priority='3'.

Logique métier dans le modèle, pas dans le XML

Garde le code XML court (1 à 3 lignes) et pointe vers une méthode .py. Raisons :

• Testable avec TransactionCase.
• Lintable par ton IDE.
• Réutilisable depuis plusieurs déclencheurs.
• Git diff propre.

Manifest — dépendance à base_automation

# __manifest__.py
'depends': ['base', 'mail', 'base_automation'],
'data': [
    # ...
    'data/automation.xml',
    # ...
],

Le module base_automation n'est pas dans base — il faut l'inclure explicitement si tu utilises base.automation. Omettre cette dépendance = crash à l'install : External ID not found: model_base_automation.

Runner cron en développement

Odoo démarre un cron runner interne dès qu'un worker est disponible. En mode "serveur simple" (sans --workers), les crons tournent dans le même process que HTTP — latence jusqu'à une minute. En prod, préférer au moins --workers=2 pour un worker cron dédié.

Voir aussi dans cette série