Fonctions d’agrégation qui résument un ensemble de nombres.

Description

La fonction Average calcule la moyenne ou la moyenne arithmétique de ses arguments.

La fonction Max recherche la valeur maximale.

La fonction Min recherche la valeur minimale.

La fonction Sum calcule la somme de ses arguments.

La fonction StdevP calcule l’écart type de ses arguments.

La fonction VarP calcule l’écart de ses arguments.

Vous pouvez fournir les valeurs de ces fonctions comme suit :

  • Séparez les arguments. Par exemple, Sum( 1, 2, 3 ) renvoie 6.
  • Une table et une formule à appliquer à cette table. L’agrégation est calculée sur les valeurs de la formule pour chaque enregistrement.

Les champs de l’enregistrement en cours de traitement sont disponibles dans la formule. Vous y faites simplement référence par nom comme vous le feriez pour toute autre valeur. Vous pouvez également référencer les propriétés de contrôle et d’autres valeurs à partir de votre application. Pour plus d’informations, consultez les exemples ci-dessous et la section relative à l’utilisation des étendues d’enregistrement.

Ces fonctions agissent sur les valeurs numériques uniquement. Les autres types de valeurs (par exemple les chaînes ou les enregistrements) sont ignorés. Utilisez la fonction Value pour convertir une chaîne en nombre.

Les fonctions Average, Max, Min et Sum peuvent être déléguées lorsqu’elles sont utilisées avec une source de données qui prend en charge la délégation pour ces fonctions. Toutefois, StdevP et VarP ne peuvent pas être déléguées, quelles que soient les sources de données. Si la délégation est prise en charge, seule la première partie des données est récupérée, puis la fonction est appliquée localement. Le résultat peut donc être incomplet. Un point bleu apparaît au moment de l’autorisation pour vous rappeler cette limitation et vous suggérer d’utiliser des fonctions équivalentes pouvant être déléguées lorsque vous le pouvez. Pour plus d’informations, consultez la vue d’ensemble des délégations.

Syntaxe

Average( NumericalFormula1, [ NumericalFormula2, ... ] )
Max( NumericalFormula1, [ NumericalFormula2, ... ] )
Min( NumericalFormula1, [ NumericalFormula2, ... ] )
Sum( NumericalFormula1, [ NumericalFormula2, ... ] )
StdevP( NumericalFormula1, [ NumericalFormula2, ... ] )
VarP( NumericalFormula1, [ NumericalFormula2, ... ] )

  • *NumericalFormula(s)* : requis. Valeurs numériques à utiliser.

Average( Table, NumericalFormula )
Max( Table, NumericalFormula )
Min( Table, NumericalFormula )
Sum( Table, NumericalFormula )
StdevP( Table, NumericalFormula )
VarP( Table, NumericalFormula )

  • Table - Requis. Table à utiliser.
  • *NumericalFormula* : requis. Formule à évaluer pour chaque enregistrement. Le résultat de cette formule est utilisé pour l’agrégation. Vous pouvez utiliser des colonnes de la table dans la formule.

Exemples

Étape par étape

Supposons que vous ayez une source de données appelée Sales contenant une colonne CostPerUnit et une colonne UnitsSold et que vous définissiez la propriété Text d’une étiquette sur cette fonction :
Sum(Sales, CostPerUnit * UnitsSold)

L’étiquette affiche le total des ventes en multipliant les valeurs de ces colonnes pour chaque enregistrement, puis en additionnant les résultats de tous les enregistrements :
Calcul du total des ventes à partir des unités vendues et du coût unitaire

Prenons un autre exemple. Imaginons que vous ayez des curseurs appelés Slider1, Slider2 et Slider3 et une étiquette dont la propriété Text est définie sur cette formule :
Sum(Slider1.Value, Slider2.Value, Slider3.Value)

L’étiquette indique la somme de toutes les valeurs sur lesquelles les curseurs ont été définis.