DocumentaçãoJourney OptimizerGuia do Journey Optimizer

Matrizes e funções de lista

17 de julho de 2024
  • Tópicos:
  • Personalização

Criado para:

  • Experiente
  • Desenvolvedor

Use essas funções para facilitar a interação com matrizes, listas e sequências de caracteres.

Somente contagem nula

A função countOnlyNull é usada para contar o número de valores nulos em uma lista.

Sintaxe

{%= countOnlyNull(array) %}

Exemplo

{%= countOnlyNull([4,0,1,6,0,0]) %}

Retorna 3.

Contagem com nulo

A função countWithNull é usada para contar todos os elementos de uma lista, incluindo valores nulos.

Sintaxe

{%= countWithNull(array) %}

Exemplo

{%= countOnlyNull([4,0,1,6,0,0]) %}

Retorna 6.

Distinto

A função distinct é usada para obter valores de uma matriz ou lista com valores duplicados removidos.

Sintaxe

{%= distinct(array) %}

Exemplo

A operação a seguir especifica as pessoas que fizeram pedidos em mais de um armazenamento.

{%= distinct(person.orders.storeId).count() > 1 %}

Contagem distinta com nulo

A função distinctCountWithNull é usada para contar o número de valores diferentes em uma lista, incluindo os valores nulos.

Sintaxe

{%= distinctCountWithNull(array) %}

Exemplo

{%= distinctCountWithNull([10,2,10,null]) %}

Retorna 3.

Primeiro item

A função head é usada para retornar o primeiro item em uma matriz ou lista.

Sintaxe

{%= head(array) %}

Exemplo

A operação a seguir retorna a primeira das cinco ordens principais com o preço mais alto. Mais informações sobre a função topN podem ser encontradas na primeira n da seção de matriz.

{%= head(topN(orders,price, 5)) %}

Primeiro n na matriz

A função topN é usada para retornar os primeiros N itens em uma matriz, quando classificados em ordem crescente com base na expressão numérica fornecida.

Sintaxe

{%= topN(array, value, amount) %}
Argumento
Descrição
{ARRAY}
A matriz ou lista que deve ser classificada.
{VALUE}
A propriedade na qual classificar a matriz ou lista.
{AMOUNT}
O número de itens a serem retornados.

Exemplo

A operação a seguir retorna as cinco primeiras ordens com o preço mais baixo.

{%= topN(orders,price, 5) %}

Em

A função in é usada para determinar se um item é membro de uma matriz ou lista.

Sintaxe

{%= in(value, array) %}

Exemplo

A operação a seguir define as pessoas com aniversários em março, junho ou setembro.

{%= in (person.birthMonth, [3, 6, 9]) %}

Inclui

A função includes é usada para determinar se uma matriz ou lista contém um determinado item.

Sintaxe

{%= includes(array,item) %}

Exemplo

A operação a seguir define as pessoas cuja cor favorita inclui vermelho.

{%= includes(person.favoriteColors,"red") %}

Intersecta

A função intersects é usada para determinar se duas matrizes ou listas têm pelo menos um membro comum.

Sintaxe

{%= intersects(array1, array2) %}

Exemplo

A operação a seguir define as pessoas cujas cores favoritas incluem pelo menos uma das cores vermelha, azul ou verde.

{%= intersects(person.favoriteColors,["red", "blue", "green"]) %}

Último n na matriz

A função bottomN é usada para retornar os últimos N itens em uma matriz, quando classificados em ordem crescente com base na expressão numérica fornecida.

Sintaxe

{%= bottomN(array, value, amount) %}
Argumento
Descrição
{ARRAY}
A matriz ou lista que deve ser classificada.
{VALUE}
A propriedade na qual classificar a matriz ou lista.
{AMOUNT}
O número de itens a serem retornados.

Exemplo

A operação a seguir retorna as cinco últimas ordens com o preço mais alto.

{%= bottomN(orders,price, 5) %}

Não está em

A função notIn é usada para determinar se um item não é membro de uma matriz ou lista.

NOTE
A função notIn também garante que nenhum dos valores seja igual a nulo. Portanto, os resultados não são uma negação exata da função in.

Sintaxe

{%= notIn(value, array) %}

Exemplo

A operação a seguir define as pessoas com aniversários que não são em março, junho ou setembro.

{%= notIn(person.birthMonth ,[3, 6, 9]) %}

Subconjunto de

A função subsetOf é usada para determinar se uma matriz específica (matriz A) é um subconjunto de outra matriz (matriz B). Em outras palavras, que todos os elementos na matriz A são elementos da matriz B.

Sintaxe

{%= subsetOf(array1, array2) %}

Exemplo

A operação a seguir define as pessoas que visitaram todas as cidades favoritas.

{%= subsetOf(person.favoriteCities,person.visitedCities) %}

Superconjunto de

A função supersetOf é usada para determinar se uma matriz específica (matriz A) é um superconjunto de outra matriz (matriz B). Em outras palavras, essa matriz A contém todos os elementos na matriz B.

Sintaxe

{%= supersetOf(array1, array2) %}

Exemplo

A operação seguinte define as pessoas que comeram sushi e pizza pelo menos uma vez.

{%= supersetOf(person.eatenFoods,["sushi", "pizza"] %}
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76