Aggregate Column

Aggregate Column

Tipo: aggregate-column  ·  Paquete: DataTable Activities v1.0.5  ·  Salida: number

Calcula un valor resumen sobre una columna de una DataTable: la suma, el conteo, el promedio, el mínimo o el máximo. Es la forma directa de obtener totales y métricas de un conjunto de datos — el total a cobrar, el número de registros, el promedio de un indicador.

Cómo funciona

Aplica la operation indicada sobre los valores de la column y devuelve un número.

• sum, avg, min y max toman cada celda que se pueda convertir a número (con punto decimal, 1500.50). Las celdas vacías o no numéricas se omiten sin error, y no cuentan para el promedio.
• count devuelve el número de filas de la tabla, sin mirar el contenido de la columna (cuenta también las celdas vacías).
• Si ninguna celda es numérica (o la tabla no tiene filas), sum, avg, min y max devuelven 0.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
table	DataTable	—	La DataTable.
column	string	—	Nombre de la columna a agregar.
operation	string	—	Operación: sum (suma) · count (conteo de filas) · avg (promedio) · min (mínimo) · max (máximo).

Parámetros opcionales

Ninguno.

Salida

Devuelve un number (double) con el resultado. count también se entrega como número (12 → 12.0); usa toInt(...) si lo necesitas entero.

Errores comunes

Mensaje	Causa y solución
'table' debe ser una DataTable.	table no evalúa a una DataTable.
'column' es obligatorio.	Falta el nombre de la columna.
Column '…' does not belong to table ….	La columna no existe en la tabla (mensaje de .NET, sin traducir). Revisa el nombre exacto.
Operación no soportada '…'. Usa: sum, count, avg, min, max.	operation no es uno de los valores válidos.

Ejemplo

Total y promedio de las ventas:

Aggregate Column   table = ventas   column = "Monto"   operation = sum   → output: total
Aggregate Column   table = ventas   column = "Monto"   operation = avg   → output: promedio
Log   message = "Total: " + total + " · Promedio: " + round(promedio, 2)

Agrega sobre filas filtradas

Para resumir solo un subconjunto, filtra primero y agrega sobre el resultado. Para totales por categoría (ej. total por cliente), usa Group By.

Actividades relacionadas

• Group By — agregados por grupo en vez de uno global.
• Filter DataTable — acotar las filas antes de agregar.
• Get Column — obtener todos los valores de la columna como lista.