Commande TOTAL
Concept Information
Calcule la valeur totale pour un ou plusieurs champs dans une table Analytics.
Syntaxe
TOTAL {<FIELDS> champ_numérique <...n>|<FIELDS> ALL <EXCLUDE champ_numérique <...n>>} <IF test> <WHILE test> <FIRST plage|NEXT plage>
Paramètres
| Nom | Description |
|---|---|
| FIELDS champ_numérique <...n> | FIELDS ALL |
Champ(s) numérique(s) à totaliser. Indiquez ALL pour totaliser chacun des champs numériques de la table. |
| EXCLUDE champ_numérique optionnel |
Valide uniquement dans le cas d'une totalisation à l'aide de FIELDS ALL. Le ou les champs à exclure de la commande. EXCLUDE vous permet de personnaliser le mot-clé ALL, en excluant les champs spécifiés. EXCLUDE doit suivre immédiatement FIELDS ALL, ou la dernière occurrence du mot-clé ALL si vous incluez des champs d'une ou de plusieurs tables associées. Par exemple : FIELDS ALL EXCLUDE champ_1 champ_2 FIELDS ALL nom_table_associée.ALL EXCLUDE champ_1 champ_2 |
|
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.
