Funções de ajuda
Use as funções Auxiliar no editor de personalização para definir experiências de conteúdo personalizadas com precisão e eficiência manipulando dados, realizando cálculos e formatando conteúdo. Explore e experimente essas funções, operadores e auxiliares para descobrir como eles trabalham juntos para ajudá-lo a criar jornadas personalizadas orientadas por dados.
Funções de agregação
Use funções de agregação para agrupar vários valores para formar um único valor de resumo. Também é possível usar as funções de matriz e de lista para definir interações com matrizes, listas e strings com mais facilidade.
média average
Use a função average para retornar a média aritmética de todos os valores selecionados na matriz.
| code language-sql |
|---|
|
Exemplo
A operação a seguir retorna o preço médio de todas as ordens.
| code language-sql |
|---|
|
contagem count
Use a função count para retornar o número de elementos dentro da matriz especificada.
| code language-sql |
|---|
|
Exemplo
A operação a seguir retorna o número de ordens na matriz.
| code language-sql |
|---|
|
max max
Use a função max para retornar o maior valor selecionado na matriz.
| code language-sql |
|---|
|
Exemplo
A operação a seguir retorna o preço mais alto de todas as ordens.
| code language-sql |
|---|
|
min min
Use a função min para retornar o menor valor selecionado na matriz.
| code language-sql |
|---|
|
Exemplo
A operação a seguir retorna o preço mais baixo de todas as ordens.
| code language-sql |
|---|
|
sum sum
Use a função sum para retornar a soma de todos os valores selecionados na matriz.
| code language-sql |
|---|
|
Exemplo
A operação a seguir retorna a soma de todos os preços das ordens.
| code language-sql |
|---|
|
Funções aritméticas maths
Use funções aritméticas para realizar cálculos básicos em valores.
adicionar add
Use a função + (adição) para localizar a soma de duas expressões de argumento.
| code language-sql |
|---|
|
Exemplo
A operação a seguir soma o preço de dois produtos diferentes.
| code language-sql |
|---|
|
multiplicar multiply
Use a função * (multiplicação) para localizar o produto de duas expressões de argumento.
| code language-sql |
|---|
|
Exemplo
A operação a seguir localiza o produto do estoque e o preço de um produto para localizar o valor bruto do produto.
| code language-sql |
|---|
|
subtrair substract
Use a função - (subtração) para localizar a diferença de duas expressões de argumento.
| code language-sql |
|---|
|
Exemplo
A operação a seguir encontra a diferença de preço entre dois produtos diferentes.
| code language-sql |
|---|
|
dividir divide
Use a função / (divisão) para localizar o quociente de duas expressões de argumento.
| code language-sql |
|---|
|
Exemplo
A operação a seguir encontra o quociente entre o total de produtos vendidos e o dinheiro total ganho para ver o custo médio por item.
| code language-sql |
|---|
|
restante remainder
Use a função % (restante) para localizar o restante após dividir as duas expressões de argumento.
| code language-sql |
|---|
|
Exemplo
A operação a seguir verifica se a idade da pessoa é divisível por cinco.
| code language-sql |
|---|
|
Matrizes e funções de lista arrays
Use essas funções para facilitar a interação com matrizes, listas e sequências de caracteres.
countOnlyNull count-only-null
Use a função countOnlyNull para contar o número de valores nulos em uma lista.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Retorna 3.
countWithNull count-with-null
Use a função countWithNull para contar todos os elementos de uma lista, incluindo valores nulos.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Retorna 6.
distinct distinct
Use a função distinct para obter valores de uma matriz ou lista com valores duplicados removidos.
| code language-sql |
|---|
|
Exemplo
A operação a seguir especifica as pessoas que fizeram pedidos em mais de um armazenamento.
| code language-sql |
|---|
|
distinctCountWithNull distinct-count-with-null
Use a função distinctCountWithNull para contar o número de valores diferentes em uma lista, incluindo os valores nulos.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Retorna 3.
head head
Use a função head para retornar o primeiro item em uma matriz ou lista.
| code language-sql |
|---|
|
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.
| code language-sql |
|---|
|
topN first-n
A função topN classifica uma matriz em ordem decrescente com base na expressão numérica fornecida e retorna os primeiros N itens. Se o tamanho da matriz for menor que N, ela retornará toda a matriz classificada.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
{ARRAY} |
A matriz ou lista para classificar. |
{VALUE} |
A propriedade usada para classificar a matriz ou lista. |
{AMOUNT} |
O número de itens para retornar. |
Exemplo
A operação a seguir retorna as cinco primeiras ordens com o preço mais baixo.
| code language-sql |
|---|
|
no in
Use a função in para determinar se um item é membro de uma matriz ou lista.
| code language-sql |
|---|
|
Exemplo
A operação a seguir define as pessoas com aniversários em março, junho ou setembro.
| code language-sql |
|---|
|
inclui includes
Use a função includes para determinar se uma matriz ou lista contém um determinado item.
| code language-sql |
|---|
|
Exemplo
A operação a seguir define as pessoas cuja cor favorita inclui vermelho.
| code language-sql |
|---|
|
cruzamentos intersects
A função intersects é usada para determinar se duas matrizes ou listas têm pelo menos um membro comum.
| code language-sql |
|---|
|
Exemplo
A operação a seguir define as pessoas cujas cores favoritas incluem pelo menos uma das cores vermelha, azul ou verde.
| code language-sql |
|---|
|
bottomN last-n
A função bottomN classifica uma matriz em ordem crescente com base na expressão numérica fornecida e retorna os primeiros N itens. Se o tamanho da matriz for menor que N, ela retornará toda a matriz classificada.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
{ARRAY} |
A matriz ou lista para classificar. |
{VALUE} |
A propriedade usada para classificar a matriz ou lista. |
{AMOUNT} |
O número de itens para retornar. |
Exemplo
A operação a seguir retorna as cinco últimas ordens com o preço mais alto.
| code language-sql |
|---|
|
notIn notin
Use a função notIn para determinar se um item não é membro de uma matriz ou lista.
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.| code language-sql |
|---|
|
Exemplo
A operação a seguir define as pessoas com aniversários que não são em março, junho ou setembro.
| code language-sql |
|---|
|
subsetOf subset
Use a função subsetOf 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.
| code language-sql |
|---|
|
Exemplo
A operação a seguir define as pessoas que visitaram todas as cidades favoritas.
| code language-sql |
|---|
|
supersetOf superset
Use a função supersetOf 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.
| code language-sql |
|---|
|
Exemplo
A operação seguinte define as pessoas que comeram sushi e pizza pelo menos uma vez.
| code language-sql |
|---|
|
Funções de data e hora date-time
Use as funções de data e hora para executar operações de data e hora em valores.
addDays add-days
A função addDays ajusta uma determinada data por um número especificado de dias, usando valores positivos para incrementar e valores negativos para decrementar.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= addDays(stringToDate("2024-11-01T17:19:51Z"),10) %} - Saída:
2024-11-11T17:19:51Z
addHours add-hours
A função addHours ajusta uma determinada data por um número especificado de horas, usando valores positivos para incrementar e valores negativos para decrementar.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= addHours(stringToDate("2024-11-01T17:19:51Z"),1) %} - Saída:
2024-11-01T18:19:51Z
addMinutes add-minutes
A função addMinutes ajusta uma determinada data por um número especificado de minutos, usando valores positivos para incrementar e valores negativos para decrementar.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= addMinutes(stringToDate("2024-11-01T17:59:51Z"),10) %} - Saída:
2024-11-01T18:09:51Z
addMonths add-months
A função addMonths ajusta uma determinada data por um número especificado de meses, usando valores positivos para incrementar e valores negativos para decrementar.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %} - Saída:
2025-01-01T17:19:51Z
addSeconds add-seconds
A função addSeconds ajusta uma determinada data por um número especificado de segundos, usando valores positivos para incrementar e valores negativos para decrementar.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %} - Saída:
2024-11-01T17:20:01Z
addYears add-years
A função addYears ajusta uma determinada data por um número especificado de anos, usando valores positivos para incrementar e valores negativos para decrementar.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %} - Saída:
2026-11-01T17:19:51Z
idade age
Use a função age para recuperar a idade de uma determinada data.
| code language-sql |
|---|
|
ageInDays age-days
A função ageInDays calcula o número de dias decorridos entre a data especificada e a data atual. Usa negativo para datas futuras e positivo para datas passadas.
| code language-sql |
|---|
|
Exemplo
currentDate = 2025-01-07T12:17:10.720122+05:30 (Ásia/Calcutá)
- Entrada:
{%= ageInDays(stringToDate("2025-01-01T17:19:51Z"))%} - Saída:
5
ageInMonths age-months
A função ageInMonths calcula o número de meses decorridos entre a data especificada e a data atual. Usa negativo para datas futuras e positivo para datas passadas.
| code language-sql |
|---|
|
Exemplo
currentDate = 2025-01-07T12:22:46.993748+05:30(Ásia/Calcutá)
- Entrada:
{%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%} - Saída:
12
compareDates compare-dates
A função compareDates compara a primeira data de entrada com a outra. Ele retorna 0 se a data1 for igual à data2, -1 se a data1 for anterior à data2 e 1 se a data1 for posterior à data2.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%} - Saída:
-1
convertZonedDateTime convert-zoned-date-time
A função convertZonedDateTime converte uma data-hora em um determinado fuso horário.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%} - Saída:
2019-02-19T11:39+03:30[Asia/Tehran]
currentTimeInMillis current-time
Use a função currentTimeInMillis para recuperar a hora atual em milissegundos da época.
| code language-sql |
|---|
|
dateDiff date-diff
Use a função dateDiff para recuperar a diferença entre duas datas em número de dias.
| code language-sql |
|---|
|
dayOfMonth day-month
dayOfMonth retorna o número que representa o dia do mês.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %} - Saída:
5
DayOfWeek day-week
Use a função dayOfWeek para recuperar o dia da semana.
| code language-sql |
|---|
|
dayOfYear day-year
Use a função dayOfYear para recuperar o dia do ano.
| code language-sql |
|---|
|
diffInSeconds diff-seconds
A função diffInSeconds retorna a diferença entre duas datas em termos de segundos.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%} - Saída:
50
extractHours extract-hours
A função extractHours extrai o componente de hora de um determinado carimbo de data/hora.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%} - Saída:
17
extractMinutes extract-minutes
A função extractMinutes extrai o componente de minuto de um carimbo de data/hora especificado.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= extractMinutes(stringToDate("2024-11-01T17:19:51Z"))%} - Saída:
19
extractMonths extract-months
A função extractMonth extrai o componente de mês de um determinado carimbo de data/hora.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%} - Saída:
11
extractSeconds extract-seconds
A função extractSeconds extrai o segundo componente de um determinado carimbo de data/hora.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%} - Saída:
51
formatDate format-date
Use a função formatDate para formatar um valor de data e hora. O formato deve ser um padrão Java DateTimeFormat válido.
| code language-sql |
|---|
|
Onde a primeira string é o atributo de data e o segundo valor é como você deseja que a data seja convertida e exibida.
| note note |
|---|
| NOTE |
| Se um padrão de data for inválido, a data voltará ao formato padrão ISO. |
| Você pode usar as funções de formatação de data Java conforme resumido na documentação do Oracle |
Exemplo
A operação a seguir retorna a data no seguinte formato: MM/DD/AA.
| code language-sql |
|---|
|
Caracteres padrão pattern-characters
Algumas letras de padrão podem parecer semelhantes, mas representam conceitos diferentes.
2023-12-31T10:15:30Z)y2023Y2024 (31 de dezembro de 2023 cai na primeira semana de 2024)MJan, January)12 ou Decm15d31D365Formatar data com suporte local format-date-locale
Você pode usar a função formatDate para formatar um valor de data e hora em sua representação sensível a idioma correspondente, como para um local desejado. O formato deve ser um padrão Java DateTimeFormat válido.
| code language-sql |
|---|
|
Onde a primeira string é o atributo de data, o segundo valor é como você deseja que a data seja convertida e exibida, e o terceiro valor representa o local no formato de string.
| note note |
|---|
| NOTE |
| Se um padrão de data for inválido, a data voltará ao formato padrão ISO. |
| Você pode usar as funções de formatação de data Java conforme resumido na documentação do Oracle. |
| Você pode usar formatação e localidades válidas conforme resumido na Documentação do Oracle e nas Localidades com suporte. |
Exemplo
A operação a seguir retorna a data no seguinte formato: MM/dd/AA e localidade FRANÇA.
| code language-sql |
|---|
|
getCurrentZonedDateTime get-current-zoned-date-time
A função getCurrentZonedDateTime retorna a data e a hora atuais com informações de fuso horário.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= getCurrentZonedDateTime() %} - Saída:
2024-12-06T17:22:02.281067+05:30[Asia/Kolkata]
diffInHours hours-difference
A função diffInHours retorna a diferença entre duas datas em termos de horas.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= diffInHours(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T07:19:51Z"))%} - Saída:
10
diffInMinutes diff-minutes
A função diffInMinutes retorna a diferença entre duas datas em termos de minutos.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= diffInMinutes(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T16:19:51Z"))%} - Saída:
60
diffInMonths months-difference
A função diffInMonths retorna a diferença entre duas datas em termos de meses.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=diffInMonths(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-08-01T17:19:51Z"))%} - Saída:
3
setDays set-days
Use a função setDays para definir o dia do mês para a data-hora especificada.
| code language-sql |
|---|
|
setHours set-hours
Use a função setHours para definir a hora da data-hora.
| code language-sql |
|---|
|
toDateTime string-to-date-time
A função toDateTime converte a cadeia de caracteres em data. Retorna a data da época como saída para entrada inválida.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=toDateTime("2024-11-01T17:19:51Z")%} - Saída:
2024-11-01T17:19:51Z
toUTC to-utc
Use a função toUTC para converter um datetime em UTC.
| code language-sql |
|---|
|
truncateToStartOfDay truncate-day
Use a função truncateToStartOfDay para modificar uma determinada data-hora, definindo-a para o início do dia com a hora 00:00.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %} - Saída:
2024-11-01T00:00Z
truncateToStartOfQuarter truncate-quarter
Use a função truncateToStartOfQuarter para truncar uma data-hora para o primeiro dia de seu trimestre (como 1º de janeiro, 1º de abril, 1º de julho, 1º de outubro) em 00:00.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%} - Saída:
2024-10-01T00:00Z
truncateToStartOfWeek truncate-week
A função truncateToStartOfWeek modifica uma determinada data-hora definindo-a para o início da semana (segunda-feira às 00:00).
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%= truncateToStartOfWeek(stringToDate("2024-11-19T17:19:51Z"))%} // tuesday - Saída:
2024-11-18T00:00Z // monday
truncateToStartOfYear truncate-year
Use a função truncateToStartOfYear para modificar uma determinada data-hora, truncando-a para o primeiro dia do ano (1° de janeiro) em 00:00.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%} - Saída:
2024-01-01T00:00Z
weekOfYear week-of-year
Use a função weekOfYear para recuperar a semana do ano.
| code language-sql |
|---|
|
diffInYears diff-years
Use a função diffInYears para retornar a diferença entre duas datas em termos de anos.
| code language-sql |
|---|
|
Exemplo
- Entrada:
{%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%} - Saída:
5
Funções do operador operators
Use as funções booleano e de comparação para executar avaliações lógicas.
e and
A função and é usada para criar uma conjunção lógica.
| code language-sql |
|---|
|
Exemplo
A operação a seguir retorna todas as pessoas com país de origem (França) e ano de nascimento (1985).
| code language-sql |
|---|
|
ou or
A função or é usada para criar uma disjunção lógica.
| code language-sql |
|---|
|
Exemplo
A operação a seguir retorna todas as pessoas com país de origem (França) ou ano de nascimento (1985).
| code language-sql |
|---|
|
é igual a operator-equals
A função = (igual a) verifica se um valor ou expressão é igual a outro valor ou expressão.
| code language-sql |
|---|
|
Exemplo
A operação a seguir verifica se o país do endereço residencial é a França.
| code language-sql |
|---|
|
diferente de notequal
A função != (diferente de) verifica se um valor ou expressão é não igual a outro valor ou expressão.
| code language-sql |
|---|
|
Exemplo
A operação a seguir verifica se o país do endereço residencial não é a França.
| code language-sql |
|---|
|
maior que greaterthan
Use a função > (maior que) para verificar se o primeiro valor é maior que o segundo valor.
| code language-sql |
|---|
|
Exemplo
A operação a seguir define pessoas nascidas estritamente após 1970.
| code language-sql |
|---|
|
maior que ou igual a greaterthanorequal
Use a função >= (maior que ou igual a) para verificar se o primeiro valor é maior que ou igual ao segundo valor.
| code language-sql |
|---|
|
Exemplo
A operação a seguir define pessoas nascidas em ou após 1970.
| code language-sql |
|---|
|
menor que lessthan
Use a função de comparação < (menor que) para verificar se o primeiro valor é menor que o segundo valor.
| code language-sql |
|---|
|
Exemplo
A operação a seguir define pessoas nascidas antes de 2000.
| code language-sql |
|---|
|
menor que ou igual a lessthanorequal
Use a função de comparação <= (menor que ou igual a) para verificar se o primeiro valor é menor que ou igual ao segundo valor.
| code language-sql |
|---|
|
Exemplo
A operação a seguir define pessoas nascidas em 2000 ou antes.
| code language-sql |
|---|
|
Funções dinâmicas dynamic-helpers
Use as funções auxiliares dinâmicas para usar avaliações condicionais, iteração e atribuições de variáveis para personalização dinâmica.
Valor de fallback padrão default-value
O auxiliar Default Fallback Value será usado para retornar um valor de fallback padrão se um atributo estiver vazio ou nulo. Esse mecanismo funciona para atributos de Perfil e eventos de Jornada.
| code language-sql |
|---|
|
Neste exemplo, o valor there será exibido se o atributo firstName desse perfil estiver vazio ou nulo.
if (condições) if-function
O auxiliar if é usado para definir um bloco condicional.
Se a expressão evaluation retornar true, o bloco será renderizado, caso contrário, será ignorado.
| code language-sql |
|---|
|
Após o auxiliar if, você pode inserir uma instrução else para especificar um bloco de código a ser executado, se a mesma condição for falsa.
A instrução elseif especifica uma nova condição para testar se a primeira instrução retorna falso.
Formato
| code language-sql |
|---|
|
a menos que unless
Use o auxiliar unless para definir um bloco condicional. Por oposição ao auxiliar if, se a avaliação da expressão retornar falso, o bloco será renderizado.
| code language-sql |
|---|
|
Exemplo
Renderize algum conteúdo com base na extensão de endereço de email:
| code language-sql |
|---|
|
cada each
Use o auxiliar each para iterar sobre uma matriz.
A estrutura auxiliar é {{#each ArrayName}} SeuConteúdo {{/each}}
Você pode usar a palavra-chave this dentro do bloco para fazer referência a itens de matriz individuais. Use {{@index}} para renderizar o índice do elemento da matriz.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Exemplo
Renderize uma lista de produtos que este usuário tem em seu carrinho:
| code language-sql |
|---|
|
com with
Use o auxiliar with para alterar o token de avaliação da parte do modelo.
| code language-sql |
|---|
|
O auxiliar with é útil também para definir uma variável de atalho.
Exemplo
Use with para aliases de nomes de variáveis longos para nomes mais curtos:
| code language-sql |
|---|
|
let let
A função let permite que uma expressão seja armazenada como uma variável a ser usada posteriormente em uma consulta.
| code language-sql |
|---|
|
Exemplo
O exemplo a seguir permite calcular a soma total dos preços dos produtos no carrinho com preços entre 100 e 1000.
| code language-sql |
|---|
|
Metadados de execução execution-metadata
Use o executionMetadata para capturar e armazenar pares de valores chave personalizados dinamicamente no contexto de execução da mensagem.
Com essa função, é possível anexar informações contextuais a qualquer ação nativa de suas campanhas ou jornadas. Use-a para exportar dados contextuais de delivery em tempo real para sistemas externos para várias finalidades, como rastreamento, análise, personalização e processamento downstream.
executionMetadata.Por exemplo, você pode usar o auxiliar do executionMetadata para anexar uma ID específica a cada entrega enviada para cada perfil. Essas informações são geradas durante o tempo de execução e os metadados de execução enriquecidos podem ser exportados para reconciliação downstream com uma plataforma de relatórios externa.
| code language-none |
|---|
|
Nesta sintaxe, key refere-se ao nome dos metadados e value são os metadados a serem mantidos.
Como funciona
Selecione qualquer elemento do conteúdo do canal dentro de uma campanha ou jornada e, usando o editor de personalização, adicione o auxiliar do executionMetadata a esse elemento.
| note note |
|---|
| NOTE |
A função executionMetadata não está visível quando o conteúdo em si é exibido. |
No tempo de execução, o valor dos metadados é adicionado ao Conjunto de Dados de Evento de Feedback de Mensagem existente com a seguinte adição de esquema:
| code language-none |
|---|
|
| note important |
|---|
| IMPORTANT |
| Há um limite superior de 2 kb nos pares de valores principais por ação. Se o limite de 2Kb for excedido, a mensagem ainda será entregue, mas qualquer um dos pares de valores principais poderá ser truncado. |
Exemplo
| code language-none |
|---|
|
Neste exemplo, assumindo profile.person.name.firstName = "Alex", a entidade resultante é:
| code language-none |
|---|
|
Funções do mapa maps
Use funções de mapa na personalização para facilitar a interação com mapas.
get get
Use a função get para recuperar o valor de um mapa para uma determinada chave.
| code language-sql |
|---|
|
Exemplo
A operação a seguir obtém o valor do mapa de identidade para a chave example@example.com.
| code language-sql |
|---|
|
chaves keys
Use a função keys para recuperar todas as chaves de um determinado mapa.
| code language-sql |
|---|
|
Exemplo
A operação a seguir recupera todas as chaves do mapa identityMap.
| code language-sql |
|---|
|
valores values
A função values é usada para recuperar todos os valores de um determinado mapa.
| code language-sql |
|---|
|
Exemplo
A operação a seguir recupera todos os valores do mapa identityMap.
| code language-sql |
|---|
|
Funções matemáticas math
Saiba como usar funções matemáticas no editor de personalização.
absoluto absolute
Use a função absolute para converter um número em seu valor absoluto.
| code language-sql |
|---|
|
formatNumber format-number
Use a função formatNumber para formatar qualquer número em sua representação sensível a linguagem.
Ele aceita um número e uma string representando o local e retorna uma string formatada do número no local desejado.
| code language-sql |
|---|
|
Você pode usar formatação e localidades válidas conforme resumido na Documentação do Oracle e nas Localidades com suporte
Exemplo
Esta consulta retorna uma string formatada em árabe correspondente a 123456.789 como o número de entrada.
| code language-sql |
|---|
|
random random
Use a função random para retornar um valor aleatório entre 0 e 1.
| code language-sql |
|---|
|
roundDown round-down
Use a função roundDown para arredondar um número para baixo.
| code language-sql |
|---|
|
roundUp round-up
Use a função roundUp para arredondar um número para cima.
| code language-sql |
|---|
|
toHexString to-hex-string
A função toHexString converte qualquer número em sua cadeia de caracteres hexadecimal.
| code language-sql |
|---|
|
Exemplo
Esta consulta retorna o valor hexadecimal de 158 como 9e.
| code language-sql |
|---|
|
toInt to-int
Use a função toInt para converter tipos (número, duplo, inteiro, longo, flutuante, curto, byte, booleano, string) em um inteiro.
| code language-sql |
|---|
|
Exemplo
Esta consulta retorna o valor inteiro de 42,6 como 42.
| code language-sql |
|---|
|
toPercentage to-percentage
Use a função toPercentage para converter um número em porcentagem.
| code language-sql |
|---|
|
toPrecision to-precision
Use a função toPrecision para converter um número na precisão necessária.
| code language-sql |
|---|
|
toString to-string
A função toString converte qualquer número em sua representação de cadeia de caracteres.
| code language-sql |
|---|
|
Exemplo
Esta consulta retorna "12".
| code language-sql |
|---|
|
Funções do objeto objects
Funções de objeto para consultar propriedades ou atributos de objeto.
isNull isNull
A função isNull determina se uma referência de objeto não existe.
| code language-sql |
|---|
|
Exemplo
A operação a seguir verifica se o endereço residencial da pessoa não existe.
| code language-sql |
|---|
|
isNotNull isNotNull
A função isNotNull determina se existe uma referência de objeto.
| code language-sql |
|---|
|
Exemplo
A operação a seguir verifica se o endereço residencial da pessoa existe.
| code language-sql |
|---|
|
Funções de strings string-functions
Saiba como usar funções de string no editor de personalização.
camelCase camelCase
A função camelCase coloca a primeira letra de cada palavra de uma cadeia de caracteres em maiúscula.
| code language-sql |
|---|
|
Exemplo
A função a seguir coloca a primeira letra de uma palavra em maiúscula no endereço do perfil.
| code language-sql |
|---|
|
charCodeAt char-code-at
A função charCodeAt retorna o valor ASCII de um caractere, como a função charCodeAt no JavaScript. Ele pega uma string e um inteiro (definindo a posição de um caractere) como argumentos de entrada e retorna seu valor ASCII correspondente.
| code language-sql |
|---|
|
Exemplo
A função a seguir retorna o valor ASCII de o (111).
| code language-sql |
|---|
|
concat concate
A função concat combina duas cadeias de caracteres em uma.
| code language-sql |
|---|
|
Exemplo
A função a seguir combina o perfil cidade e país em uma única sequência.
| code language-sql |
|---|
|
contém contains
Use a função contains para determinar se uma cadeia de caracteres contém uma subsequência especificada.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
STRING_1 |
A sequência de caracteres a ser verificada. |
STRING_2 |
A sequência de caracteres a ser pesquisada na primeira sequência. |
CASE_SENSITIVE |
Um parâmetro opcional para determinar se a verificação diferencia maiúsculas de minúsculas. Valores possíveis: true (padrão) / false. |
Exemplos
-
A função a seguir verifica se o nome do perfil contém a letra A (em maiúsculas ou minúsculas). Se o perfil retornar, retorna
true. Caso contrário, retornaráfalse.code language-sql {%= contains(profile.person.name.firstName, "A", false) %} -
A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o email da pessoa contém a cadeia de caracteres
2010@gm.code language-sql {%= contains(profile.person.emailAddress,"2010@gm") %}
doesNotContain doesNotContain
Use a função doesNotContain para determinar se uma cadeia de caracteres não contém uma subsequência especificada.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
STRING_1 |
A sequência de caracteres a ser verificada. |
STRING_2 |
A sequência de caracteres a ser pesquisada na primeira sequência. |
CASE_SENSITIVE |
Um parâmetro opcional para determinar se a verificação diferencia maiúsculas de minúsculas. Valores possíveis: true (padrão) / false. |
Exemplo
A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o endereço de email da pessoa não contém a cadeia de caracteres 2010@gm.
| code language-sql |
|---|
|
doesNotEndWith doesNotEndWith
Use a função doesNotEndWith para determinar se uma cadeia de caracteres não termina com uma subcadeia especificada.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser pesquisada na primeira sequência. |
{CASE_SENSITIVE} |
Um parâmetro opcional para determinar se a verificação diferencia maiúsculas de minúsculas. Valores possíveis: true (padrão) / false. |
Exemplo
A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o email da pessoa não termina com .com.
| code language-sql |
|---|
|
doesNotStartWith doesNotStartWith
Use a função doesNotStartWith para determinar se uma cadeia de caracteres não inicia com uma subcadeia especificada.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser pesquisada na primeira sequência. |
{CASE_SENSITIVE} |
Um parâmetro opcional para determinar se a verificação diferencia maiúsculas de minúsculas. Valores possíveis: true (padrão) / false. |
Exemplo
A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa não inicia com Joe.
| code language-sql |
|---|
|
encode64 encode64
Use a função encode64 para codificar uma cadeia de caracteres para preservar as Informações Pessoais (PI), como a ser incluída em uma URL.
| code language-sql |
|---|
|
endsWith endsWith
Use a função endsWith para determinar se uma sequência de caracteres termina com uma subsequência especificada.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser pesquisada na primeira sequência. |
{CASE_SENSITIVE} |
Um parâmetro opcional para determinar se a verificação diferencia maiúsculas de minúsculas. Valores possíveis: true (padrão) / false. |
Exemplo
A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o email da pessoa termina com .com.
| code language-sql |
|---|
|
é igual a equals
Use a função equals para determinar se uma cadeia de caracteres é igual à cadeia especificada, com distinção entre maiúsculas e minúsculas.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser comparada com a primeira sequência. |
Exemplo
A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa é John.
| code language-sql |
|---|
|
equalsIgnoreCase equalsIgnoreCase
Use a função equalsIgnoreCase para determinar se uma cadeia de caracteres é igual à cadeia especificada, sem diferenciar maiúsculas de minúsculas.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser comparada com a primeira sequência. |
Exemplo
A consulta a seguir determina, sem distinção entre maiúsculas e minúsculas, se o nome da pessoa é John.
| code language-sql |
|---|
|
extractEmailDomain extractEmailDomain
Use a função extractEmailDomain para extrair o domínio de um endereço de email.
| code language-sql |
|---|
|
Exemplo
A consulta a seguir extrai o domínio de email do endereço de email pessoal.
| code language-sql |
|---|
|
formatCurrency format-currency
Use a função formatCurrency para converter qualquer número em sua representação de moeda sensível ao idioma correspondente, dependendo da localidade transmitida como uma cadeia de caracteres no segundo argumento.
| code language-sql |
|---|
|
Exemplo
Esta consulta retorna £ 56,00
| code language-sql |
|---|
|
getUrlHost get-url-host
Use a função getUrlHost para recuperar o nome de host de uma URL.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Retorna "www.myurl.com"
getUrlPath get-url-path
Use a função getUrlPath para recuperar o caminho após o nome de domínio de uma URL.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Retorna "/contact.html"
getUrlProtocol get-url-protocol
Use a função getUrlProtocol para recuperar o protocolo de uma URL.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Retorna "http"
indexOf index-of
Use a função indexOf para retornar a posição (no primeiro argumento) da primeira ocorrência do segundo parâmetro. Retorna -1 se não houver correspondência.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser pesquisada no primeiro parâmetro |
Exemplo
| code language-sql |
|---|
|
Retorna 6.
isEmpty isEmpty
Use a função isEmpty para determinar se uma cadeia de caracteres está vazia.
| code language-sql |
|---|
|
Exemplo
A função a seguir retornará 'true' se o número de telefone celular do perfil estiver vazio. Do contrário, retorna false.
| code language-sql |
|---|
|
isNotEmpty is-not-empty
Use a função isNotEmpty para determinar se uma cadeia de caracteres não está vazia.
| code language-sql |
|---|
|
Exemplo
A função a seguir retornará 'true' se o número de telefone celular do perfil não estiver vazio. Do contrário, retorna false.
| code language-sql |
|---|
|
lastIndexOf last-index-of
Use a função lastIndexOf para retornar a posição (no primeiro argumento) da última ocorrência do segundo parâmetro. Retorna -1 se não houver correspondência.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser pesquisada no primeiro parâmetro |
Exemplo
| code language-sql |
|---|
|
Retorna 7.
leftTrim leftTrim
Use a função leftTrim para remover espaços em branco do início de uma cadeia.
| code language-sql |
|---|
|
length length
Use a função length para obter o número de caracteres em uma cadeia de caracteres ou expressão.
| code language-sql |
|---|
|
Exemplo
A função a seguir retorna o comprimento do nome da cidade do perfil.
| code language-sql |
|---|
|
curtir like
Use a função like para determinar se uma cadeia de caracteres corresponde a um padrão especificado.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A expressão que deve corresponder à primeira sequência. Há dois caracteres especiais suportados para a criação de uma expressão:
|
Exemplo
A consulta a seguir recupera todas as cidades em que os perfis vivem contendo o padrão es.
| code language-sql |
|---|
|
lowerCase lower
Use a função lowerCase para converter uma cadeia de caracteres em letras minúsculas.
| code language-sql |
|---|
|
Exemplo
Essa função converte o nome do perfil em letras minúsculas.
| code language-sql |
|---|
|
matches matches
Use a função matches para determinar se uma sequência de caracteres corresponde a uma expressão regular específica. Para obter mais informações sobre padrões correspondentes em expressões regulares, consulte a documentação do Oracle.
| code language-sql |
|---|
|
Exemplo
A consulta a seguir determina, sem distinção entre maiúsculas e minúsculas, se o nome da pessoa começa com John.
| code language-sql |
|---|
|
máscara mask
Use a função mask para substituir uma parte de uma cadeia de caracteres por caracteres "X".
| code language-sql |
|---|
|
Exemplo
A consulta a seguir substitui a sequência "123456789" por caracteres "X", com exceção do primeiro e dos últimos 2 caracteres.
| code language-sql |
|---|
|
A consulta retorna 1XXXXXX89.
md5 md5
Use a função md5 para calcular e retornar o hash md5 de uma cadeia de caracteres.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Retorna "5eb63bbbbe01eed093cb22bb8f5acdc3"
notEqualTo notEqualTo
Use a função notEqualTo para determinar se uma cadeia de caracteres não é igual à cadeia especificada.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser comparada com a primeira sequência. |
Exemplo
A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa não é John.
| code language-sql |
|---|
|
notEqualWithIgnoreCase not-equal-with-ignore-case
Use a função notEqualWithIgnoreCase para comparar duas cadeias de caracteres ignorando maiúsculas e minúsculas.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser comparada com a primeira sequência. |
Exemplo
A consulta a seguir determina se o nome da pessoa não é john, sem distinção entre maiúsculas e minúsculas.
| code language-sql |
|---|
|
regexGroup regexGroup
Use a função regexGroup para extrair informações específicas com base na expressão regular fornecida.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING} |
A sequência de caracteres a ser verificada. |
{EXPRESSION} |
A expressão regular que deve corresponder à primeira sequência. |
{GROUP} |
Grupo de expressão para correspondência. |
Exemplo
A consulta a seguir extrai o nome de domínio de um endereço de email.
| code language-sql |
|---|
|
replace replace
Use a função replace para substituir uma determinada substring em uma string por outra substring.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A cadeia de caracteres em que a subcadeia de caracteres deve ser substituída. |
{STRING_2} |
A subcadeia de caracteres a ser substituída. |
{STRING_3} |
A substring de substituição. |
Exemplo
| code language-sql |
|---|
|
Retorna Hello Mark, here is your monthly newsletter!
replaceAll replaceAll
Use a função replaceAll para substituir todas as subsequências de um texto que correspondam à expressão regex pela sequência de caracteres de substituição literal especificada. O Regex tem tratamento especial de \ e + e todas as expressões regex seguem a estratégia de escape do PQL. A substituição continua do início da cadeia de caracteres até o fim. Por exemplo, a substituição de aa por b na cadeia de caracteres aaa resulta em ba em vez de ab.
| code language-sql |
|---|
|
| note note |
|---|
| NOTE |
Quando a expressão usada como segundo argumento for um caractere regex especial, use barra invertida dupla (//). Os caracteres de regex especiais são: [., +, *, ?, ^, $, (, ), [,], {, }, |, .] |
| Saiba mais em documentação do Oracle. |
rightTrim rightTrim
A função rightTrim remove espaços em branco do final de uma cadeia de caracteres.
| code language-sql |
|---|
|
sha256 sha256
A função sha256 calcula e retorna o hash sha256 de uma cadeia de caracteres.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
Retorna 0b0b207880b999adaad6231026abf87caa30760b6f326b21727b61139332257d
split split
Use a função split para dividir uma cadeia de caracteres por um determinado caractere.
| code language-sql |
|---|
|
startsWith startsWith
Use a função startsWith para determinar se uma sequência de caracteres inicia com uma subsequência especificada.
| code language-sql |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Argumento | Descrição |
{STRING_1} |
A sequência de caracteres a ser verificada. |
{STRING_2} |
A sequência de caracteres a ser pesquisada na primeira sequência. |
{CASE_SENSITIVE} |
Um parâmetro opcional para determinar se a verificação diferencia maiúsculas de minúsculas. Por padrão, está definido como verdadeiro. |
Exemplo
A consulta a seguir determina, com distinção entre maiúsculas e minúsculas, se o nome da pessoa começa com Joe.
| code language-sql |
|---|
|
stringToDate string-to-date
A função stringToDate converte um valor de cadeia de caracteres em um valor de data-hora. Leva dois argumentos: representação de string de uma representação de data-hora e representação de string do formatador.
| code language-sql |
|---|
|
Exemplo
| code language-sql |
|---|
|
string_to_integer string-to-integer
Use a função string_to_integer para converter um valor de cadeia de caracteres em um valor inteiro.
| code language-sql |
|---|
|
stringToNumber string-to-number
Use a função stringToNumber para converter uma cadeia de caracteres em número. Ele retorna a mesma string que a saída para entrada inválida.
| code language-sql |
|---|
|
substr sub-string
Use a função substr para retornar a subcadeia de caracteres da expressão de cadeia de caracteres entre o índice inicial e o índice final.
| code language-sql |
|---|
|
titleCase titleCase
Use a função titleCase para colocar as primeiras letras de cada palavra de uma cadeia de caracteres em maiúsculas.
| code language-sql |
|---|
|
Exemplo
Se a pessoa mora na Washington High Street, essa função retornará Washington High Street.
| code language-sql |
|---|
|
toBool to-bool
Use a função toBool para converter um valor de argumento em um valor booleano, dependendo de seu tipo.
| code language-sql |
|---|
|
toDateTime to-date-time
Use a função toDateTime para converter a cadeia de caracteres em data. Retorna a data da época como saída para entrada inválida.
| code language-sql |
|---|
|
toDateTimeOnly to-date-time-only
Use a função toDateTimeOnly para converter um valor de argumento em um valor somente de data e hora. Retorna a data da época como saída para entrada inválida. Esta função aceita os tipos de campo string, date, long e integer.
| code language-sql |
|---|
|
trim trim
A função trim remove todos os espaços em branco do início e do fim de uma cadeia de caracteres.
| code language-sql |
|---|
|
upperCase upper
A função upperCase converte uma cadeia de caracteres em letras maiúsculas.
| code language-sql |
|---|
|
Exemplo
Esta função converte o sobrenome do perfil em letras maiúsculas.
| code language-sql |
|---|
|
urlDecode url-decode
Use a função urlDecode para decodificar uma cadeia de caracteres codificada em URL.
| code language-sql |
|---|
|
urlEncode url-encode
Use a função urlEncode para codificar uma cadeia de caracteres como uma URL.
| code language-sql |
|---|
|