Commande COUNT

Compte le nombre total d'enregistrements dans la vue active ou uniquement les enregistrements qui remplissent la condition spécifiée.

Syntaxe

COUNT <IF test> <WHILE test> <FIRST plage|NEXT plage>

Paramètres

Nom	Description
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.

Nom

Description

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.

Variables de sortie Analytics

Nom	Contient
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.

Nom

Contient

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.

Exemples

Stockage de COUNT1

Le résultat de la commande COUNT est stocké dans la variable de sortie COUNT1. Vous pouvez récupérer et stocker cette valeur dans une variable définie par l'utilisateur.

La commande COUNT remplace la variable COUNT1 chaque fois qu'elle est exécutée. Par conséquent, la valeur doit être stockée dans une variable définie par l'utilisateur avant la deuxième exécution de la commande, et après l'application du filtre à la table :

OPEN AdresseClient 
COUNT 
TotalEnr = COUNT1 
SET FILTER TO DateModification > '20100101' 
COUNT 
TotalEnrFiltrés = COUNT1

Remarques

Quand utiliser COUNT

La commande COUNT permet de compter le nombre d'enregistrements dans une table Analytics ou le nombre d'enregistrements qui remplissent une condition test particulière. Si aucun test n'est spécifié, le nombre total d'enregistrements de la table Analytics s'affiche.

Impact des filtres sur COUNT

Si un filtre est appliqué à une vue, la commande compte le nombre d'enregistrements restant dans la vue une fois la condition de filtrage appliquée.

[ Retour au début ]

Guide de création de scripts ACL 14.1