CARONNA OdooL'intégrateur Odoo par IA

CARONNA Odoo / Blog / Paramétrage

Paramétrage

Héritage de vues : les erreurs à éviter avec XPath dans Odoo

Publié le 22 novembre 2026 · 6 min de lecture

Une vue Odoo modifiée à la va-vite peut afficher une page blanche ou un message d'erreur au pire moment, souvent après une mise à jour. Voici les erreurs d'héritage de vues les plus courantes, expliquées sans jargon, avec les réflexes qui permettent de les éviter.

Utiliser XPath dans Odoo, c'est donner une adresse précise à l'endroit d'une vue où vous voulez ajouter, déplacer ou masquer un élément. C'est puissant, mais une adresse mal choisie suffit à casser un écran entier. Cet article vous montre les pièges les plus fréquents et ce que vous pouvez vérifier dès aujourd'hui, même si vous n'êtes pas développeur.

Comprendre l'héritage de vues en deux minutes

Dans Odoo, un écran (formulaire de contact, liste de commandes, etc.) s'appelle une vue. Elle est décrite dans un texte structuré, en XML (un format de texte à balises, comme du HTML). Plutôt que de modifier la vue d'origine, Odoo permet de créer une vue héritée : une petite vue qui ne contient que vos changements et qui vient se greffer sur la vue parente.

Pour dire où greffer le changement, deux méthodes existent :

  • La balise de champ directe : vous écrivez `<field name="partner_id" position="after">` pour placer quelque chose juste après ce champ. C'est simple et lisible.
  • L'expression XPath : vous écrivez `<xpath expr="..." position="...">`. XPath est un langage d'adresse qui permet de cibler un élément n'importe où dans la vue, même s'il n'a pas de nom.

Le paramètre `position` indique ce que vous faites à l'endroit ciblé : `before` (avant), `after` (après), `inside` (à l'intérieur), `replace` (remplacer) ou `attributes` (modifier une propriété, par exemple rendre un champ obligatoire). Une position `move` existe aussi dans les versions récentes ; vérifiez-la dans la vôtre.

Pourquoi un XPath dans Odoo casse si facilement

Une vue héritée ne fonctionne que si l'adresse trouve exactement un élément dans la vue parente. Si l'élément a disparu, a changé de nom ou a été déplacé, Odoo refuse de charger la vue. Vous obtenez alors une erreur du type « l'élément ne peut pas être localisé dans la vue parente » (le libellé exact dépend de la version).

Or la vue parente évolue : une mise à jour d'Odoo, l'installation d'un nouveau module ou l'ajout d'un champ peuvent suffire. Votre modification, elle, reste figée sur l'ancienne structure. Plus votre adresse dépend de la position d'un élément, plus elle est fragile.

Les erreurs les plus fréquentes

Voici les pièges que l'on rencontre le plus souvent, avec la parade pour chacun.

  • Viser un élément par sa position. Une adresse comme `//div[3]` signifie « le troisième bloc ». Si un module ajoute un bloc plus haut, vous ne ciblez plus le bon. Préférez toujours un repère stable, comme le nom d'un champ : `//field[@name='partner_id']`.
  • Utiliser une expression trop large. Si votre adresse correspond à plusieurs éléments, Odoo ne retient en général que le premier trouvé, donc pas forcément le bon. Précisez l'adresse jusqu'à ce qu'elle soit unique.
  • Remplacer au lieu d'ajouter. Avec `replace`, vous supprimez l'élément d'origine. Si un autre module s'appuyait sur cet élément, il tombe en erreur à son tour. Quand c'est possible, masquez plutôt que remplacer, ou ajoutez à côté.
  • Modifier directement la vue d'origine. En mode développeur, on peut éditer la vue de base. Mais si elle appartient à un module, votre changement peut être écrasé à la prochaine mise à jour du module. Passez par une vue héritée.
  • Oublier l'ordre d'application. Quand plusieurs vues héritées visent la même vue, Odoo les applique dans un ordre qui dépend de leur priorité (champ `priority`, ou « séquence » selon l'écran) puis de leur ordre de création. Si votre XPath cible un élément ajouté par une autre vue appliquée après la vôtre, il ne le trouve pas.
  • Écrire des attributs obsolètes. La façon de masquer ou de rendre obligatoire un champ selon une condition a changé selon les versions d'Odoo (anciennes propriétés `attrs` et `states`, écriture directe de conditions dans les versions récentes). Un code copié depuis un forum d'une autre version peut donc ne plus marcher.
  • Supprimer une vue héritée plutôt que la désactiver. La suppression est difficile à rattraper. Décocher « actif » sur la vue (si ce champ est visible dans votre version) permet de revenir en arrière en un clic.
  • Tester directement en production. Une vue cassée bloque tous les utilisateurs de cet écran, pas seulement vous.

Un exemple concret, avant et après

Imaginons que vous vouliez afficher un champ « Numéro de dossier interne » juste après le client, sur le formulaire des devis.

Version fragile :

``` <xpath expr="//sheet/group[1]/group[1]/field[2]" position="after"> <field name="x_dossier"/> </xpath> ```

Cette adresse suit un chemin précis de blocs. Elle casse dès qu'un module ajoute un groupe ou un champ.

Version robuste :

``` <field name="partner_id" position="after"> <field name="x_dossier"/> </field> ```

Ici, on s'appuie sur le nom du champ client, un repère qui bouge très rarement. Le résultat visuel est identique, mais la modification survivra bien mieux aux évolutions.

Attention : les noms de modèles, de champs et de menus varient selon la version d'Odoo et selon les modules installés. Le champ client s'appelle souvent `partner_id`, mais vérifiez-le chez vous avant de copier un exemple.

Les bons réflexes avant de toucher à une vue

Voici ce que vous pouvez faire dès maintenant, sans écrire une ligne de code.

  1. Activez le mode développeur (selon la version, via les paramètres ou en ajoutant `?debug=1` à l'adresse de votre navigateur). Il donne accès au menu des outils de développement.
  2. Repérez la vue concernée. Dans ce menu, une entrée du type « Modifier la vue » (le libellé varie) affiche la vue de l'écran en cours et ses vues héritées.
  3. Notez le nom technique du champ que vous voulez cibler : il apparaît au survol du champ en mode développeur.
  4. Travaillez sur une copie de la base. Une base de test évite de bloquer vos équipes si une vue casse.
  5. Documentez chaque changement : qui, quand, pourquoi. Dans un an, personne ne se souviendra pourquoi cette vue existe.
  6. Refaites un test après chaque mise à jour d'Odoo ou de module : ouvrez les écrans modifiés et vérifiez qu'ils s'affichent.

Si vous avez déjà des vues héritées dont vous ne connaissez plus l'origine, dressez-en la liste : vue parente, objet de la modification, auteur éventuel. Cet inventaire facilite grandement les migrations.

Comment CARONNA vous évite ces pièges

Chez CARONNA Odoo, vous décrivez votre besoin en français (« je veux voir le numéro de dossier sous le nom du client »). L'intelligence artificielle prépare la modification de la vue en choisissant un repère stable, et un intégrateur CARONNA supervise le chantier.

Plusieurs garde-fous protègent votre base :

  • 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é modifié, avec possibilité d'annulation.

Si vous voulez voir le principe à l'œuvre, la démonstration vous le montre pas à pas. Pour mesurer ce que cela peut changer dans votre quotidien, rendez-vous sur la page gain de temps. Quand vous serez prêt, vous pourrez connecter votre Odoo et obtenir un diagnostic gratuit. Le travail est ensuite facturé à prix fixe par tâche, sans abonnement : le détail se trouve dans la section tarifs. Notre assistance répond par e-mail du lundi au vendredi.

À retenir

Un XPath bien écrit est un XPath qui s'appuie sur un repère stable, qui cible un seul élément et qui évite de supprimer ce que d'autres modules utilisent. Testez toujours hors production, gardez une trace de vos modifications et revérifiez après chaque mise à jour. Avec ces habitudes, l'héritage de vues devient un outil sûr plutôt qu'une source de pannes.

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. Diagnostic gratuit, puis prix fixe par tâche dès 90 €.

À lire ensuite