4D Doc Center : Présentation des fonctions statistiques

4D v14.3

Présentation des fonctions statistiques

Les fonctions de ce thème effectuent des calculs sur des séries de valeurs.

Les fonctions Moyenne, Min, Max, Somme, Somme des carres, Ecart type et Variance s'appliquent soit à des champs, soit à des tableaux :

lorsqu'elles s'appliquent à des champs, elles utilisent la sélection courante d'enregistrements,
lorsqu'elles s'appliquent à des tableaux, elles utilisent les éléments du tableau.

A noter que lorsqu'elles s'appliquent à des champs, les fonctions Somme des carres, Ecart type et Variance ne peuvent être utilisées que pendant l'impression.

Toutes ces fonctions ne travaillent que sur des valeurs numériques et retournent des valeurs numériques.

Utilisation des fonctions statistiques hors impression

Lorsque les fonctions Moyenne, Min, Max et Somme sont utilisées sur un champ en-dehors d'une opération d'impression, il se peut qu'elles aient à charger chaque enregistrement de la sélection courante pour calculer le résultat. S'il y a beaucoup d'enregistrements, l'opération peut être longue. Pour limiter la durée du traitement, vous pouvez indexer le champ.

Note : Lorsque l'opération est longue, un thermomètre de progression apparaît. Ce thermomètre comporte un bouton Arrêt permettant à l’utilisateur d’interrompre l’opération. Si l’utilisateur clique sur ce bouton, la variable OK prend la valeur 0. Si l’opération est correctemen menée à son terme, la variable OK prend la valeur 1.

Utilisation des fonctions statistiques dans un état imprimé

Lorsque les fonctions statistiques sont utilisées dans un état, elles se comportent de façon particulière, car c'est l'état lui-même qui charge chaque enregistrement. Utilisez ces fonctions dans une méthode formulaire ou objet quand vous imprimez avec la commande IMPRIMER SELECTION ou quand vous imprimez en mode Développement à l'aide de la commande Imprimer dans le menu Fichier.

Lorsque vous utilisez ces fonctions dans un état, les valeurs retournées sont fiables uniquement dans le niveau 0 de rupture et seulement si la phase de traitement des ruptures est active. Cela signifie qu'elles ne sont utiles qu'en fin d'état, lorsque tous les enregistrements ont été traités.

Vous ne devez utiliser ces fonctions avec une méthode objet que dans une zone non-saisissable incluse dans la zone de rupture R0.

Pour mémoire : un champ passé comme paramètre à une fonction statistique doit être un numérique.