Prérequis

• Module odooskills_helpdesk v19.0.1.10.0 (T18).
• Maîtrise des vues form (T16) et de l'héritage de vues (T18).
• Compréhension des actions ir.actions.act_window.

2. Ouvrir le wizard en modal depuis un bouton

Le flux complet en une image :

Deux fichiers à toucher : la méthode qui renvoie l'action, et le bouton qui appelle la méthode.

# models/helpdesk_ticket.py — méthode retournant l'action

def action_open_close_wizard(self):
    """Retourne une action qui ouvre le wizard de clôture."""
    self.ensure_one()
    return {
        'name': 'Clôturer le ticket',
        'type': 'ir.actions.act_window',
        'res_model': 'helpdesk.ticket.close.wizard',
        'view_mode': 'form',
        'target': 'new',   # <-- la clé : modal dialog
        'context': {
            'default_ticket_id': self.id,
            'default_hours_spent': self.hours_spent,
        },
    }

Côté vue form du ticket, on ajoute le bouton dans le <header> :

<header>
    <button name="action_resolve" type="object" string="Résoudre"
            invisible="state != 'in_progress'"/>
    <button name="action_open_close_wizard" type="object"
            string="Clôturer (avec motif)" class="oe_highlight"
            invisible="state == 'done'"/>
    <field name="state" widget="statusbar"/>
</header>

4. La vue du wizard — <footer> et special="cancel"

Une vue form classique, avec deux spécificités : les boutons vont dans un <footer> (pas dans <header>), et le bouton Annuler utilise l'attribut magique special="cancel".

<record id="view_helpdesk_ticket_close_wizard_form" model="ir.ui.view">
    <field name="name">helpdesk.ticket.close.wizard.form</field>
    <field name="model">helpdesk.ticket.close.wizard</field>
    <field name="arch" type="xml">
        <form string="Clôture du ticket">
            <sheet>
                <group>
                    <field name="ticket_id" readonly="1"/>
                    <field name="partner_id"/>
                    <field name="resolution_reason" widget="radio"/>
                    <field name="duplicate_ticket_id"
                           invisible="resolution_reason != 'duplicate'"
                           required="resolution_reason == 'duplicate'"/>
                    <field name="hours_spent"/>
                    <field name="notify_partner"/>
                </group>
                <group string="Note de résolution">
                    <field name="resolution_note" nolabel="1"/>
                </group>
            </sheet>
            <footer>
                <button name="action_close" type="object"
                        string="Clôturer le ticket" class="btn-primary"
                        data-hotkey="q"/>
                <button string="Annuler" class="btn-secondary"
                        special="cancel" data-hotkey="x"/>
            </footer>
        </form>
    </field>
</record>

Deux détails importants :

• special="cancel" — ferme le dialog sans valider. Pas besoin d'une méthode Python. Odoo gère nativement.
• invisible sur duplicate_ticket_id — le champ apparaît dynamiquement quand le motif devient "Duplicata". Expression v19 directe, plus d'attrs.

6. Action contextuelle de liste avec binding_model_id

Deuxième cas classique : déclencher un wizard qui opère sur une multi-sélection depuis une vue liste. Exemple : réassigner 10 tickets à un autre agent en un clic.

La recette : binding_model_id sur l'action. Odoo crée automatiquement une entrée dans le menu Actions des vues liste/kanban du modèle ciblé.

<record id="action_helpdesk_ticket_bulk_assign" model="ir.actions.act_window">
    <field name="name">Réassigner les tickets sélectionnés</field>
    <field name="res_model">helpdesk.ticket.bulk.assign.wizard</field>
    <field name="view_mode">form</field>
    <field name="target">new</field>
    <field name="binding_model_id" ref="model_helpdesk_ticket"/>
    <field name="binding_view_types">list</field>
</record>

Côté wizard, on lit active_ids dans default_get :

class HelpdeskTicketBulkAssignWizard(models.TransientModel):
    _name = 'helpdesk.ticket.bulk.assign.wizard'
    _description = 'Assignation groupée de tickets (wizard)'

    user_id = fields.Many2one('res.users', required=True,
                              domain="[('share', '=', False)]")
    ticket_ids = fields.Many2many('helpdesk.ticket', required=True)
    ticket_count = fields.Integer(compute='_compute_ticket_count')
    notify_assignee = fields.Boolean(default=True)

    @api.depends('ticket_ids')
    def _compute_ticket_count(self):
        for w in self:
            w.ticket_count = len(w.ticket_ids)

    @api.model
    def default_get(self, fields_list):
        vals = super().default_get(fields_list)
        if 'ticket_ids' in fields_list:
            active_ids = self.env.context.get('active_ids', [])
            vals['ticket_ids'] = [(6, 0, active_ids)]
        return vals

    def action_assign(self):
        self.ensure_one()
        self.ticket_ids.write({'user_id': self.user_id.id})
        if self.notify_assignee:
            for ticket in self.ticket_ids:
                ticket.message_post(
                    body=f"Réassigné à <strong>{self.user_id.name}</strong>",
                    partner_ids=self.user_id.partner_id.ids,
                    subtype_xmlid='mail.mt_comment',
                )
        return {
            'type': 'ir.actions.client',
            'tag': 'display_notification',
            'params': {
                'title': 'Réassignation effectuée',
                'message': f"{len(self.ticket_ids)} ticket(s) assigné(s).",
                'type': 'success',
                'next': {'type': 'ir.actions.act_window_close'},
            },
        }

La commande [(6, 0, active_ids)] est un Command triplet : 6 = "remplace tout par cette liste d'IDs". Équivalent moderne : [Command.set(active_ids)] en important from odoo.fields import Command.

Les pièges de wizard à connaître

1. Oublier target='new' — le wizard s'ouvre en remplaçant la vue courante au lieu d'un dialog. Mauvaise UX, le retour arrière casse le flux.
2. Oublier l'ACL — AccessError à l'ouverture. Message d'erreur générique qui ne dit pas que c'est un wizard sans ACL.
3. Utiliser models.Model au lieu de TransientModel — la table se remplit indéfiniment de saisies partielles. Audit DB douloureux.
4. Faire une query SQL dans default_get pour pré-remplir — passe par l'ORM (self.env['model'].browse(id).field), sinon tu bypasses les ACL.
5. Renvoyer None ou True depuis la méthode d'action — le dialog reste ouvert, l'utilisateur ne sait pas si ça a marché. Toujours renvoyer une act_window_close ou une notification.
6. Chaîner deux wizards sans passer le contexte — le second wizard n'a plus d'active_id. Pense à context dans l'action retournée.

Voir aussi dans cette série