Comando TOTAL

Calcula el valor total de uno o más campos de una tabla de Analytics.

Sintaxis

TOTAL {<FIELDS> campo_numérico <...n>|<FIELDS> ALL} <IF prueba> <WHILE prueba> <FIRST rango|NEXT rango>

Parámetros

Nombre Descripción
FIELDS campo_numérico <...n> | FIELDS ALL

Los campos numéricos para los cuales se debe calcular el total. Especifique ALL para calcular el total de cada campo numérico de la tabla.

IF prueba

opcional

Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta únicamente en los registros que cumplen la condición.

Nota

El parámetro IF se evalúa únicamente con los registros que quedan en la tabla después de aplicar los parámetros de alcance (WHILE, FIRST, NEXT).

WHILE prueba

opcional

Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta hasta que la condición se evalúa como falsa o hasta que se llega al final de la tabla.

Nota

Si usa WHILE junto con FIRST o NEXT, el procesamiento de registros se detiene al llegar a un límite.

FIRST rango | NEXT rango

opcional

La cantidad de registros que se procesarán:

  • FIRST comienza a procesar desde el primer registro hasta que se llega al número de registros especificado
  • NEXT comienza a procesar desde el registro seleccionado actualmente hasta que se llega al número de registros especificado

Utilice intervalo para especificar la cantidad de registros que se deben procesar.

Si omite FIRST y NEXT, se procesan todos los registros de forma predeterminada.

Variables de salida de Analytics

Nota

Si calcula el total de más de un campo de una tabla, la variable de salida generada por el sistema contiene el total para el primer campo enumerado únicamente.

Nombre Contiene
TOTALn

El valor total calculado por el comando.

El valor de n es 1 a menos que el comando TOTAL esté dentro de un comando GROUP, en cuyo caso el valor de n corresponde al número de línea del comando TOTAL dentro del comando GROUP.

Si desea obtener más información, consulte Comando GROUP.

Ejemplos

Totalización de los primeros 25 registros

Usted calcula el importe total del campo VALMERC para los primeros 25 registros de la tabla:

TOTAL FIELDS VALMERC FIRST 25

Observaciones

Cuándo usar TOTAL

Utilice TOTAL para comprobar la integridad y exactitud de los datos de origen y generar totales de control. El comando calcula la suma aritmética de los campos o expresiones especificados.

Guía de creación de scripts de ACL 14.1