Funciones de lista list-functions

differenceLists(listString,listString): listString

differenceLists(listInteger,listInteger): listInteger

differenceLists(listDecimal,listDecimal): listDecimal

differenceLists(listBoolean,listBoolean): listBoolean

differenceLists(listDuration,listDuration): listDuration

differenceLists(listDateTime,listDateTime): listDateTime

differenceLists(listDateTimeOnly,listDateTimeOnly): listDateTimeOnly

differenceLists(listDateOnly,listDateOnly): listDateOnly

differenceLists(['a','b','c'], ['b'])

Devuelve ['a','c'].

differenceLists(['a','a','b'], [])

Devuelve ['a','b'].

differenceLists([], ['a'])

Devuelve [].

distinct(<listInteger>)

Devuelve una lista de enteros.

distinct(<listDecimal>)

Devuelve una lista de decimales.

distinct(<listString>)

Devuelve una lista de cadenas.

distinct(<listDateTimeOnly>)

Devuelve una lista de horas de fecha sin tener en cuenta la zona horaria.

distinct(<listDateTime>)

Devuelve una lista de fechas y horas.

distinct(<listDateOnly>)

Devuelve una lista de fechas.

distinct(<listBoolean>)

Devuelve una lista de valores booleanos.

distinct(<listDuration>)

Devuelve una lista de duraciones.

distinct(<listObject>)

distinct(<listObject>,<string>)

Devuelve una lista de objetos.

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

Devuelve [10, 2].

distinctWithNull(<listInteger>)

Devuelve una lista de enteros.

distinctWithNull(<listDecimal>)

Devuelve una lista de decimales.

distinctWithNull(<listString>)

Devuelve una lista de cadenas.

distinctWithNull(<listDateTimeOnly>)

Devuelve una lista de horas de fecha sin tener en cuenta la zona horaria.

distinctWithNull(<listDateTime>)

Devuelve una lista de fechas y horas.

distinctWithNull(<listDateOnly>)

Devuelve una lista de fechas.

distinctWithNull(<listBoolean>)

Devuelve una lista de valores booleanos.

distinctWithNull(<listDuration>)

Devuelve una lista de duraciones.

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

Devuelve [10, 2, null]

filter(listObject, string, listString)

filter(listObject, string, listInteger)

filter(listObject, string, listDecimal)

filter(listObject, string, listDateTime)

filter(listObject, string, listDateTimeOnly)

filter(listObject, string, listDateOnly)

filter(listObject, string, listDuration)

filter(listObject, string, listBoolean)

Devuelve un listObject.

Este es un ejemplo de una carga útil pasada en un evento entrante “myevent”:

"productListItems": [{
   "id": "product1",
   "name": "the product 1",
   "price": 20
},{
   "id": "product2",
   "name": "the product 2",
   "price": 30
},{
   "id": "product3",
   "name": "the product 3",
   "price": 50
}]

Puede utilizar la siguiente expresión:

filter(
 @event{myevent.productListItems},
 "id",
 ["product2", "product3", "product4"]
)

Devuelve un listObject que contiene los dos objetos con “product2” y “product3” como id.

getListItem(<listInteger>,<index>)

Devuelve un entero.

getListItem(<listDecimal>,<index>)

Devuelve un valor decimal.

getListItem(<listString>,<index>)

Devuelve una cadena.

getListItem(<listDateTimeOnly>,<index>)

Devuelve una fecha y hora sin considerar la zona horaria.

getListItem(<listDateTime>,<index>)

Devuelve una fecha y hora.

getListItem(<listDateOnly>,<index>)

Devuelve una lista de fechas.

getListItem(<listBoolean>,<index>)

Devuelve un valor booleano.

getListItem(<listDuration>,<index>)

Devuelve una duración.

getListItem([10, 2, 3], 1)

Devuelve “2”

getListItem(["A", "B", "C"], 2)

Devuelve “C”

Ejemplos con un campo de evento “event.appVersion” con valor: “20.45.2.3434”

split(@event{event.appVersion}, "\\.")

Devuelve ["20", "45", "2", "3434"]

getListItem(split(@event{event.appVersion}, "\\."), 0)

Devuelve “20”

in(<integer>,<listInteger>)

in(<decimal>,<listDecimal>)

in(<string>,<listString>)

in(<boolean>,<listBoolean>)

in(<dateTimeOnly>,<listDateTimeOnly>)

in(<dateTime>,<listDateTime>)

in(<dateOnly>,<listDateOnly>)

in(<duration>,<listDuration>)

Devuelve un valor booleano.

in(4,[4,5,3,4])

Devuelve verdadero.

in(8,[4,5,3,4])

Devuelve falso.

in(#{ExperiencePlatform.ProfileFieldGroup.profile.person.gender}, ["male"])

intersect(listString,listString): listString

intersect(listDecimal,listDecimal): listDecimal

intersect(listInteger,listInteger): listInteger

intersect(listDateTime,listDateTime): listDateTime

intersect(listDateTimeOnly,listDateTimeOnly): listDateTimeOnly

intersect(listDateOnly,listDateOnly): listDateOnly

intersect(listDuration,listDuration): listDuration

intersect(listBoolean,listBoolean): listBoolean

Devuelve una lista.

intersect(
    ["sports", "news", "documentary"],
    ["sports", "movies", "documentary"]
)

Devuelve [“deportes”, “noticias”]

intersect(
    #{ExperienceDataPlatform.profile.interests},
    ["sports", "documentary"]
)

Devuelve elementos comunes entre atributos de perfil y una lista de categorías determinada.

intersect(
    #{ExperienceDataPlatform.profile.interests},
        @event{myEvent.sport_interests}
)

Devuelve elementos comunes entre atributos de perfil y un campo de evento determinado.

limit(<listString>,<integer>)

limit(<listString>,<integer>,<boolean>)

Devuelve una lista de cadenas.

limit(<listInteger>,<integer>)

limit(<listInteger>,<integer>,<boolean>)

Devuelve una lista de enteros.

limit(<listDecimal>,<integer>)

limit(<listDecimal>,<integer>,<boolean>)

Devuelve una lista de decimales.

limit(<listBoolean>,<integer>)

limit(<listBoolean>,<integer>,<boolean>)

Devuelve una lista de valores booleanos.

limit(<listDateOnly>,<integer>)

limit(<listDateOnly>,<integer>,<boolean>)

Devuelve una lista de fechas.

limit(<listDateTimeOnly>,<integer>)

limit(<listDateTimeOnly>,<integer>,<boolean>)

Devuelve una lista de horas de fecha sin tener en cuenta la zona horaria.

limit(<listDateTime>,integer>)

limit(<listDateTime>,<integer>,<boolean>)

Devuelve una lista de fechas y horas.

limit(<listDuration>,<integer>)

limit(<listDuration>,<integer>,<boolean>)

Devuelve una lista de duraciones.

limit(<listObject>,<integer>)

limit(<listObject>,<integer>,<boolean>)

Devuelve una lista de objetos.

limit(["A", "B", "C", "D", "E"], 3)

Devuelve ["A","B","C"].

limit(["A", "B", "C", "D", "E"], 3, false)

Devuelve ["C","D","E"].

listSize(<listInteger>)

listSize(<listDecimal>)

listSize(<listString>)

listSize(<listBoolean>)

listSize(<listDateTimeOnly>)

listSize(<listDateTime>)

listSize(<listDateOnly>)

listSize(<listDuration>)

Devuelve un entero.

listSize(<listObject>)

listSize([10,2,3])

Devuelve 3.

listSize(@event{my_event.productListItems})

Devuelve el número de objetos de una matriz determinada de objetos (tipo listObject).

mergeLists(listString,listString,boolean): listString

mergeLists(listInteger,listInteger,boolean): listInteger

mergeLists(listDecimal,listDecimal,boolean): listDecimal

mergeLists(listBoolean,listBoolean,boolean): listBoolean

mergeLists(listDuration,listDuration,boolean): listDuration

mergeLists(listDateTime,listDateTime,boolean): listDateTime

mergeLists(listDateTimeOnly,listDateTimeOnly,boolean): listDateTimeOnly

mergeLists(listDateOnly,listDateOnly,boolean): listDateOnly

mergeLists(['a','b'], ['b','c'], true)

Devuelve ['a','b','c'].

mergeLists(['a','b'], ['b','c'], false)

Devuelve ['a','b','b','c'].

serializeList(<listInteger>,<string>,<boolean>)

serializeList(<listDecimal>,<string>,<boolean>)

serializeList(<listString>,<string>,<boolean>)

serializeList(<listBoolean>,<string>,<boolean>)

serializeList(<listDateTimeOnly>,<string>,<boolean>)

serializeList(<listDateTime>,<string>,<boolean>)

serializeList(<listDateOnly>,<string>,<boolean>)

serializeList(<listDuration>,<string>,<boolean>)

Devolver una cadena.

serializeList(["Hello","World"], " ", false)

Devuelve “Hello World”.

serializeList(["Hello", "World"], ",", true)

Devuelve “Hello”,“World”.

sort(<listInteger>,<boolean>)

Devuelve una lista de enteros.

sort(<listDecimal>,<boolean>)

Devuelve una lista de decimales.

sort(<listString>,<boolean>)

Devuelve una lista de cadenas.

sort(<listDateTimeOnly>,<boolean>)

Devuelve una lista de horas de fecha sin tener en cuenta la zona horaria.

sort(<listDateTime>,<boolean>)

Devuelve una lista de fechas y horas.

sort(<listDateOnly>,<boolean>)

Devuelve una lista de fechas.

sort(<listBoolean>,<boolean>)

Devuelve una lista de valores booleanos.

sort(<listObject>,<string>,<boolean>)

Devuelve una lista de objetos.

sort(["A", "C", "B"], true)

Devuelve ["A","B","C"].

sort([1, 3, 2], false)

Devuelve [3, 2, 1].

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

Devuelve el listObject ordenado por atributo SKU (orden ascendente)

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 lista disponibles en las expresiones de recorrido de AJO, y abarca cómo filtrar, ordenar, deduplicar, comprobar suscripciones, limitar, serializar, combinar, restar y buscar intersecciones de listas y matrices.

Intenciones:

• Quitar valores duplicados de una lista mediante distinct (omitiendo valores nulos) o distinctWithNull (conservando valores nulos)
• Filtre un listObject para devolver únicamente objetos que coincidan con valores de clave específicos mediante filter
• Recuperar un elemento en un índice específico de una lista utilizando getListItem
• Comprobar si existe un valor en una lista con in
• Buscar elementos comunes entre dos listas utilizando intersect
• Combine dos listas, con o sin anulación de duplicación, usando mergeLists
• Restar una lista de otra (establecer diferencia) usando differenceLists
• Devolver los primeros o últimos elementos N de una lista utilizando limit
• Contar el número total de elementos de una lista utilizando listSize
• Convertir una lista en una cadena delimitada usando serializeList
• Ordenar una lista en orden ascendente o descendente utilizando sort

Glosario:

• listObject: una lista de objetos complejos que debe ser una referencia de campo; no puede contener objetos nulos (específicos del producto)
• keyAttributeName: parámetro de cadena opcional utilizado con distinct, filter y sort para identificar qué atributo de objeto usar para la deduplicación, el filtrado o la ordenación (específico del producto)
• intersect: una operación set devuelve solamente los elementos presentes en ambas listas de entrada
• mergeLists: Una operación set que devuelve la unión (deduplicada) o concatenación (con duplicados) de dos listas, según el parámetro deduplicate (específico del producto)
• differenceLists: Una operación set devuelve los elementos de la primera lista que no están presentes en la segunda lista (específica del producto)

Protecciones:

• distinctWithNull no admite el tipo de parámetro <listObject>
• filter requiere que el parámetro listObject sea una referencia de campo, no un literal en línea
• listSize en un listObject requiere que la lista sea una referencia de campo; un listObject no puede contener objetos nulos
• serializeList no admite el tipo listObject
• mergeLists y differenceLists solo admiten tipos de listas escalares (cadena, entero, decimal, booleano, dateTime, dateTimeOnly, dateOnly, duration); no se admite listObject
• El parámetro deduplicate de mergeLists debe ser un literal true/false, no una expresión booleana dinámica
• differenceLists siempre anula la duplicación de su resultado; no hay opción de conservar duplicados

Terminología:

• Nombre canónico: Funciones de lista — Acrónimo: none — variantes: funciones de colección, funciones de matriz
• Sinónimos: “listSize” = “count list elements”; “serializeList” = “join list to string”
• No confunda: “distinct” (ignora los valores nulos) ≠ “distinctWithNull” (conserva null como valor distinto)
• No confunda: “limit” con el tercer parámetro true (devuelve los primeros N elementos) ≠ “limit” con false (devuelve los últimos N elementos)
• No confunda: “intersect” (elementos comunes entre dos listas) ≠ “filter” (elementos que coinciden con valores clave específicos)
• No confunda: “mergeLists” (combina dos listas, unión o concatenación) ≠ “differenceLists” (resta una lista de otra) ≠ “intersect” (solo elementos comunes)

PREGUNTAS MÁS FRECUENTES:

• Q: ¿Cómo obtengo los primeros 3 elementos de una lista? — Use limit(myList, 3) o limit(myList, 3, true); el valor predeterminado es devolver los primeros elementos.
• Q: ¿Cómo obtengo los últimos 3 elementos de una lista? — Usar limit(myList, 3, false).
• Q: ¿Cuál es la diferencia entre distinct y distinctWithNull? — distinct ignora los valores nulos y los excluye del resultado; distinctWithNull trata el valor nulo como un valor distinto e incluye una entrada nula si hay valores nulos.
• Q: ¿Puedo filtrar una lista de cadenas con filter? — No, filter solo funciona en listObject; para las listas escalares, use in o distinct para la deduplicación.
• Q: ¿Cómo puedo comprobar si un valor está en una lista? — Use in(value, myList), que devuelve true si el valor se encuentra en la lista.
• Q: ¿Puedo ordenar un listObject por un atributo específico? — Sí, usar sort(@event{...}, "attributeName", true), donde el segundo parámetro es el nombre del atributo y el tercero es la dirección de ordenación (verdadero = ascendente).
• Q: ¿Cómo combino dos listas y elimino duplicados? — Usar mergeLists(list1, list2, true).
• Q: ¿Cómo se combinan dos listas pero se mantienen los valores duplicados? — Usar mergeLists(list1, list2, false).
• Q: ¿Cómo encuentro los elementos de una lista que no están en otra? — Use differenceLists(list1, list2), que devuelve los elementos de list1 que no están presentes en list2.
• Q: ¿Cuál es la diferencia entre intersect y differenceLists? — intersect devuelve elementos comunes a ambas listas; differenceLists devuelve elementos de la primera lista que están ausentes de la segunda.