Commande TOTAL
Calcule la valeur totale pour un ou plusieurs champs dans une table Analytics.
Syntaxe
TOTAL {<FIELDS> champ_numérique <...n>|<FIELDS> ALL} <IF test> <WHILE test> <FIRST plage|NEXT plage>
Paramètres
| Nom | Description |
|---|---|
| FIELDS champ_numérique <...n> | FIELDS ALL |
Champs numériques à totaliser. Indiquez ALL pour totaliser chacun des champs numériques de la table. |
|
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 :
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
Remarque
Si vous totalisez pour plusieurs champs dans une table, la variable de sortie générée par le système contient le total pour le premier champ répertorié uniquement.
| Nom | Contient |
|---|---|
| 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
Totalisation des 25 premiers enregistrements
Vous calculez le montant total du champ MKTVAL pour les 25 premiers enregistrements de la table.
TOTAL FIELDS MKTVAL FIRST 25
Remarques
Quand utiliser TOTAL
Utilisez TOTAL pour vérifier si les données sources sont complètes et précises, et pour générer des totaux de contrôle. La commande calcule la somme arithmétique des expressions ou des champs indiqués.
Guide de création de scripts ACL 14.1