Comando TOTAL

Información de concepto

Totalización de campos

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

Sintaxis

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

Parámetros

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

El o 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.

EXCLUDE campo_numérico

opcional

Solo tiene validez al calcular el total utilizando FIELDS ALL.

El o los campos que se deben excluir del comando. EXCLUDE le permite ajustar la palabra clave de ALL, excluyendo campos especificados.

EXCLUDE debe estar inmediatamente después de FIELDS ALL o de la ocurrencia final de la palabra clave de ALL si incluye campos de una o más tablas relacionadas. Por ejemplo:

FIELDS ALL EXCLUDE campo_1 campo_2
FIELDS ALL nombre_tabla_relacionada.ALL EXCLUDE campo_1 campo_2

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.