Commande STATISTICS

Calcule des statistiques sur un ou plusieurs champs numériques ou DateHeure dans une table Analytics.

Syntaxe

STATISTICS <ON> {champ <...n>|ALL} <STD> <MODMEDQ> <NUMBER n> <TO {SCREEN|nom_fichier|PRINT}> <IF test> <WHILE test> <FIRST plage|NEXT plage> <APPEND>

Paramètres

Nom Description
ON champ <...n> | ALL

Indiquez un ou plusieurs champs numériques ou DateHeure sur lesquels générer des statistiques, ou indiquez ALL pour générer des statistiques sur tous les champs numérique ou DateHeure de la table Analytics.

STD

optionnel

Calcule l'écart-type des champs spécifiés, en plus des autres statistiques.

MODMEDQ

optionnel

Calcule le mode, la valeur médiane, les valeurs du premier quartile et du troisième quartile des champs spécifiés, en plus des autres statistiques.

NUMBER n

optionnel

Nombre de valeurs faibles et élevées à conserver durant le traitement. La valeur par défaut est 5.

TO SCREEN | nom_fichier | PRINT

optionnel

Emplacement vers lequel envoyer les résultats de la commande :

  • SCREEN affiche les résultats dans la zone d'affichage d'Analytics.
  • nom_fichier enregistre les résultats dans un fichier

    Indiquez nom_fichier sous forme de chaîne entre guillemets avec l'extension de fichier appropriée. Par exemple : TO "Sortie.TXT"

    Par défaut, le fichier est enregistré dans le dossier contenant le projet Analytics.

    Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier dans un autre dossier existant :

    • TO "C:\Sortie.TXT"
    • TO "Résultats\Sortie.TXT"
  • PRINT envoie les résultats vers l'imprimante par défaut

IF test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée uniquement sur les enregistrements remplissant la condition.

Remarque

La condition IF est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (WHILE, FIRST, NEXT).

WHILE test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée jusqu'à ce que la condition soit évaluée comme fausse ou lorsque la fin de la table est atteinte.

Remarque

Si vous utilisez WHILE conjointement avec FIRST ou NEXT, le traitement des enregistrements s'arrête dès qu'une limite est atteinte.

FIRST plage | NEXT plage

optionnel

Le nombre d'enregistrements à traiter :

  • FIRST pour commencer le traitement à partir du premier enregistrement jusqu'à ce que le nombre d'enregistrements spécifié soit atteint
  • NEXT pour commencer le traitement à partir de l'enregistrement actuellement sélectionné jusqu'à ce que le nombre d'enregistrements spécifié soit atteint

Utilisez plage pour indiquer le nombre d'enregistrements à traiter.

Si vous ignorez FIRST et NEXT, tous les enregistrements sont traités par défaut.

APPEND

optionnel

Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier.

Remarque

Vous devez vous assurer que la structure de la sortie de la commande et du fichier existant est identique :

  • les mêmes champs
  • le même ordre des champs
  • les champs correspondants ont la même longueur
  • les champs correspondants ont le même type de données

Analytics ajoute la sortie à un fichier existant sans tenir compte de sa structure, ce qui peut désordonner les données si la structure de la sortie et du fichier existant ne correspond pas.

Variables de sortie Analytics

Remarque

Si vous générez des statistiques pour plusieurs champs dans une table, les variables de sortie générées par le système contiennent des valeurs pour le premier champ répertorié uniquement.

Nom Contient
ABSn

Valeur absolue calculée par la commande.

AVERAGEn

Valeur moyenne calculée par la commande.

COUNTn

Nombre d'enregistrements calculé par la commande.

  • Si le nom de variable est COUNT1, elle stocke le nombre d'enregistrements de la dernière commande exécutée.
  • Si le nom de variable est COUNTn, où n est supérieur à 1, la variable stocke le nombre d'enregistrements d'une commande exécutée dans une commande GROUP.

    La valeur n est attribuée en fonction du numéro de ligne de la commande dans GROUP. Par exemple, si la commande se situe une ligne sous de la commande GROUP, la valeur COUNT2 lui est attribuée. Si la commande se situe quatre lignes sous de la commande GROUP, la valeur COUNT5 lui est attribuée.

HIGHn

5e valeur la plus élevée identifiée par la commande.

La 5e valeur la plus élevée est le paramètre par défaut. Il est possible de modifier le paramètre à l'aide du paramètre NUMBER. Par exemple, NUMBER 3 indique que la 3e valeur la plus élevée est stockée.

Remarque

Lorsqu'Analytics identifie la valeur la plus élevée, les valeurs dupliquées ne sont pas exclues. Par exemple, si dans l'ordre décroissant les valeurs sont 100, 100, 99, 98, la 3e valeur la plus élevée est 99 et non 98.

LOWn

5e valeur la plus basse identifiée par la commande.

La 5e valeur la plus basse est le paramètre par défaut. Il est possible de modifier le paramètre à l'aide du paramètre NUMBER. Par exemple, NUMBER 3 indique que la 3e valeur la plus basse est stockée.

Remarque

Lorsqu'Analytics identifie la valeur la plus basse, les valeurs dupliquées ne sont pas exclues. Par exemple, si dans l'ordre croissant les valeurs sont 1, 1, 2, 3, la 3e valeur la plus basse est 2 et non 3.

MAXn

Valeur maximale identifiée par la commande.

MEDIANn

Valeur médiane identifiée par la commande.

MINn Valeur minimale identifiée par la commande.
MODEn Valeur apparaissant le plus souvent qui a été identifiée par la commande.
Q25n Valeur du premier quartile (valeur du quartile inférieur) calculée par la commande.
Q75n Valeur du troisième quartile (valeur du quartile supérieur) calculée par la commande.
RANGEn Différence entre les valeurs maximale et minimale calculée par la commande.
STDDEVn Valeur d'écart-type calculée par la commande.
TOTALn

Valeur totale calculée par la commande.

La valeur n est 1, sauf si la commande TOTAL est incluse dans une commande GROUP, auquel cas la valeur n correspond au numéro de ligne de la commande TOTAL dans la commande GROUP.

Pour plus d'informations, consultez la section Commande GROUP.

Exemples

Génération de statistiques conditionnelles

Vous générez des statistiques sur le champ Quantité dans des enregistrements dont l'identifiant de classe de produit est 01 :

STATISTICS ON Quantité IF ClsProd = "01"
Guide de création de scripts ACL 14.1