Explorateur des modèles Odoo : champs, relations, API

L'outil répond à une question que se posent chaque semaine développeurs, intégrateurs et utilisateurs avancés : « comment s'appelle ce champ dans la base, et d'où vient-il ? ». Trois étapes suffisent.

Un modèle est une classe Python qui décrit un type d'enregistrement : un contact, une facture, une ligne de commande. L'ORM (Object Relational Mapping, la couche qui traduit les objets Python en requêtes SQL) crée pour chaque modèle persistant une table PostgreSQL. Le modèle res.partner est ainsi stocké dans la table res_partner.

Le nom technique suit une convention simple : un préfixe d'application (sale, account, stock, hr), puis un ou plusieurs mots séparés par des points. Les préfixes res (ressources partagées) et ir (Information Repository, le cœur technique) signalent les modèles du module base.

Chaque champ possède un nom technique (partner_id), un libellé affiché à l'utilisateur (Client) et un type. Le type détermine ce que vous pouvez lire ou écrire par l'API, et comment filtrer dessus.

Odoo est modulaire : chaque application ajoute ce dont elle a besoin aux modèles existants, sans les dupliquer. Le module sale ajoute par exemple les commandes d'un contact à res.partner. La fiche indique, pour chaque champ, le module qui le déclare. Trois mécanismes coexistent.

L'explorateur décrit Odoo standard. Pour vérifier un champ dans votre base, activez le mode développeur : Paramètres, puis « Activer le mode développeur », ou ajoutez ?debug=1 à l'adresse. Survolez ensuite un libellé de formulaire : une info-bulle affiche le nom technique du champ et son modèle.

Le menu Paramètres > Technique > Structure de la base de données > Modèles liste aussi tous les modèles installés, y compris ceux de vos modules spécifiques et les champs créés avec Studio (préfixe x_studio_).

Odoo 19 introduit l'API JSON-2 : une requête POST vers /json/2/<modèle>/<méthode>, authentifiée par une clé API envoyée dans l'en-tête Authorization. Chaque fiche de l'explorateur fournit un exemple prêt à copier en curl et en Python avec de vrais champs du modèle. La méthode fields_get renvoie de son côté la définition des champs de votre base, personnalisations comprises.

Les clés API se créent dans Préférences > Sécurité du compte, avec une durée de validité de trois mois au plus. D'après la documentation d'Odoo, l'accès à l'API externe est réservé à la formule Custom : il n'est pas disponible sur les formules One App Free et Standard.

Les fiches sont générées à partir du code source d'Odoo 19 Community (build publique du 28 août 2026, licence LGPL v3) : 395 modules installables analysés, sans exécuter Odoo. Les localisations étrangères et les modules de test sont exclus ; les localisations françaises sont conservées. Les libellés et aides en français et en espagnol proviennent des fichiers de traduction officiels d'Odoo.

Ne figurent pas ici : les modules Enterprise, vos modules spécifiques, les champs Studio et les listes de sélection calculées dynamiquement. Pour interroger le schéma réel de VOTRE base, Aidoo lit la structure de vos modèles et répond en langage naturel. Vous préparez un changement de version ? Consultez notre page migration vers Odoo 19.