Dans une colonne de type formule, la fonction SUM_ELEMENTS() additionne les valeurs numériques d'une colonne, y compris les colonnes contenant plusieurs valeurs séparées par une virgule, notamment les champs de type Colonne d'une table liée.
Certains outils utilisent le terme « Rollup » pour une fonction équivalente permettant de calculer la somme d'éléments liés à une table.
-
Nom de la fonction :
SUM_ELEMENTS()
Syntaxe
SUM_ELEMENTS(colonne)
Appel des paramètres de fonction dans TimeTonic :
- $nom_du_champ = champ (lien, colonne de table liée, nombre, sélection, formule, texte...).
- "texte libre" = texte libre à ajouter entre guillemets.
- ne pas utiliser de guillemets pour les nombres.
Paramètres
| Paramètre | Description |
|---|---|
colonne |
La colonne dont on additionne les valeurs. Peut être une colonne de type nombre, ou une colonne de type Lien vers une autre table / Colonne d'une table liée, à condition qu'elle contienne des valeurs numériques. |
Exemple
Une table de feuilles de temps (heures et coûts) est liée à une table de projets. La colonne Cost from timesheets est une colonne d'une table liée qui remonte les coûts de chaque ligne. Pour obtenir le coût total du projet :
SUM_ELEMENTS($Cost from timesheets)
La colonne renvoie le total des coûts de toutes les feuilles de temps rattachées au projet.
Notes
- La somme fonctionne aussi sur des colonnes de type texte, Lien vers une autre table ou Colonne d'une table liée, dès lors qu'elles contiennent des valeurs numériques.
- Vous pouvez masquer la colonne intermédiaire (ici
Cost from timesheets) pour ne pas l'afficher à l'utilisateur final.
Type de retour
La fonction renvoie un nombre.
Le format du type de sortie du résultat peut être configuré dans les options du champ de sortie de l'éditeur de formule. Pour plus de détails, consultez Options de format de sortie dans l'article Colonne de formule.
Cas d'usage métier
SUM_ELEMENTS() consolide des données liées : total des heures travaillées sur un projet, coût total de main-d'œuvre, montant cumulé de commandes rattachées à un client.
Bonne pratique
Créez d'abord une colonne intermédiaire qui remonte la valeur à additionner depuis la table liée, puis appliquez SUM_ELEMENTS() sur cette colonne. Masquez l'intermédiaire pour garder une interface propre.