Skip to main content

myFAB Rapport docx

myFAB · Rapport DOCX — Référence rapide

Prérequis : pip install docxtpl docxcompose htmldocx · LibreOffice requis pour le mode PDF

Créer un paramétrage

Technique → Rapport DOCX → Configurations → Nouveau

Champ Valeur attendue Obligatoire
Nom du rapport Libellé affiché dans l'interface ✓
Code rapport Identifiant technique unique, sans espaces — ex : declaration_conformite_ce ✓
Modèle Modèle Odoo cible (ex : sale.order, mrp.production) ✓
Champ nom fichier Champ Char du modèle utilisé pour nommer le fichier ✓
Template DOCX Fichier .docx avec balises Jinja2 ✓
Préfixe Texte ajouté au début du nom de fichier généré
Mode de fusion composer (DOCX unique) · zip (un fichier/enregistrement) · pdf (via LibreOffice) ✓
Nom fichier impression Formule Jinja — ex : {{ docs.name }}
Autoescape Activer si le template contient <, > ou &

Publier via le bouton Publier — tous les champs passent en lecture seule.
Pour modifier : Dépublier d'abord.

Syntaxe du template

Champs

{{docs.nom_du_champ}}
{{docs.relation_id.champ}}

Fonctions utilitaires

Fonction Description
{{spelled_out(docs.champ)}} Nombre en toutes lettres
{{formatdate(docs.champ)}} Date formatée (Babel, fr_FR par défaut)
{{fdate(docs.champ, "%d/%m/%Y")}} Date avec format personnalisé
{{fnum(docs.champ, " ", ",", 2)}} Numérique — fnum(val, sep_milliers, sep_décimal, décimales)
{{parsehtml(docs.champ)}} HTML → texte brut
{{p html2docx(docs.champ)}} HTML → sous-document Word
{{convert_currency(docs.champ, docs.currency_id)}} Montant avec devise
{{render_image(docs.champ, width=30, height=30)}} Image binaire (mm)
{{r rich_text(docs.champ)}} Texte enrichi
{{p add_subdoc(docs.champ)}} Sous-document DOCX binaire
{{replace_image('nom', docs.champ)}} Remplacement d'image dans le template

Langue surchargeable par fonction : {{formatdate(docs.champ, lang='en_US')}}

Boucles dans un tableau

Chaque directive {%tr %} doit occuper une ligne entière du tableau, avec une cellule fusionnée sur toute la largeur.

{%tr for line in docs.order_line_ids %}
  {{line.product_id.display_name}}  |  {{line.qty}}  |  {{line.price_unit}}
{%tr endfor %}
  • Les lignes for et endfor sont supprimées du rendu final.
  • Les champs s'accèdent via la variable de boucle (line).

Conditions dans un tableau

Utiliser impérativement if / else / endif — deux blocs if séparés provoquent une TemplateSyntaxError.

{%tr for line in docs.order_line_ids %}
{%tr if not line.uom_qty %}
  [cellule fusionnée] {{line.product_id.display_name}}   ← ligne de section
{%tr else %}
  {{line.product_id.display_name}}  |  {{line.uom_qty}}  |  {{line.price_unit}}
{%tr endif %}
{%tr endfor %}

Ordre obligatoire : for → if → else → endif → endfor

Préférer not line.champ à line.champ == 0 pour couvrir 0, 0.0, False et None.

La directive {%tr if %} et le contenu {{champ}} doivent être dans deux <w:r> séparés dans le XML Word — sinon le contenu ne s'affiche pas.

Mode PDF

Configurer le chemin LibreOffice dans Paramètres → Technique → Paramètres système :

OS Valeur
Linux /usr/bin/libreoffice
Windows C:\Program Files\LibreOffice\program\soffice.exe

Clé : default_libreoffice_path

Erreurs courantes

Erreur Cause Solution
TemplateSyntaxError: unknown tag 'endif' Deux blocs if séparés dans un for Remplacer par if / else / endif
Ligne fusionnée vide {%tr if %} et {{champ}} dans le même <w:r> Les séparer en deux runs distincts
Condition == 0 ignorée Le champ est un float (0.0 != 0) Utiliser not line.champ
Erreur 500 générique Erreur Python non affichée journalctl -u odoo -n 100 ou tail -f /var/log/odoo/odoo.log
PDF non généré LibreOffice absent ou mal configuré Installer + configurer default_libreoffice_path
Back to top