Développement - Utilisation avancée / `Debug Mode`

Pour faciliter le développement de nouvelles fonctionnalités dans Odoo, il vous est proposé l’utilisation du Mode Développeur (Accessible depuis les Paramètres Généraux), ainsi que de sa sous-option Mode débogage / Debug Mode.

`Mode Développeur` vs `Debug Mode`

Le Mode Développeur, une fois activé, vous permet l’accès à différentes options dans les menus normalement accessibles uniquement pour des profils développeurs, comme le menu Technique. Ce mode persiste dans la mémoire de votre application et sera répercuté pour tous vos utilisateurs administrateurs. Si devenu inutile, ce mode peut également être désactivé tout aussi facilement. Lorsque vous l’activez (ou le réactivez), le Debug mode s’activera également automatiquement.

Le Debug mode quand à lui est une option supplémentaire qui permet l’affichage d’informations contextuelles techniques supplémentaires sur les vues sur lesquelles vous vous trouvez; pour accéder à ces informations, vous trouvez généralement une petit icône en forme d’insecte sur la partie en haut à droite de l’écran.

Cas d’usage

Modification spécifique d’un modèle de document PDF

Souvent, il arrive que votre client nécessite des petites modifications particulières et souvent d’ordre esthétiques sur certains modèles de documents à générer.

Modification d’un libellé
Affichage de données supplémentaires
etc.

Vous pouvez directement agir sur les documents générés en accédant aux vues associées dans Paramètres > Technique > Interface utilisateur > Vues. Par convention, Filtrez par QWeb et recherchez alors les vues contenant report dans leur titre.

Fréquemment, il vous sera demandé de modifier quelques éléments dans les informations rendues dans les documents de facturation; ainsi, report_invoice_document devra être modifié.

Ici, un exemple de modèle de document de facturation avec les libellés modifiés;

Définition / récupération de l’ID Externe d’un enregistrement défini via un module

Lorsque vous développez un module, il est fréquent que certaines données complexes soient à inscrire automatiquement dans la base (de nouvelles taxes par exemple), et il est conseillé d’y adjoindre au moment du développement un identifiant technique externe (appelé ID XML) afin d’y faire référence + tard, notamment dans le cadre d’une mise à jour du module qui viendrait par exemple à modifier des valeurs de taxes.

Vous pouvez également, grâce au Debug Mode, pouvoir retrouver ces identifiants sur la vue de l’enregistrement.

Depuis l’interface, allez directement sur la vue où vous pouvez modifier les valeurs d’un enregistrement, puis cliquez sur le bouton Debug Mode en forme d’insecte. Ensuite Enregistrement > Métadonnées.

Création d’ID

Si aucun ID n’est associé à cet enregistrement, vous trouverez à la ligne ID XML le bouton caché (créer).

En cliquant dessus, vous pourrez alors créer un identifiant externe pour cet enregistrement.

Si un ID existe déjà, vous trouverez le bouton caché (modifier) à la place sur la ligne Pas de mise à jour; celui-ci n’agira que sur le comportement de cet enregistrement lors de la prochaine mise à jour de son module déclarant (voir ici).