Matomo

Créer un template Redner dans Odoo

Dans ce guide utilisateur nous allons vous montrer comment créer des templates pour vos différents documents commerciaux à générer depuis Odoo. Redner peut générer tous types de documents : devis, bons de commande, factures, etc. Pour ce guide, nous prendrons l’exemple d’un modèle de devis.

Création d’un template LibreOffice

Vous pouvez concevoir vos templates avec LibreOffice. Pour concevoir un modèle, il vous suffit d’insérer des variables en Mustache dans le template. Ces variables seront automatiquement remplacées par des valeurs issues d’Odoo lors de la génération d’un devis.
Vous pouvez télécharger librement le template de devis ci-dessous et l’importer dans votre instance Odoo.

Conception d'un modèle avec LibreOffice

Import du template dans Odoo

Vous pouvez désormais créer votre modèle dans Paramètres > Technique > Redner > Modèles. Veillez à activer le mode développeur pour pouvoir accéder au module Technique. Vous indiquez ensuite les langages utilisés au sein du template et importez le modèle de document ODT. Les variables utilisées au sein du modèle seront automatiquement détectées et listées.

Importation du document dans Odoo

Création d’un rapport Odoo pour le modèle

Vous pouvez ensuite créer un rapport Odoo qui s’appuie sur le modèle précédemment paramétré. Pour ce faire, vous devez vous rendre dans la rubrique “Rapports” de l’onglet “Technique”. A la création du rapport, il vous faut préciser qu’il s’agit d’un type de rapport “redner” et définir l’objet Odoo sur lequel appliquer le modèle. S’agissant d’un devis, nous l’appliquons sur l’objet sale.order. Vous sélectionnez le modèle Redner qui convient et définissez un format de sortie.
Si besoin, il est possible de désactiver l’option d’impression permettant aux utilisateurs de générer un document depuis un devis Odoo. L’option sera alors accessible uniquement depuis les emails.

Création d'un rapport utilisable sur objet Odoo

Mapping des variables

Il vous faut ensuite construire le mapping des variables en remplissant le tableau des correspondances.
Pour chaque variable vous devez définir le type de valeur à associer puis spécifier l’expression appropriée. Il peut s’agir d’un champ de l’objet Odoo ciblé par le rapport ou d’une expression Mustache plus spécifique.

Liste des types :
- Champ : désignation d’un champ spécifique d’un modèle Odoo
- Image file : désignation d’un champ image d’un modèle Odoo
- Image data url : un champ image qui sera converti en url à intégrer dans un template HTML
- Relation to many : pour appeler une valeur issue d’un champ de type liste de relations
- Relation Path : permet d’aller chercher des objets liés avec une syntaxe spécifique
- Valeur constante : définition d’une valeur fixe
- Odoo Template : une expression template QWeb qui permet de récupérer la valeur d’un champ disponible sur un modèle Odoo
- Odoo Template + Eval : une expression de template QWeb qui produit du code Python qui sera ensuite évalué

Tableau de substitution des variables par des valeurs Odoo

Préparation d’un devis Odoo

Vous pouvez désormais utiliser le template sur tous vos devis Odoo. Rendez-vous dans le module “Ventes” pour créer un devis destiné à un client. Pour générer le document avec Redner, cliquez simplement sur le nom de votre rapport Redner sous l’option “Imprimer”.

Génération d'un devis client à partir du template Redner

Génération du devis

Redner va alors automatiquement fusionner les données du devis Odoo dans le modèle préconçu. Votre devis sera généré au format indiqué dans le rapport, ici PDF.

Génération rapide du rendu
Documentation

Guides utilisateurs

Générer une clé d'API avec Redner

Créer un template Redner dans Odoo

Créer un modèle d'email MJML avec Odoo et Redner