Comando SUMMARIZE

Agrupa registros sobre la base de valores idénticos en uno o más campos de caracteres, numéricos o de fechahora. Cuenta la cantidad de registros en cada grupo y también calcula el subtotal de campos numéricos especificados para cada grupo.

Sintaxis

SUMMARIZE ON campo_clave  <...n> <SUBTOTAL campo_numérico <...n>|SUBTOTAL ALL> <OTHER campo <...n>|OTHER ALL> <TO {SCREEN|nombre_tabla|PRINT}> <IF prueba> <WHILE prueba> <FIRST rango|NEXT rango> <PRESORT> <APPEND> <OPEN> <LOCAL> <HEADER texto_encabezado> <FOOTER texto_pie_de_página> <STATISTICS> <MODMEDQ> <STDEV> <CPERCENT> <ISOLOCALE código_lugar>

Parámetros

Nombre Descripción
ON campo_clave <...n>

Uno o más campos de caracteres, numéricos o de fechahora para resumir. Los diferentes campos se deben separar con espacios y pueden ser distintos tipos de datos.

SUBTOTAL campo_numérico <...n> | SUBTOTAL ALL

opcional

Uno o más campos numéricos o expresiones que se subtotalizarán para cada grupo.

Múltiples campos se deben separar con espacios. Especifique ALL para calcular subtotales de todos los campos numéricos de la tabla.

OTHER campo<...n> | OTHER ALL

opcional

Uno o más campos adicionales para incluir en la salida.

  • campo <...n> incluya el o los campos especificados
  • ALL incluya todos los campos de la tabla que no se especifican como campos clave o campos de subtotal

Utilice OTHER únicamente con campos que contienen el mismo valor para todos los registros de cada grupo resumido. Si especifica un campo que contenga valores que son diferentes para un grupo resumido, sólo se mostrará el valor del primer registro del grupo, el cual no es significativo.

Por ejemplo:

  • resumir una tabla por el número de cliente "otro campo" adecuado podría ser Nombre del cliente. En general, el nombre del cliente es idéntico para todos los registros con el mismo número de cliente.
  • resumir una tabla de proveedor por estado "otro campo" inapropiado es Ciudad. Solo se incluye la primera ciudad de cada estado en la salida. En este caso, es mejor resumir utilizando como campos clave tanto el estado como la ciudad, en ese orden.
TO SCREEN | nombre_tabla | PRINT

El lugar al que se deben enviar los resultados del comando:

  • SCREEN muestra los resultados en el área de visualización de Analytics
  • nombre_tabla guarda los resultados en una tabla de Analytics

    Especifique el nombre_tabla como una cadena entre comillas con la extensión de archivo .FIL. Por ejemplo: TO "Salida.FIL"

    Por valor predeterminado, el archivo de datos de la tabla (.FIL) se guarda en la carpeta que contiene el proyecto de Analytics.

    Utilice una ruta de archivo absoluta o relativa para guardar el archivo de datos en una carpeta existente o una diferente:

    • TO "C:\Salida.FIL"
    • TO "Resultados\Salida.FIL"

    Nota

    Los nombres de las tablas tienen un límite de 64 caracteres alfanuméricos, sin incluir la extensión .FIL. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número.

  • PRINT envía los resultados a la impresora predeterminada
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.

PRESORT

opcional

Ordena la tabla por el campo primario antes de ejecutar el comando.

Nota

No puede utilizar PRESORT dentro del comando GROUP.

Si utiliza PRESORT

Si usa PRESORT, la salida se ordena y contiene un solo grupo exclusivo para cada conjunto de valores idénticos o combinación idéntica de valores, en el campo o los campos clave.

Consejo

Si la tabla de entrada ya está ordenada, puede ahorrar tiempo de procesamiento si no especifica PRESORT.

Si no utiliza PRESORT

Si no utiliza PRESORT, los resultados de la salida utilizan el orden de la tabla de entrada.

Si el o los campos clave contienen valores idénticos que no están en secuencia, los resultados de la salida contienen más de un grupo para cada conjunto de valores idénticos o combinación idéntica de valores.

Nota

Según el contexto, contar con más de un grupo para cada conjunto de valores idénticos o combinación de valores idénticos puede ir en contra de la finalidad del resumen.

APPEND

opcional

Anexa la salida del comando al final de un archivo existente en lugar de sobrescribir el archivo.

Nota

Debe asegurarse de que la estructura de la salida del comando y del archivo existente sean idénticas:

  • los mismos campos
  • el mismo orden de campos
  • los campos coincidentes son de la misma longitud
  • los campos coincidentes tienen el mismo tipo de datos

Analytics anexa la salida a un archivo existente sin importar cuál sea su estructura. Si la estructura de la salida y la del archivo existente no coinciden, es posible que los datos que se obtengan estén incompletos, mezclados o sean imprecisos.

OPEN

opcional

Abre la tabla creada por el comando después de la ejecución del comando. Solo es válido si el comando crea una tabla de salida.

LOCAL

opcional

Guarda el archivo de salida en la misma ubicación que el proyecto de Analytics.

Nota

Aplicable únicamente al ejecutar el comando en una tabla de servidor con un archivo de salida que es una tabla de Analytics.

HEADER texto_encabezado

opcional

El texto que se debe insertar en la parte superior de cada página de un reporte.

texto_encabezado_de_página se debe especificar como una cadena entre comillas. El valor anula la variable de sistema HEADER de Analytics.

FOOTER texto_pie_de_página

opcional

El texto que se debe insertar en la parte inferior de cada página de un reporte.

texto_pie_de_página se debe especificar como una cadena entre comillas. El valor anula la variable de sistema FOOTER de Analytics.

STATISTICS

opcional

Nota

No se puede usar, a menos que también se especifique SUBTOTAL.

Calcula los valores promedio, mínimo y máximo para todos los campos SUBTOTAL.

MODMEDQ

opcional

Nota

No se puede usar, a menos que también se especifique SUBTOTAL.

Especifica que se calculan los valores de moda, mediana, primer cuartil y tercer cuartil para todos los campos SUBTOTAL.

STDEV

opcional

Nota

No se puede usar, a menos que también se especifique SUBTOTAL.

Calcula la desviación estándar y el porcentaje del total para todos los campos SUBTOTAL.

CPERCENT

opcional

Calcula el porcentaje del recuento de registros para cada grupo.

ISOLOCALE

opcional

Nota

Aplicable únicamente en la edición Unicode de Analytics.

El idioma (configuración regional) del sistema en el formato idioma_país. Por ejemplo, para francés de Canadá, ingrese el código fr_ca.

Use los siguientes códigos:

  • idioma códigos de idioma estándar ISO 639
  • país códigos de país estándar ISO 3166

    Si no especifica un código de país, se utiliza el país predeterminado para el idioma.

Si no utiliza ISOLOCALE, se utiliza la configuración regional predeterminada del sistema.

Ejemplos

Importe total de transacciones por cliente

Usted resume una tabla de cuentas por cobrar por el campo Número_cliente y calcula el subtotal del campo Importe_trans. La salida se agrupa por cliente e incluye el importe total de las transacciones para cada cliente:

OPEN Cuentas_por_cobrar
SUMMARIZE ON Número_cliente SUBTOTAL Importe_trans TO "Total_cliente.FIL" PRESORT

Importe total de las transacciones por cliente por fecha de transacción

Usted resume una tabla de cuentas por cobrar por el campo Número_cliente y los campos Importe_trans. Calcula el subtotal del campo Importe_trans.

La salida se agrupa por cliente (y, dentro del cliente, por fecha) e incluye el importe total de las transacciones para cada cliente por cada fecha en la que el cliente hizo una transacción.

OPEN Cuentas_por_cobrar
SUMMARIZE ON Número_cliente Fecha_trans SUBTOTAL Importe_trans TO "Total_cliente_por_fecha.FIL" PRESORT

Importes total, promedio, mínimo y máximo de las transacciones por cliente y por fecha de transacción

Usted agrega STATISTICS al ejemplo anterior.

Además del importe de las transacciones subtotalizadas para cada cliente para cada fecha en la que el cliente realizó una transacción, también calcula los importes promedio, mínimo y máximo de las transacciones para cada cliente y para cada fecha:

OPEN Cuentas_por_cobrar
SUMMARIZE ON Número_cliente Fecha_trans SUBTOTAL Importe_trans TO "Estadísticas_cliente_por_fecha.FIL" PRESORT STATISTICS

Importes de transacciones idénticos, misma fecha

Usted resume una tabla de transacciones de tarjeta de crédito por los campos Fecha de transacción e Importe_de_la_transacción.

La salida se agrupa por fecha y, dentro de la fecha, por importe. Puede utilizar el recuento asociado para identificar transacciones con importes idénticos y fechas idénticas:

OPEN Trans_CC
SUMMARIZE ON Fecha_trans Importe_trans TO "Transacciones_por_fecha_importe.FIL" OPEN PRESORT 
SET FILTER TO COUNT > 1

Observaciones

Nota

Si desea obtener más información sobre la forma en la que funciona este comando, consulte Guía de ayuda.

Cómo funciona

SUMMARIZE agrupa registros que tienen el mismo valor, o la misma combinación de valores, en uno o más campos de caracteres, numéricos o de fechahora. La salida contiene un registro único para cada grupo, con un recuento de la cantidad de registros en la tabla de origen que pertenecen al grupo.

Subtotal y estadísticas: los cálculos y los nombres de campo de la tabla de salida

Puede usar uno o más parámetros opcionales para realizar cálculos estadísticos en cualquier campo SUBTOTAL que especifique. Los cálculos estadísticos se desglosan por grupo en la salida:

Parámetro opcional Título alternativo de columna (nombre visible) en la tabla de salida Nombre del campo en la tabla de salida Cálculo realizado en el campo subtotal
SUBTOTAL Total + título alternativo de columna subtotalizada nombre del campo subtotalizado Valores subtotalizados para cada grupo
STATISTICS Promedio + título alternativo de columna subtotalizada

_anombre del campo subtotalizado

El valor promedio para cada grupo

Mínimo + título alternativo de columna subtotalizada

m_nombre del campo subtotalizado

El valor mínimo para cada grupo

Máximo + título alternativo de columna subtotalizada

x_nombre del campo subtotalizado

El valor máximo para cada grupo

MODMEDQ

Mediana + título alternativo de columna subtotalizada

c_nombre del campo subtotalizado

El valor de la mediana para cada grupo

  • Conjuntos de valores impares: el valor del centro
  • Conjuntos de valores pares: el promedio de los dos valores del centro

Moda + título alternativo de columna subtotalizada

o_nombre del campo subtotalizado

El valor que ocurre con mayor frecuencia en cada grupo

  • Muestra "N/D" si ningún valor aparece más de una vez
  • En caso de empate, muestra el valor más bajo

Q25 + título alternativo de columna subtotalizada

q_nombre del campo subtotalizado

El valor de primer cuartil de cada grupo (valor de cuartil inferior)

  • El resultado es un valor interpolado sobre la base de un algoritmo de Analytics
  • Produce el mismo resultado que las funciones QUARTILE y QUARTILE.INC de Microsoft Excel

Q75 + título alternativo de columna subtotalizada

p_nombre del campo subtotalizado

El valor de tercer cuartil de cada grupo (valor de cuartil superior)

  • El resultado es un valor interpolado sobre la base de un algoritmo de Analytics
  • Produce el mismo resultado que las funciones QUARTILE y QUARTILE.INC de Microsoft Excel
STDEV

STDDEV + título alternativo de columna subtotalizada

d_nombre del campo subtotalizado

La desviación estándar de cada grupo

% Campo + título alternativo de columna subtotalizada

f_nombre del campo subtotalizado

El subtotal de cada grupo expresado como un porcentaje del total del campo

CPERCENT Porcentaje de recuento COUNT_PERCENTAGE El porcentaje de registros de la tabla de origen que pertenecen a cada grupo

Nota

No requiere un campo de subtotal

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