Gestion des rapports - Excel

Le module complémentaire « Rapport Excel » offre la possibilité de créer et de générer des rapports au format XLSX. Il existe au téléchargement du module plus de 15 rapports XLSX déjà paramétrés. Il est possible d’en créer de nouveaux ou de les modifier si besoin. 

Il y a donc 2 manières d’éditer des rapports après l’installation : soit par Jasper, soit par Excel. 

Il n'y a pas de règle fixe et tout dépend des besoins/ressources des clients et du projet mais globalement une des bonnes pratiques est la suivante : 

- Utiliser les rapports Jasper pour les documents standards (déjà paramétrés, juste à personnaliser). Cela permet d'avoir de "beaux" documents pour être envoyés à l'extérieur de l'entreprise. 

- Utiliser les rapports Excel pour créer des rapports de toute pièce, pour des besoins spécifiques qui ne se rapprochent pas de ceux du standard. Ils sont plutôt destinés à un usage en interne ou alors à un usage externe si le besoin est d'obtenir un export au format modifiable (XLSX). 

 

Prérequis 

Les rapports fonctionnent avec des polices du pack freefont. Il faut donc impérativement installer le pack sur le serveur OpenProd avec la commande suivante : sudo apt install fonts-freefont-ttf 
Il faut également installer la police "code128.ttf" qui permettra l'impression des codes barre (notamment pour les rapports étiquette). 

Ajouts du module 

Il y a deux modules à installer : 

Utilisation du module 

Afin de pouvoir utiliser les rapports, nous allons détailler ici les paramétrages. On se place dans la vue formulaire d’un rapport. 

1) L'en-tête 

On peut utiliser une expression Python afin d’adapter le nom du rapport. Exemple : « "BL "+object.name+"_"+time.strftime('%d-%m-%Y')» donnera BL OUT/00002_12-05-2021  

 On peut utiliser une expression Python : ‘object.partner_id.lang’ 

 

2) Onglet Section 

Les sections du rapport contiennent les requêtes et le traitement des données. 

Une fois l'entête remplie, il faut insérer la requête SQL dans l'onglet Requête pour récupérer les données. Une fois la requête remplie, l'action Générer les champs remonte automatiquement tous les champs trouvés dans la requête. 

Si le bouton est grisé, il faut d'abord sauvegarder puis générer. 

Tout est pré-rempli automatiquement. On peut alors indiquer champ par champ le type de la cible (cellule, entête, pied de page), l’alignement voulu (gauche, centré, droite), la colonne et le type (texte, image ou code barre). 

3) Onglet Paramètres 

On retrouve dans cet onglet les paramètres spécifiques du rapport, c'est à dire les informations que l'on peut demander à l'utilisateur à l’exécution du rapport. Ces paramètres sont facultatifs. 
Il sont utilisés dans la requête SQL du rapport. 

Quand au moins un paramètre est renseigné, une case à cocher Générer une vue automatiquement apparaît. Si elle est cochée, on utilise la vue par défaut. Sinon, l'action Réinitialiser avec la vue automatiquement génère le code XML de la vue par défaut dans l'encadré Vue et on peut directement l'éditer. 

Exemple d’utilisation de paramètre dans une requête : SELECT name FROM res_partner WHERE id=%(client)s  

Client est le nom du paramètre qui est de type many2one en relation avec la table des res_partner 

4) Onglet Sous-rapports 

On retrouve la vue liste des autres rapports utilisés dans ce rapport.  

Pour les paramétrer il faut renseigner : 

 Contrairement à Jasper, un sous rapport Excel prend forcément toute la largeur du rapport initial puisque cela correspond à ajouter des lignes. 

5) Onglet Rapports parents 

On retrouve la liste des rapports qui utilisent ce rapport. Elles s’incrémentent automatiquement. 

6) Onglet Document modèle 

C'est dans cette liste qu'on ajoute les templates du rapport. Il peut y en avoir plusieurs car on peut associer au document une langue (optionnel), et donc venir chercher le bon template en fonction de la langue définie dans l'en tête.  

Le template est forcément un document qui est stocké dans Open-Prod. 

La réalisation du template est importante pour la mise en forme et le rendu du rapport. C'est dans ce template qu'il faut gérer la largeur des colonnes pour obtenir le bon format à l'impression (A4 dans l'exemple ici).                                                                          Utilisez la fonctionnalité excel pour afficher la délimitation des pages en pointillé.  

Même si il existe une fonction d'ajustement automatique à la hauteur (cf En tête), la définition de la hauteur des lignes et la fusion de cellules permet d'obtenir un rapport plus "joli" et lisible. 

De nombreuses fonctionnalités d'excel sont disponibles et peuvent être paramétrées directement dans le document modèle. Ainsi il est possible de définir des formules, des formatages conditionnels, etc... 

7) Onglet Images 

Cet onglet référence toutes les images à insérer dans le rapport. Les images sont forcément stockées dans Open-Prod.  

Cette manière d'insérer les images n'est pas la plus judicieuse : en effet elle était utilisée avant mais maintenant il est préférable de : 
- Si c'est une image statique (Exemple : logo de la société), commune à toutes les impressions du rapport, placer l'image directement dans le template : cela permet de dimensionner et positionner facilement. 
- Si l'image est propre à l'enregistrement (Exemple : Photo d'un colis avant envoi sur un BL) il faut appeler l'image dans la requête SQL (puisqu'elle est stockée dans Open-Prod). Au moment de la génération des champs, un champ de type Image sera importé et on pourra lui indiquer la cellule. L'image sera automatiquement redimensionnée au format de la cellule pour ne pas dépasser. 

Néanmoins, via cet onglet, quand on ajoute une image il faut indiquer le nom de la feuille du template dans laquelle l'image doit d'insérer et la cellule. L'image va s'insérer telle quelle c'est à dire qu'elle ne sera pas redimensionnée. Il est fort probable que l'image déborde. 

 Paramétrées par cet onglet, les images ne sont pas prises en compte dans les sous rapports : Si une image est ajoutée pour ce rapport, et que celui ci est utilisé dans un autre rapport en tant que sous-rapport, alors l'image ne sera pas propagée. 

8) Onglet Conditions 

On peut définir des actions qui seront exécutées (selon les conditions associées) à la fin de la génération du rapport. Elles permettent d'améliorer la mise en forme du rapport. 

Pour ajouter une condition il faut : 

9) Onglet Action 

10) Les boutons Actions 

Une fois le rapport passé en Actif, plusieurs actions sont disponibles : 

 Certains rapports, typiquement pour du reporting, peuvent ne prendre aucun enregistrement d'entrée, les paramètres étant déjà indiqués dans la requête SQL. 

Si un menu a été créé pour un rapport, puis que ce rapport est passé en brouillon, le menu ne disparaît pas mais n'est plus actif. En repassant le rapport en actif, le menu va aussi repasser en actif. En revanche, passer le rapport obsolète supprime le menu. 

 L'action est utilisée lorsque le rapport porte sur un enregistrement et récupère les données de celui-ci. Le menu est utilisé pour les rapports où tout est déjà dans la requête. 

Question fréquente : Comment importer des valeurs de la requête dans une phrase du modèle Excel (Exemple : Le prix total de la commande est de {Valeur de la requête}) ? 

La solution est d'exporter la valeur de la requête dans une cellule cachée et ensuite d'appeler cette cellule par une formule dans le rapport Excel.