Documentation › Variables calculées
Variables calculées : une valeur qui se calcule
Une variable calculée n'a pas de valeur saisie : elle est calculée par une formule à partir d'autres variables. Par exemple Nom complet = prénom et nom, ou Budget restant = budget total − budget dépensé.
À quoi ça sert
- La valeur est recalculée à chaque lecture avec les valeurs actuelles des autres variables : si une variable change, le résultat suit.
- Elle est en lecture seule : aucune sortie (Outcomes) ni réponse de question ne peut l'écrire, et elle ne peut pas être modifiée au lancement d'une instance.
- Le résultat est un texte ou un nombre.
En créer une
- Ouvrez le bloc de départ du process (ou de l'artefact), onglet Variables, puis Add variable.
- Choisissez la portée Calculated, donnez un nom et choisissez le type du résultat.
- Écrivez la formule. Un message sous la zone dit ce qui ne va pas, ou le type du résultat. Tant qu'une formule est fausse, Save reste grisé.
Écrire une formule
{{Nom}}désigne une variable (le nom s'écrit tel quel, avec ses espaces et ses accents).- Un texte s'écrit entre apostrophes :
' '. Pour une apostrophe dans le texte, doublez-la :'l''été'. - Les opérateurs
+ - * /et les parenthèses ne servent qu'aux nombres. Pour assembler du texte, utilisezCONCAT:CONCAT({{Prenom}}, ' ', {{Nom}}). - Un nombre vide compte pour 0 ; un calcul impossible (division par zéro, texte non numérique) ne donne aucune valeur.
- Une variable calculée peut en utiliser une autre, mais jamais elle-même (directement ou par un détour).
Complétion automatique : tapez {{ pour voir les variables, ou les premières lettres d'une fonction pour la compléter. Utilisez les flèches, Entrée ou Tab pour choisir, Échap pour fermer.
Les fonctions
| Fonction | Rôle |
|---|---|
CONCAT(a, b, …) | Assemble du texte et des valeurs. |
UPPER(t), LOWER(t), TRIM(t) | Majuscules, minuscules, retire les espaces autour. |
LEN(t) | Nombre de caractères. |
ROUND(n, décimales) | Arrondit (0 décimale si omis). |
MIN(…), MAX(…), ABS(n) | Plus petit, plus grand, valeur absolue. |
Où elles servent
- Dans l'onglet Parameters d'une instance de process, avec la portée Calculated.
- Dans les choix (conditions) et les répétitions d'une phase.
- Dans les modèles de document :
{{Budget_restant}}prend la valeur calculée au moment de la génération.