Formules — Règles de base

Cette page pose les règles essentielles pour écrire des formules (expressions) dans SenSaaS Report Designer (FastReport .frx).
L’objectif est de distinguer clairement ce qui relève du texte, d’un champ (donnée), ou d’une expression (calcul/formatage).

Note

Dans le Designer, une “formule” correspond à une expression évaluée à l’exécution du rapport.
La syntaxe des expressions est alignée avec l’écosystème .NET (opérateurs, conversions, fonctions, etc.).

1) Les 3 types de contenu à ne pas confondre

Texte statique (libellé)

Un texte statique est saisi “tel quel” et s’affiche exactement comme écrit.
Exemple : Total HT : ou Client :.

Quand l’utiliser :
- libellés, titres, en-têtes, unités, séparateurs fixes.

Champ (donnée)

Un champ correspond à une valeur issue de la source de données (requête / table / vue).
Il est généralement inséré depuis le panneau Données.

Quand l’utiliser :
- afficher une valeur telle qu’elle existe dans la donnée : nom, référence, date, montant, etc.

Tip

Un champ s’insère le plus souvent sous forme de référence (ex. un nom de champ entre crochets selon le contexte du Designer).
L’objectif est de lier l’objet à la donnée, sans logique supplémentaire.

Expression (formule)

Une expression est un calcul ou une construction de texte réalisée à partir de champs et/ou de constantes.
Elle sert notamment à :
- concaténer plusieurs champs,
- appliquer une condition,
- formatter une valeur,
- faire un calcul.

Warning

Une expression n’est pas un “texte” classique.
Si vous saisissez une expression au mauvais endroit (ou sans respecter la syntaxe attendue), le Designer peut afficher le contenu littéralement (comme du texte), ou produire un rendu vide.

2) Comprendre “formule ≠ champ texte”

En pratique, l’erreur la plus fréquente est de confondre :
- un champ (liaison directe à la donnée), et
- une expression (logique/interprétation).

Bon réflexe :
- si vous devez seulement afficher une valeur, utilisez un champ,
- si vous devez transformer/combiner/calculer, utilisez une expression.

3) Où placer correctement chaque type de contenu

Dans l’éditeur de texte

L’éditeur de texte permet de gérer un mélange de :
- libellés statiques,
- insertion de champs,
- insertion d’expressions (selon le besoin et le mode d’édition).

Tip

Pour garder des rapports lisibles et maintenables :
- privilégiez des libellés statiques clairs,
- insérez les champs “bruts” quand aucune transformation n’est nécessaire,
- limitez les expressions au strict besoin (concaténation, format, calcul).

4) Symptômes d’une expression mal placée ou mal interprétée

Sans entrer dans du troubleshooting, voici les symptômes typiques à reconnaître :
- Affichage littéral : la “formule” apparaît telle quelle (comme un texte),
- Rendu vide : rien ne s’affiche alors qu’un champ contient bien une valeur.

Dans ces cas, vérifiez en priorité que :
- vous êtes bien en mode expression (et non en texte statique),
- les champs utilisés existent dans la source de données,
- la syntaxe est valide (opérateurs, guillemets, séparateurs).

5) Contrôle rapide du résultat (bonne pratique)

Après toute modification (champ ou expression), validez visuellement sur le canvas :
- le texte attendu est lisible,
- les valeurs s’affichent bien aux emplacements prévus.

Note

Le contrôle visuel sur le canvas ne remplace pas la prévisualisation avant livraison,
mais permet de détecter immédiatement une erreur de type “littéral” ou “vide”.

Besoin d’aide ?

Contactez le support SenSaaS :
✉️ support@sensaas.fr
📞 04 90 88 22 76