Listar funções list-functions

distinct(<listInteger>)

Retorna uma lista de inteiros.

distinct(<listDecimal>)

Retorna uma lista de decimais.

distinct(<listString>)

Retorna uma lista de strings.

distinct(<listDateTimeOnly>)

Retorna uma lista de datetimes sem considerar o fuso horário.

distinct(<listDateTime>)

Retorna uma lista de datetimes.

distinct(<listDateOnly>)

Retorna uma lista de datas.

distinct(<listBoolean>)

Retorna uma lista de booleanos.

distinct(<listDuration>)

Retorna uma lista de durações.

distinct(<listObject>)

distinct(<listObject>,<string>)

Retorna uma lista de objetos.

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

Retorna [10, 2].

distinctWithNull(<listInteger>)

Retorna uma lista de inteiros.

distinctWithNull(<listDecimal>)

Retorna uma lista de decimais.

distinctWithNull(<listString>)

Retorna uma lista de strings.

distinctWithNull(<listDateTimeOnly>)

Retorna uma lista de datetimes sem considerar o fuso horário.

distinctWithNull(<listDateTime>)

Retorna uma lista de datetimes.

distinctWithNull(<listDateOnly>)

Retorna uma lista de datas.

distinctWithNull(<listBoolean>)

Retorna uma lista de booleanos.

distinctWithNull(<listDuration>)

Retorna uma lista de durações.

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

Retorna [10, 2, nulo]

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)

Retorna um listObject.

Este é um exemplo de uma carga útil transmitida em um evento de entrada “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
}]

Você pode usar a seguinte expressão:

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

Retorna um listObject contendo os dois objetos com “product2” e “product3” como id.

getListItem(<listInteger>,<index>)

Retorna um inteiro.

getListItem(<listDecimal>,<index>)

Retorna um decimal.

getListItem(<listString>,<index>)

Retorna uma string.

getListItem(<listDateTimeOnly>,<index>)

Retorna uma data e hora sem considerar o fuso horário.

getListItem(<listDateTime>,<index>)

Retorna um datetime.

getListItem(<listDateOnly>,<index>)

Retorna uma lista de datas.

getListItem(<listBoolean>,<index>)

Retorna um valor booleano.

getListItem(<listDuration>,<index>)

Retorna uma duração.

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

Retorna “2”

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

Retorna “C”

Exemplos com um campo de evento “event.appVersion” com valor: “20.45.2.3434”

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

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

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

Retorna “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>)

Retornar um booleano.

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

Retorna verdadeiro.

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

Retorna 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

Retorna uma lista.

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

Retorna [“esportes”, “notícias”]

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

Retorna itens comuns entre atributos de perfil e determinada lista de categorias.

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

Retorna itens comuns entre os atributos de perfil e o campo de evento especificado.

limit(<listString>,<integer>)

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

Retorna uma lista de strings.

limit(<listInteger>,<integer>)

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

Retorna uma lista de inteiros.

limit(<listDecimal>,<integer>)

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

Retorna uma lista de decimais.

limit(<listBoolean>,<integer>)

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

Retorna uma lista de booleanos.

limit(<listDateOnly>,<integer>)

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

Retorna uma lista de datas.

limit(<listDateTimeOnly>,<integer>)

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

Retorna uma lista de datetimes sem considerar o fuso horário.

limit(<listDateTime>,integer>)

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

Retorna uma lista de datetimes.

limit(<listDuration>,<integer>)

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

Retorna uma lista de durações.

limit(<listObject>,<integer>)

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

Retorna uma lista de objetos.

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

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

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

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

listSize(<listInteger>)

listSize(<listDecimal>)

listSize(<listString>)

listSize(<listBoolean>)

listSize(<listDateTimeOnly>)

listSize(<listDateTime>)

listSize(<listDateOnly>)

listSize(<listDuration>)

Retorna um número inteiro.

listSize(<listObject>)

listSize([10,2,3])

Retorna 3.

listSize(@event{my_event.productListItems})

Retorna o número de objetos na matriz de objetos fornecida (tipo listObject).

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>)

Retorna uma string.

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

Retorna “Olá, Mundo”.

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

Retorna ““Olá”,“Mundo””.

sort(<listInteger>,<boolean>)

Retorna uma lista de inteiros.

sort(<listDecimal>,<boolean>)

Retorna uma lista de decimais.

sort(<listString>,<boolean>)

Retorna uma lista de strings.

sort(<listDateTimeOnly>,<boolean>)

Retorna uma lista de datetimes sem considerar o fuso horário.

sort(<listDateTime>,<boolean>)

Retorna uma lista de datetimes.

sort(<listDateOnly>,<boolean>)

Retorna uma lista de datas.

sort(<listBoolean>,<boolean>)

Retorna uma lista de booleanos.

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

Retorna uma lista de objetos.

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

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

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

Retorna [3, 2, 1].

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

Retorna o listObject ordenado pelo atributo SKU (ordem crescente)

Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.

Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.

• TL;DR: esta página documenta todas as funções de lista disponíveis nas expressões de jornada do AJO, abordando como filtrar, classificar, desduplicar, verificar associação, limitar, serializar e encontrar interseções de listas e matrizes.

Intenções:

• Remover valores duplicados de uma lista usando distinct (ignorando nulos) ou distinctWithNull (preservando nulos)
• Filtrar um listObject para retornar somente objetos correspondentes a valores de chave específicos usando filter
• Recuperar um elemento em um índice específico de uma lista usando getListItem
• Verificar se existe um valor em uma lista usando in
• Encontrar elementos comuns entre duas listas usando intersect
• Retorna o primeiro ou o último N elementos de uma lista usando limit
• Contar o número total de elementos em uma lista usando listSize
• Converter uma lista em uma cadeia de caracteres delimitada usando serializeList
• Classificar uma lista em ordem crescente ou decrescente usando sort

Glossário:

• listObject: uma lista de objetos complexos que devem ser uma referência de campo; não pode conter objetos nulos (específico do produto)
• keyAttributeName: um parâmetro de cadeia opcional usado com distinct, filter e sort para identificar qual atributo de objeto usar para eliminação de duplicação, filtragem ou classificação (específico do produto)
• interseção: uma operação de conjunto que retorna somente os elementos presentes em ambas as listas de entrada

Medidas de Proteção:

• distinctWithNull não dá suporte ao tipo de parâmetro <listObject>
• filter requer que o parâmetro listObject seja uma referência de campo, não um literal embutido
• listSize em um listObject requer que a lista seja uma referência de campo; um listObject não pode conter objetos nulos
• serializeList não dá suporte ao tipo listObject

Terminologia:

• Nome canônico: funções de lista — Acrônimo: none — variantes: funções de coleção, funções de matriz
• Sinônimos: “listSize” = “count list elements”; “serializeList” = “join list to string”
• Não confunda: “distinct” (ignora nulos) ≠ “distinctWithNull” (preserva nulo como um valor distinto)
• Não confunda: “limit” com o terceiro parâmetro true (retorna os primeiros N itens) ≠ “limit” com false (retorna os últimos N itens)
• Não confunda: “intersect” (elementos comuns entre duas listas) ≠ “filter” (elementos que correspondem a valores de chave específicos)

Perguntas frequentes:

• P: Como faço para obter os primeiros 3 itens de uma lista? — Use limit(myList, 3) ou limit(myList, 3, true); o padrão é retornar os primeiros itens.
• P: Como obter os últimos 3 itens de uma lista? — Use limit(myList, 3, false).
• P: Qual é a diferença entre distinct e distinctWithNull? — distinct ignora valores nulos e os exclui do resultado; distinctWithNull trata nulo como um valor distinto e inclui uma entrada nula se houver nulos.
• P: Posso filtrar uma lista de cadeias de caracteres com filter? — Não, filter funciona somente em listObject; para listas escalares, use in ou distinct para desduplicação.
• P: Como verificar se um valor está em uma lista? — Use in(value, myList), que retornará true se o valor for encontrado na lista.
• P: Posso classificar um listObject por um atributo específico? — Sim, use sort(@event{...}, "attributeName", true) onde o segundo parâmetro é o nome do atributo e o terceiro é a direção da classificação (true = crescente).