Funciones de agregación aggregation-functions

Sintaxis

Parámetros

Tipos admitidos:

• listInteger
• listDecimal
• decimal
• entero

Firmas y tipo devuelto

avg(<listInteger>)

avg(<listDecimal>)

avg(<decimal>,<decimal>)

avg(<decimal>,<integer>)

avg(<integer>,<decimal>)

avg(<integer>,<integer>)

Devuelve un valor decimal.

Ejemplos

avg(@event{BarBeacon.inventory},5)

avg([10,3,8])

Devuelve 7.0.

avg(10.2, 3)

Devuelve 6.6.

Sintaxis

count(<listAny>)

count(<listObject>)

Parámetros

table 0-row-3 1-row-3
Parámetro	Tipo	Descripción
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly o listObject	Lista para procesar. Para listObject, debe ser una referencia de campo. Un listObject no puede contener un objeto nulo.

Firmas y tipo devuelto

count(<listAny>)

Devuelve un entero.

Ejemplos

count([10,2,10,null])

Devuelve 3.

count(@event{my_event.productListItems})

Devuelve el número de objetos de una matriz determinada de objetos (tipo listObject). Nota: un listObject no puede contener un objeto nulo

Sintaxis

Parámetros

table 0-row-2 1-row-2
Parámetro	Tipo
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly

Firmas y tipo devuelto

countOnlyNull(<listAny>)

Devuelve un entero.

Ejemplos

countOnlyNull([10,2,10,null])

Devuelve 1.

Sintaxis

Parámetros

table 0-row-2 1-row-2
Parámetro	Tipo
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly

Firmas y tipo devuelto

countWithNull(<listAny>)

Devuelve un entero.

Ejemplos

countWithNull([10,2,10,null])

Devuelve 4.

Sintaxis

Parámetros

table 0-row-3 1-row-3 2-row-3
Parámetro	Tipo	Descripción
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly o listObject	Lista para procesar. Para listObject, debe ser una referencia de campo.
keyAttributeName	cadena	Este parámetro es opcional y solo para listObject. Si no se proporciona el parámetro, un objeto se considera duplicado si todos los atributos tienen los mismos valores. De lo contrario, un objeto se considera duplicado si el atributo dado tiene el mismo valor.

Firmas y tipo devuelto

distinctCount(<listAny>)

Devuelve un entero.

distinctCount(<listObject>)

distinctCount(<listObject>,<string>)

Devuelve una lista de objetos.

Ejemplos

distinctCount([10,2,10,null])

Devuelve 2.

distinctCount(@event{my_event.productListItems})

Devuelve el número de objetos estrictamente distintos en la matriz de objetos determinada (tipo listObject).

distinctCount(@event{my_event.productListItems}, "SKU")

Devuelve el número de objetos que tienen un valor de atributo “SKU” distinto {}.

Sintaxis

Parámetros

table 0-row-2 1-row-2
Parámetro	Tipo
listToProcess	listString, listBoolean, listInteger, listDecimal, listDuration, listDateTime, listDateTimeOnly, listDateOnly

Firmas y tipo devuelto

distinctCountWithNull(<listAny>)

Devuelve un entero.

Ejemplos

distinctCountWithNull([10,2,10,null])

Devuelve 3.

Sintaxis

Parámetros

• listDuration
• listInteger
• listDecimal
• listDateTime
• listDateTimeOnly
• listDateOnly
• duration
• entero
• decimal
• dateTime
• dateTimeOnly

Firmas y tipos devueltos

max(<listDuration>)

Devuelve una duración.

max(<listInteger>)

Devuelve una duración.

max(<listDateTimeOnly>)

Devuelve una fecha y hora sin considerar la zona horaria.

max(<listDateTime>)

Devuelve una fecha y hora.

max(<listDateOnly>)

Devuelve una fecha.

max(<listDecimal>)

Devuelve un valor decimal.

max(<decimal>,<decimal>)

Devuelve un valor decimal.

max(<duration>,<duration>)

Devuelve una duración.

max(<dateTime>,<dateTime>)

Devuelve una fecha y hora.

max(<dateTimeOnly>,<dateTimeOnly>)

Devuelve una fecha y hora sin considerar la zona horaria.

max(<integer>,<integer>)

Devuelve un entero.

Ejemplos

max(@event{BarBeacon.inventory},5)

max([10,3,8])

Devuelve 10.

max([10,null,8])

Devuelve 10.

Sintaxis

Parámetros

• listDuration
• listInteger
• listDecimal
• listDateTime
• listDateTimeOnly
• listDateOnly
• duration
• entero
• decimal
• dateTime
• dateTimeOnly

Firmas y tipos devueltos

min(<listDuration>)

Devuelve una duración.

min(<listInteger>)

Devuelve una duración.

min(<listDateTimeOnly>)

Devuelve una fecha y hora sin considerar la zona horaria.

min(<listDateTime>)

Devuelve una fecha y hora.

min(<listDateOnly>)

Devuelve una fecha.

min(<listDecimal>)

Devuelve un valor decimal.

min(<decimal>,<decimal>)

Devuelve un valor decimal.

min(<duration>,<duration>)

Devuelve una duración.

min(<dateTime>,<dateTime>)

Devuelve una fecha y hora.

min(<dateTimeOnly>,<dateTimeOnly>)

Devuelve una fecha y hora sin considerar la zona horaria.

min(<integer>,<integer>)

Devuelve un entero.

Ejemplos

min(@event{BarBeacon.inventory},5)

min([10,3,8])

Devuelve 3.

min([10,null,8])

Devuelve 8.

Sintaxis

Parámetros

• listInteger
• listDecimal
• duration
• entero
• decimal

Firmas y tipos devueltos

sum(<listDecimal>)

Devuelve un valor decimal.

sum(<listInteger>)

Devuelve un entero.

sum(<integer>,<integer>)

Devuelve un entero.

sum(<decimal>,<decimal>)

Devuelve un valor decimal.

Ejemplos

sum(@event{BarBeacon.inventory},5)

sum([10,3,8])

Devuelve 21.

sum([10.5,null,8.1])

Devuelve 18.6.

Referencia de conocimientos de AI

Esta sección contiene conocimientos estructurados destinados a apoyar la interpretación, la recuperación y la respuesta a preguntas relacionadas con este tema.

Para una comprensión completa, esta información debe combinarse con la documentación de esta página. Ninguna de las fuentes pretende ser independiente; la página describe la función, mientras que esta sección proporciona contexto adicional que ayuda a desambiguar la terminología, la intención, la aplicabilidad y las restricciones.

• TL;DR: Esta página documenta todas las funciones de agregación disponibles en expresiones de recorrido de AJO, y cubre cómo calcular promedios, sumas, valores mínimo/máximo, recuentos y recuentos distintos en listas y matrices.

Intenciones:

• Calcular el promedio de una lista de valores numéricos mediante avg
• Suma de valores numéricos en una lista o de campos de eventos usando sum
• Buscar el valor mínimo o máximo en una lista usando min o max
• Contar elementos no nulos, nulos o todos los elementos de una lista usando count, countOnlyNull o countWithNull
• Contar valores distintos en una lista, con o sin valores nulos, utilizando distinctCount o distinctCountWithNull
• Filtrar objetos únicos en un listObject por un atributo clave específico utilizando distinctCount con un parámetro clave

Glosario:

• listObject: una lista de objetos complejos (referencias de campo); no puede contener objetos nulos (específicos de producto)
• listAny: Una lista de cualquier tipo escalar admitido (cadena, booleano, entero, decimal, duración, dateTime, dateTimeOnly, dateOnly) (específico del producto)
• Valor nulo: Un elemento ausente o indefinido en una lista; la mayoría de las funciones de agregación omiten los valores nulos a menos que la función los controle explícitamente (por ejemplo, countOnlyNull, countWithNull, distinctCountWithNull)

Protecciones:

• countOnlyNull, countWithNull y distinctCountWithNull no admiten el tipo de parámetro <listObject>
• distinctCount en listObject requiere que la lista sea una referencia de campo, no un literal en línea
• count en listObject requiere que la lista sea una referencia de campo; un listObject no puede contener objetos nulos

Terminología:

• Nombre canónico: Aggregation functions — Acrónimo: none — variants: aggregate functions, collection functions
• Sinónimos: “count” = “count non-null elements”; “countWithNull” = “count all elements included nulls”
• No confunda: “distinctCount” (ignora los valores nulos) ≠ “distinctCountWithNull” (incluye los valores nulos como un valor distinto)

PREGUNTAS MÁS FRECUENTES:

• Q: ¿avg incluye valores nulos en su cálculo? — No, avg omite automáticamente los valores nulos.
• Q: ¿Cuál es la diferencia entre count y countWithNull? — count excluye del total los valores nulos, mientras que countWithNull cuenta todos los elementos, incluidos los valores nulos.
• Q: ¿Puedo usar countOnlyNull en un listObject? — No, <listObject> no es compatible con countOnlyNull, countWithNull o distinctCountWithNull.
• Q: ¿Cómo se cuentan los objetos distintos de una matriz en función de un atributo específico? — Use distinctCount(@event{...}, "attributeName") proporcionando el nombre de atributo clave como segundo parámetro.
• Q: ¿Qué devuelve max cuando la lista contiene valores nulos? — max ignora los valores nulos y devuelve el máximo entre los elementos no nulos.