3 octobre 2026 · 3 min · Odoo sur mesure
Migrer un module Odoo de la version 18 à 19 et 20
Migrer Odoo vers une nouvelle version, c’est porter le code de chaque module ajouté (Python, vues, JavaScript) et transformer les données de la base, puis tout tester sur une copie de la production avant la bascule ; en Enterprise, l’éditeur migre la partie standard, en Community on s’appuie sur les outils de la communauté. Le facteur clé, ce sont vos modules spécifiques. Voici la méthode que nous appliquons, y compris à nos propres apps publiées pour Odoo 18, 19 et 20.
Pourquoi migrer
- Le support : l’éditeur maintient les trois dernières versions majeures. Au-delà, plus de correctifs de sécurité.
- Les nouveautés : chaque version apporte des fonctions et des améliorations de performance.
- La facture électronique : les versions récentes intègrent mieux les nouvelles obligations.
- Les modules : les éditeurs publient d’abord pour les versions récentes.
Les deux volets d’une migration
1. Le code
Chaque module ajouté doit être adapté à la nouvelle version : changements d’API Python, de structure des vues XML, du cadre JavaScript (OWL), des noms de champs ou de méthodes. Un exemple connu : en version 18, les vues de liste <tree> sont devenues <list>. Chaque version apporte son lot de changements de ce type.
2. Les données
La base de données doit être transformée : nouveaux champs, champs supprimés ou renommés, objets restructurés. En Enterprise, le service de mise à niveau de l’éditeur s’en charge pour les modules standards. En Community, on utilise OpenUpgrade, le projet de l’Odoo Community Association, et des scripts pour vos modules.
Pour les données, on passe en général version par version (17 → 18 → 19), même si l’objectif est de sauter plusieurs versions.
La méthode en 6 étapes
Étape 1 — L’inventaire
Listez tous les modules installés, en trois catégories :
- standards d’Odoo ;
- achetés ou de la communauté : la version cible existe-t-elle ?
- sur mesure : qui les a écrits, sont-ils encore utilisés ?
C’est souvent l’occasion de faire le ménage : un module développé il y a cinq ans peut être devenu inutile parce qu’Odoo fait désormais la même chose.
Étape 2 — Le portage du code
Pour chaque module sur mesure : adaptation du code, des vues, des rapports et du JavaScript ; mise à jour des tests automatiques. Les modules bien écrits et testés se portent vite ; ceux qui modifient le cœur d’Odoo en profondeur demandent plus de travail.
Étape 3 — Les tests sur base neuve
Chaque module porté est installé sur une base vierge de la version cible, avec ses tests automatiques. C’est le moyen le plus sûr de détecter les problèmes de dépendances.
Étape 4 — La migration d’une copie de la production
On migre une copie récente de votre base réelle. On mesure la durée de l’opération et on corrige les erreurs de données.
Étape 5 — La recette par les utilisateurs
Vos équipes vérifient leurs processus sur la copie migrée : un devis, une livraison, une facture, un avoir, un export comptable, les rapports PDF personnalisés. Une liste de vérification par équipe évite les oublis.
Étape 6 — La bascule
Un créneau calme (souvent un week-end), une sauvegarde complète vérifiée (voir sauvegarder automatiquement sa base Odoo), la migration définitive, un contrôle rapide, et c’est reparti. On garde l’ancienne base en lecture quelque temps.
Les personnalisations « sans code »
Les personnalisations faites dans le mode développeur (vues modifiées à la main, champs x_) sont le point le plus fragile : il faut les inventorier et les vérifier une par une. Celles faites avec Studio ou avec une app qui les stocke comme des données, comme Ramira Studio, se migrent avec la base. Voir ajouter des champs personnalisés dans Odoo et un Studio pour Odoo Community.
Le budget
Le coût dépend surtout du nombre et de la complexité des modules sur mesure. Chez Ramira, le portage d’un module démarre à 400 € HT, tests compris. Voir combien coûte un module Odoo sur mesure et notre offre de migration d’Odoo.
En résumé
Inventaire, portage, tests sur base neuve, migration d’une copie, recette, bascule : une migration bien préparée se passe sans drame. Nous portons chaque année nos propres apps, visibles sur notre page modules Odoo. Votre base a quelques versions de retard ? Parlons-en.
Questions fréquentes
Faut-il migrer chaque année ?
Non. L’éditeur maintient les trois dernières versions majeures. Beaucoup d’entreprises migrent tous les deux ou trois ans. Attendre trop longtemps rend le saut plus difficile, car il faut passer par chaque version intermédiaire pour les données.
Combien de temps dure une migration ?
Pour une PME avec quelques modules sur mesure, comptez deux à six semaines entre l’inventaire et la bascule, dont une bonne part de tests. La bascule elle-même se fait souvent sur un week-end.
Mes modules achetés sur la boutique seront-ils disponibles ?
Vérifiez que l’éditeur de chaque module publie la version cible. Nos apps Ramira Studio, par exemple, sont publiées pour Odoo 18, 19 et 20.
Sources
Mohamed Rahmouni — fondateur de Ramira, développeur d’applications et consultant Odoo à Niort. En savoir plus