Syntaxe
|
Sum( NumericalFormula1, [ NumericalFormula2, ... ] )
|
|
Sum( Table, NumericalFormula )
|
Paramètres
| Nom |
Description |
| NumericalFormula1 |
Ce paramètre représente une valeur ou une expression numérique à inclure dans le calcul de la somme. |
| NumericalFormula2, ... |
Ces paramètres supplémentaires sont optionnels. Chacun représente une autre valeur ou expression numérique à additionner à la somme. |
| Table |
Ce paramètre représente une table de données contenant des enregistrements sur lesquels effectuer l'addition. |
| NumericalFormula |
Ce paramètre représente une formule ou une colonne numérique de la table, dont les valeurs seront additionnées pour obtenir la somme totale. |
|
Description
Cette fonction permet de calculer la somme de ses paramètres.
Remarques
- Fonction essentielle pour les totaux dynamiques : La fonction Sum est largement utilisée dans les applications pour calculer des totaux, que ce
soit pour des montants, des quantités ou des scores. Elle permet d'agréger des valeurs numériques de manière simple et rapide sans écrire de boucle.
- Supporte les valeurs individuelles et les expressions : Sum accepte non seulement des nombres directs, mais aussi des expressions numériques. Cela
permet de faire des additions impliquant des calculs dynamiques, comme Sum(Price * Quantity) pour obtenir un total de facture par exemple.
- Particulièrement utile avec les collections : Lorsqu'on utilise une collection de données, la syntaxe Sum(Collection, FieldName) permet de calculer
automatiquement le total d'un champ spécifique. Cela facilite grandement la synthèse de données affichées dans des galeries ou des tableaux.
- Peut intégrer plusieurs expressions en ligne : La fonction permet de spécifier plusieurs expressions directement, comme Sum(10, 15, 20 + 5), ce qui peut
être pratique pour des additions rapides entre constantes ou résultats de calculs distincts sans devoir créer de structure intermédiaire.
- Optimale pour les champs calculés dans une table : En combinant Sum avec une formule dans une table, on peut par exemple faire
Sum(Produits, Prix * Quantité), ce qui additionne les résultats ligne par ligne. Cela remplace les itérations manuelles et améliore la lisibilité du code.
- Ignore automatiquement les valeurs non numériques : Lorsqu'elle est appliquée à une table, Sum ne prend en compte que les valeurs numériques. Les
chaînes de texte, booléens ou champs vides sont ignorés, ce qui évite les erreurs d'exécution dans les traitements de données hétérogènes.
- Combinable avec d'autres fonctions de filtrage : Sum devient encore plus puissante lorsqu'elle est utilisée avec Filter ou LookUp, car
on peut ainsi calculer des totaux conditionnels. Par exemple, Sum(Filter(Produits, Catégorie="Livres"), Prix) totalise uniquement les produits d'une catégorie
spécifique.
- Utile pour les tableaux à une seule colonne ou complexes : La fonction fonctionne aussi bien avec une table simple qu'avec des structures plus élaborées.
En ciblant un champ précis avec une expression, elle permet de gérer des scénarios comme les sous-totaux, les regroupements ou les rapports de synthèse.
Dernière mise à jour : Jeudi, le 1 Mai 2025