CARONNA OdooL'intégrateur Odoo par IA

CARONNA Odoo / Blog / Paramétrage

Paramétrage

Écrire une action serveur dans Odoo en Python : les bases pour bien démarrer

Publié le 22 novembre 2026 · 7 min de lecture

Une action serveur dans Odoo permet d'automatiser une tâche répétitive avec quelques lignes de Python, sans créer de module. Voici les bases pour la créer, la tester et la déclencher sans prendre de risque sur vos données.

Une action serveur dans Odoo est un petit bloc de réglages ou de code qui exécute une tâche à votre place : modifier une fiche, créer un enregistrement, poster un message. Python est le langage de programmation que le logiciel utilise en coulisses. Vous n'avez pas besoin d'être développeur pour comprendre la logique, et quelques lignes suffisent déjà à supprimer bien des manipulations répétitives.

Cet article vous explique le principe, l'endroit où la créer, un premier exemple à adapter et les pièges à éviter.

À savoir : les menus, les libellés et les noms de champs changent d'une version d'Odoo à l'autre. Les chemins indiqués ici sont donnés à titre de repère. Vérifiez-les dans votre version et sur votre hébergement.

Comment fonctionne une action serveur dans Odoo

Une action serveur est rattachée à un modèle, c'est-à-dire un type de fiche : les commandes clients, les contacts, les factures, les tâches, etc. Chaque modèle a un nom technique, par exemple `sale.order` pour les commandes clients (à vérifier dans votre version).

Quand l'action se lance, Odoo exécute ce que vous avez prévu. Plusieurs types existent, et leurs noms varient selon la version :

  • Mettre à jour l'enregistrement : changer la valeur d'un champ, sans écrire de code.
  • Créer un enregistrement : générer une nouvelle fiche à partir de l'actuelle.
  • Envoyer un e-mail ou planifier une activité : prévenir quelqu'un.
  • Exécuter du code Python : le cas le plus souple, celui qui nous intéresse ici.
  • Exécuter plusieurs actions : enchaîner les précédentes dans un ordre précis.

Le code Python d'une action serveur tourne dans un espace restreint (on parle de « bac à sable »). Vous ne pouvez pas y importer n'importe quelle bibliothèque ni lire les fichiers du serveur. C'est une protection voulue, qui explique certains messages d'erreur déroutants.

Où créer votre première action serveur

Ces écrans sont réservés aux administrateurs et demandent généralement d'activer le mode développeur, un affichage qui révèle les menus techniques d'Odoo. Le chemin habituel est le suivant :

  1. Activez le mode développeur (via les paramètres, ou en ajoutant `?debug=1` à l'adresse de votre Odoo).
  2. Ouvrez Paramètres, puis Technique, puis Actions, puis Actions serveur. Le libellé exact dépend de votre version.
  3. Cliquez sur Nouveau et donnez un nom clair à l'action, par exemple « Marquer les grosses commandes ».
  4. Choisissez le modèle concerné.
  5. Choisissez le type Exécuter du code Python, puis saisissez votre code dans l'onglet prévu.

Pour la tester sans risque, faites-le d'abord sur une copie de votre base ou sur une base de test, jamais directement sur vos données de production.

Un premier exemple en Python à adapter

Imaginons que votre direction veuille examiner toute commande dépassant un certain montant. Vous créez d'abord un champ case à cocher « Validation requise » sur les commandes (par exemple `x_validation_requise`, car les champs ajoutés à la main commencent en général par `x_`). Puis vous écrivez l'action suivante :

```python # Modèle : Commande client for commande in records: if commande.amount_total > 5000 and not commande.x_validation_requise: commande.write({'x_validation_requise': True}) commande.message_post( body='Montant élevé : validation de la direction requise.' ) ```

Voici ce que fait ce code, ligne par ligne :

  • `for commande in records` : l'action traite chaque fiche sélectionnée, une par une.
  • `if commande.amount_total > 5000` : on teste le montant total. Le seuil de 5000 est un exemple, remplacez-le par le vôtre.
  • `commande.write({...})` : on coche la case sur la fiche.
  • `commande.message_post(...)` : on ajoute une note dans l'historique de la fiche, pour garder une trace.

Pour adapter cet exemple à votre cas, changez trois choses : le modèle, le champ testé et l'effet produit. Vérifiez que les noms de champs existent dans votre version. Vous les trouvez dans le mode développeur, en survolant un champ sur la fiche, ou dans le menu des champs du modèle.

Les variables que vous pouvez utiliser dans le code

Odoo met à votre disposition quelques éléments prêts à l'emploi dans le code. La liste exacte varie selon la version : l'éditeur affiche en général un rappel sous la zone de code, consultez-le.

  • `record` : la fiche en cours, quand l'action porte sur un seul enregistrement.
  • `records` : l'ensemble des fiches sélectionnées. C'est le plus sûr à utiliser, car il fonctionne aussi bien avec une fiche qu'avec une liste.
  • `env` : l'accès à toute la base. Par exemple `env['res.partner'].search([...])` cherche des contacts.
  • `model` : le modèle auquel l'action est rattachée.
  • `log(...)` : écrire un message dans le journal technique, utile pour comprendre ce qui se passe.
  • `datetime`, `time` : manipuler les dates et heures.

Pour afficher une erreur claire à l'utilisateur et annuler l'opération, on utilise en général `raise UserError('Votre message')`, si cette classe est disponible dans votre version.

Déclencher l'action : bouton, menu ou automatisation

Une action serveur seule ne fait rien tant qu'on ne la lance pas. Il existe plusieurs façons de le faire.

Depuis le menu Action. Sur la fiche de l'action serveur, un bouton permet de créer une action contextuelle. Elle apparaît ensuite dans le menu Action des listes et des fiches du modèle. Les utilisateurs sélectionnent des lignes, puis lancent l'action manuellement. Le libellé du bouton dépend de la version.

Par une règle automatisée. Odoo propose un module d'actions automatisées (« règles d'automatisation » dans certaines versions). Vous y définissez un déclencheur : à la création d'une fiche, à sa modification, quand un champ change, selon une date, etc. Puis vous y rattachez votre action serveur. Elle se lance alors toute seule.

Depuis un bouton sur une vue. Avec un peu de configuration des vues, un bouton peut appeler l'action. Cette option demande de modifier l'écran, donc plus de prudence.

Les erreurs fréquentes et les bonnes pratiques

Quelques réflexes évitent la plupart des mauvaises surprises :

  • Testez sur peu d'enregistrements. Lancez d'abord l'action sur une seule fiche de test et regardez le résultat.
  • Travaillez sur une copie. Une action qui modifie des milliers de lignes ne se rattrape pas toujours facilement.
  • Évitez les boucles lourdes. Chercher des données fiche par fiche dans une boucle peut ralentir Odoo. Préférez une recherche unique en amont.
  • Gérez les cas vides. Un champ non rempli vaut souvent `False` ou vide. Testez-le avant de l'utiliser, sinon l'action plantera.
  • Laissez une trace. Une note dans l'historique (`message_post`) aide vos collègues à comprendre pourquoi une fiche a changé.
  • Nommez et documentez. Un nom explicite et un commentaire précédé de `#` vous feront gagner du temps dans six mois.
  • Faites attention aux suppressions. Une action qui supprime ou écrase des données est irréversible. Demandez une validation avant de la lancer en production.

Si vous rencontrez une erreur, lisez la dernière ligne du message : elle indique souvent le nom du champ ou de la variable en cause. Une faute de frappe dans un nom de champ est la cause la plus courante.

Attention aussi à votre hébergement. Selon la formule choisie (Odoo en ligne, Odoo.sh, installation sur vos propres serveurs), les possibilités de code personnalisé peuvent différer. Vérifiez-le auprès de votre éditeur ou de votre hébergeur avant de vous lancer.

Et si vous préférez ne pas écrire le code vous-même ?

Écrire une action serveur n'est pas compliqué, mais cela demande de connaître les noms techniques, de tester soigneusement et de savoir revenir en arrière. C'est là que CARONNA Odoo peut vous aider : vous branchez votre Odoo, vous décrivez votre besoin en français (« cocher une case quand une commande dépasse un montant et prévenir la direction »), et l'IA paramètre la base à votre place, champs, vues, actions automatisées et droits compris.

Les garde-fous sont pensés pour des équipes non techniques :

  • un mode test et un mode production, pour essayer avant d'appliquer ;
  • un accord explicite demandé avant toute action irréversible ;
  • un journal complet de ce qui a été fait, avec possibilité d'annuler.

L'IA est incluse dans l'abonnement. Pour comprendre ce que cela peut changer concrètement dans votre quotidien, consultez la section sur les gains attendus. Si vous préférez voir la démarche en situation, la démonstration vous montre le déroulé. Et pour connecter votre propre base, rendez-vous directement dans l'application.

Ce que vous pouvez faire dès aujourd'hui

Pour avancer concrètement, voici un plan simple :

  1. Choisissez une seule tâche répétitive dans votre équipe : relancer, cocher, classer, prévenir.
  2. Notez par écrit la règle : « Quand… alors… ».
  3. Repérez le modèle et les champs concernés dans le mode développeur.
  4. Créez l'action serveur sur une base de test, avec un code court.
  5. Essayez-la sur une fiche, puis sur une petite sélection.
  6. Ajoutez une note dans l'historique pour garder la trace.
  7. Seulement ensuite, rattachez-la à une règle automatisée en production.

Une bonne action serveur est courte, claire et prudente. Commencez petit : un premier automatisme fiable vaut mieux qu'un grand script que personne n'ose toucher.

Votre intégrateur Odoo, disponible tout de suite

Branchez votre Odoo et décrivez votre besoin en français : l'IA paramètre, connecte et vérifie, avec votre accord pour chaque action sensible. IA incluse, dès 149 € par mois.

À lire ensuite