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.

AVAILABILITY
As funções auxiliares estão disponíveis para ambientes Journey Optimizer B2B Edition que são provisionados na arquitetura simplificada.

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.

Sintaxe
code language-sql
{%= average(array) %}

Exemplo

A operação a seguir retorna o preço médio de todas as ordens.

code language-sql
{%=average(orders.order.price)%}

contagem count

Use a função count para retornar o número de elementos dentro da matriz especificada.

Sintaxe
code language-sql
{%= count(array) %}

Exemplo

A operação a seguir retorna o número de ordens na matriz.

code language-sql
{%= count(orders) %}

max max

Use a função max para retornar o maior valor selecionado na matriz.

Sintaxe
code language-sql
{%= max(array) %}

Exemplo

A operação a seguir retorna o preço mais alto de todas as ordens.

code language-sql
{%=max(orders.order.price)%}

min min

Use a função min para retornar o menor valor selecionado na matriz.

Sintaxe
code language-sql
{%= min(array) %}

Exemplo

A operação a seguir retorna o preço mais baixo de todas as ordens.

code language-sql
{%=min(orders.order.price) %}

sum sum

Use a função sum para retornar a soma de todos os valores selecionados na matriz.

Sintaxe
code language-sql
{%= sum(array) %}

Exemplo

A operação a seguir retorna a soma de todos os preços das ordens.

code language-sql
 {%=sum(orders.order.price)%}

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.

Sintaxe
code language-sql
{%= double + double %}

Exemplo

A operação a seguir soma o preço de dois produtos diferentes.

code language-sql
{%= product1.price + product2.price %}

multiplicar multiply

Use a função * (multiplicação) para localizar o produto de duas expressões de argumento.

Sintaxe
code language-sql
{%= double * double %}

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
{%= product.inventory * product.price %}

subtrair substract

Use a função - (subtração) para localizar a diferença de duas expressões de argumento.

Sintaxe
code language-sql
{%= double - double %}

Exemplo

A operação a seguir encontra a diferença de preço entre dois produtos diferentes.

code language-sql
{%= product1.price - product2.price %}

dividir divide

Use a função / (divisão) para localizar o quociente de duas expressões de argumento.

Sintaxe
code language-sql
{%= double / double %}

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
{%= totalProduct.price / totalProduct.sold %}

restante remainder

Use a função % (restante) para localizar o restante após dividir as duas expressões de argumento.

Sintaxe
code language-sql
{%= double % double %}

Exemplo

A operação a seguir verifica se a idade da pessoa é divisível por cinco.

code language-sql
{%= person.age % 5 = 0 %}

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.

Sintaxe
code language-sql
{%= countOnlyNull(array) %}

Exemplo

code language-sql
{%= countOnlyNull([4,0,1,6,0,0]) %}

Retorna 3.

countWithNull count-with-null

Use a função countWithNull para contar todos os elementos de uma lista, incluindo valores nulos.

Sintaxe
code language-sql
{%= countWithNull(array) %}

Exemplo

code language-sql
{%= countOnlyNull([4,0,1,6,0,0]) %}

Retorna 6.

distinct distinct

Use a função distinct para obter valores de uma matriz ou lista com valores duplicados removidos.

Sintaxe
code language-sql
{%= distinct(array) %}

Exemplo

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

code language-sql
{%= distinct(person.orders.storeId).count() > 1 %}

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.

Sintaxe
code language-sql
{%= distinctCountWithNull(array) %}

Exemplo

code language-sql
{%= distinctCountWithNull([10,2,10,null]) %}

Retorna 3.

head head

Use a função head para retornar o primeiro item em uma matriz ou lista.

Sintaxe
code language-sql
{%= 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.

code language-sql
{%= head(topN(orders,price, 5)) %}

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.

Sintaxe
code language-sql
{%= topN(array, value, amount) %}
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
{%= topN(orders,price, 5) %}

no in

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

Sintaxe
code language-sql
{%= in(value, array) %}

Exemplo

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

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

inclui includes

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

Sintaxe
code language-sql
{%= includes(array,item) %}

Exemplo

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

code language-sql
{%= includes(person.favoriteColors,"red") %}

cruzamentos intersects

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

Sintaxe
code language-sql
{%= 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.

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

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.

Sintaxe
code language-sql
{%= bottomN(array, value, amount) %}
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
{%= bottomN(orders,price, 5) %}

notIn notin

Use a função notIn 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
code language-sql
{%= 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.

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

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.

Sintaxe
code language-sql
{%= subsetOf(array1, array2) %}

Exemplo

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

code language-sql
{%= subsetOf(person.favoriteCities,person.visitedCities) %}

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.

Sintaxe
code language-sql
{%= supersetOf(array1, array2) %}

Exemplo

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

code language-sql
{%= supersetOf(person.eatenFoods,["sushi", "pizza"]) %}

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.

Sintaxe
code language-sql
{%= addDays(date, number) %}

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.

Sintaxe
code language-sql
{%= addHours(date, number) %}

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.

Sintaxe
code language-sql
{%= addMinutes(date, number) %}

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.

Sintaxe
code language-sql
{%= addMonths(date, number) %}

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.

Sintaxe
code language-sql
{%= addSeconds(date, number) %}

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.

Sintaxe
code language-sql
{%= addYears(date, number) %}

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.

Sintaxe
code language-sql
 {%= age(datetime) %}

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.

Sintaxe
code language-sql
{%= ageInDays(date) %}

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.

Sintaxe
code language-sql
{%= ageInMonths(date) %}

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.

Sintaxe
code language-sql
{%= compareDates(date1, date2) %}

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.

Sintaxe
code language-sql
{%= convertZonedDateTime(dateTime, timezone) %}

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.

Sintaxe
code language-sql
{%= currentTimeInMillis() %}

dateDiff date-diff

Use a função dateDiff para recuperar a diferença entre duas datas em número de dias.

Sintaxe
code language-sql
{%= dateDiff(datetime,datetime) %}

dayOfMonth day-month

dayOfMonth retorna o número que representa o dia do mês.

Sintaxe
code language-sql
{%= dayOfMonth(datetime) %}

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.

Sintaxe
code language-sql
{%= dayOfWeek(datetime) %}

dayOfYear day-year

Use a função dayOfYear para recuperar o dia do ano.

Sintaxe
code language-sql
{%= dayOfYear(datetime) %}

diffInSeconds diff-seconds

A função diffInSeconds retorna a diferença entre duas datas em termos de segundos.

Sintaxe
code language-sql
{%= diffInSeconds(endDate, startDate) %}

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.

Sintaxe
code language-sql
{%= extractHours(date) %}

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.

Sintaxe
code language-sql
{%= extractMinutes(date) %}

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.

Sintaxe
code language-sql
{%= extractMonths(date) %}

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.

Sintaxe
code language-sql
{%= extractSeconds(date) %}

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.

Sintaxe
code language-sql
{%= formatDate(datetime, format) %}

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
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}

Caracteres padrão pattern-characters

Algumas letras de padrão podem parecer semelhantes, mas representam conceitos diferentes.

Padrão
Significado
Exemplo (para 2023-12-31T10:15:30Z)
y
Ano civil (ano padrão)
2023
Y
Ano com base em semana (ISO 8601). Pode diferir nos limites do ano.
2024 (31 de dezembro de 2023 cai na primeira semana de 2024)
M
Mês do ano (1-12 ou texto como Jan, January)
12 ou Dec
m
Minuto da hora (0-59)
15
d
Dia do mês (1-31)
31
D
Dia do ano (1-366)
365

Formatar 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.

Sintaxe
code language-sql
{%= formatDate(datetime, format, locale) %}

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
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY", "fr_FR") %}

getCurrentZonedDateTime get-current-zoned-date-time

A função getCurrentZonedDateTime retorna a data e a hora atuais com informações de fuso horário.

Sintaxe
code language-sql
{%= getCurrentZonedDateTime() %}

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.

Sintaxe
code language-sql
{%= diffInHours(endDate, startDate) %}

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.

Sintaxe
code language-sql
{%= diffInMinutes(endDate, startDate) %}

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.

Sintaxe
code language-sql
{%= diffInMonths(endDate, startDate) %}

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.

Sintaxe
code language-sql
{%= setDays(datetime, day) %}

setHours set-hours

Use a função setHours para definir a hora da data-hora.

Sintaxe
code language-sql
{%= setHours(datetime, hour) %}

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.

Sintaxe
code language-sql
{%= toDateTime(string, string) %}

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.

Sintaxe
code language-sql
{%= toUTC(datetime) %}

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.

Sintaxe
code language-sql
{%= truncateToStartOfDay(date) %}

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.

Sintaxe
code language-sql
{%= truncateToStartOfQuarter(dateTime) %}

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

Sintaxe
code language-sql
{%= truncateToStartOfWeek(dateTime) %}

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.

Sintaxe
code language-sql
{%= truncateToStartOfYear(dateTime) %}

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.

Sintaxe
code language-sql
{%= weekOfYear(datetime) %}

diffInYears diff-years

Use a função diffInYears para retornar a diferença entre duas datas em termos de anos.

Sintaxe
code language-sql
{%= diffInYears(endDate, startDate) %}: int

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.

Sintaxe
code language-sql
{%= query1 and query2 %}

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
{%= profile.homeAddress.country = "France" and profile.person.birthYear = 1985 %}

ou or

A função or é usada para criar uma disjunção lógica.

Sintaxe
code language-sql
{%= query1 or query2 %}

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
{%= profile.homeAddress.country = "France" or profile.person.birthYear = 1985 %}

é igual a operator-equals

A função = (igual a) verifica se um valor ou expressão é igual a outro valor ou expressão.

Sintaxe
code language-sql
{%= expression = value %}

Exemplo

A operação a seguir verifica se o país do endereço residencial é a França.

code language-sql
{%= profile.homeAddress.country = "France" %}

diferente de notequal

A função != (diferente de) verifica se um valor ou expressão é não igual a outro valor ou expressão.

Sintaxe
code language-sql
{%= expression != value %}

Exemplo

A operação a seguir verifica se o país do endereço residencial não é a França.

code language-sql
{%= profile.homeAddress.country != "France" %}

maior que greaterthan

Use a função > (maior que) para verificar se o primeiro valor é maior que o segundo valor.

Sintaxe
code language-sql
{%= expression1 > expression2 %}

Exemplo

A operação a seguir define pessoas nascidas estritamente após 1970.

code language-sql
{%= profile.person.birthYear > 1970 %}

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.

Sintaxe
code language-sql
{%= expression1 >= expression2 %}

Exemplo

A operação a seguir define pessoas nascidas em ou após 1970.

code language-sql
{%= profile.person.birthYear >= 1970 %}

menor que lessthan

Use a função de comparação < (menor que) para verificar se o primeiro valor é menor que o segundo valor.

Sintaxe
code language-sql
{%= expression1 < expression2 %}

Exemplo

A operação a seguir define pessoas nascidas antes de 2000.

code language-sql
{%= profile.person.birthYear < 2000 %}

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.

Sintaxe
code language-sql
{%= expression1 <= expression2 %}

Exemplo

A operação a seguir define pessoas nascidas em 2000 ou antes.

code language-sql
{%= profile.person.birthYear <= 2000 %}

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.

Sintaxe
code language-sql
Hello {%=profile.personalEmail.name.firstName ?: "there" %}!

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.

Sintaxe
code language-sql
{%#if contains(account.accountOrganization.primaryEmailDomain, ".edu")%}
<a href="https://www.adobe.com/academia">Check out this link</a>

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
{
    {
        {%#if condition1%} element_1
        {%else if condition2%} element_2
        {%else%} default_element
        {%/if%}
    }
}

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.

Sintaxe
code language-sql
{%#unless unlessCondition%} element_1 {%else%} default_element {%/unless%}

Exemplo

Renderize algum conteúdo com base na extensão de endereço de email:

code language-sql
{%#unless endsWith(account.accountOrganization.primaryEmailDomain}, ".edu")%}
Some Normal Content
{%else%}
Some edu specific content
{%/unless%}

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.

Sintaxe
code language-sql
{{#each profile.productsInCart}}
    <li>{{this.name}}</li>
{{/each}}

Exemplo

code language-sql
{{#each profile.homeAddress.city}}
  {{@index}} : {{this}}<br>
{{/each}}

Exemplo

Renderize uma lista de produtos que este usuário tem em seu carrinho:

code language-sql
{{#each profile.products as |product|}}
    <li>{{product.productName}} {{product.productRating}}</li>
{{/each}}

com with

Use o auxiliar with para alterar o token de avaliação da parte do modelo.

Sintaxe
code language-sql
{{#with profile.person.name}}
{{this.firstName}} {{this.lastName}}
{{/with}}

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
{{#with profile.person.name as |name|}}
 Hi {{name.firstName}} {{name.lastName}}!
 Checkout our trending products for today!
{{/with}}

let let

A função let permite que uma expressão seja armazenada como uma variável a ser usada posteriormente em uma consulta.

Sintaxe
code language-sql
{% let variable = expression %} {{variable}}

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
{% let sum = 0%}
    {{#each profile.productsInCart as |p|}}
        {%#if p.price>100 and p.price<1000%}
            {%let sum = sum + p.price %}
        {%/if%}
    {{/each}}
{{sum}}

Metadados de execução execution-metadata

AVAILABILITY
Esse recurso está com disponibilidade limitada. Entre em contato com o representante da Adobe para obter acesso.

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.

NOTE
As ações personalizadas não oferecem suporte à função 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.

Sintaxe
code language-none
{{executionMetadata key="your_key" value="your_value"}}

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
"_experience": {
  "customerJourneyManagement": {
    "messageExecution": {
      "metadata": {
        "your_key": "your_value"
      }
    }
  }
}
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
{{executionMetadata key="firstName" value=profile.person.name.firstName}}

Neste exemplo, assumindo profile.person.name.firstName = "Alex", a entidade resultante é:

code language-none
{
  "key": "firstName",
  "value": "Alex"
}

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.

Sintaxe
code language-sql
{%= get(map, string) %}

Exemplo

A operação a seguir obtém o valor do mapa de identidade para a chave example@example.com.

code language-sql
{%= get(identityMap,"example@example.com") %}

chaves keys

Use a função keys para recuperar todas as chaves de um determinado mapa.

Sintaxe
code language-sql
{%= keys(map) %}

Exemplo

A operação a seguir recupera todas as chaves do mapa identityMap.

code language-sql
{%= keys(identityMap) %}

valores values

A função values é usada para recuperar todos os valores de um determinado mapa.

Sintaxe
code language-sql
{%= values(map) %}

Exemplo

A operação a seguir recupera todos os valores do mapa identityMap.

code language-sql
{%= values(identityMap) %}

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.

Sintaxe
code language-sql
{%= absolute(int) %}: int

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.

Sintaxe
code language-sql
{%= formatNumber(number/double,string) %}: string

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
{%= formatNumber(123456.789, "ar_EG") %}

random random

Use a função random para retornar um valor aleatório entre 0 e 1.

Sintaxe
code language-sql
{%= random() %}: double

roundDown round-down

Use a função roundDown para arredondar um número para baixo.

Sintaxe
code language-sql
{%= roundDown(double) %}: double

roundUp round-up

Use a função roundUp para arredondar um número para cima.

Sintaxe
code language-sql
{%= roundUp(double) %}: double

toHexString to-hex-string

A função toHexString converte qualquer número em sua cadeia de caracteres hexadecimal.

Sintaxe
code language-sql
{%= toHexString(number) %}: string

Exemplo

Esta consulta retorna o valor hexadecimal de 158 como 9e.

code language-sql
{%= toHexString(158) %}

toInt to-int

Use a função toInt para converter tipos (número, duplo, inteiro, longo, flutuante, curto, byte, booleano, string) em um inteiro.

Sintaxe
code language-sql
{%= toInt(<valueToConvert>) %}: integer

Exemplo

Esta consulta retorna o valor inteiro de 42,6 como 42.

code language-sql
{%= toInt(42.6) %}: integer

toPercentage to-percentage

Use a função toPercentage para converter um número em porcentagem.

Sintaxe
code language-sql
{%= toPercentage(double) %}: string

toPrecision to-precision

Use a função toPrecision para converter um número na precisão necessária.

Sintaxe
code language-sql
{%= toPrecision(double,int) %}: string

toString to-string

A função toString converte qualquer número em sua representação de cadeia de caracteres.

Sintaxe
code language-sql
{%= toString(string) %}: string

Exemplo

Esta consulta retorna "12".

code language-sql
{%= toString(12) %}

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.

Sintaxe
code language-sql
{%= isNull(object) %}

Exemplo

A operação a seguir verifica se o endereço residencial da pessoa não existe.

code language-sql
{%= isNull(person.homeAddress) %}

isNotNull isNotNull

A função isNotNull determina se existe uma referência de objeto.

Sintaxe
code language-sql
{%= isNotNull(object) %}

Exemplo

A operação a seguir verifica se o endereço residencial da pessoa existe.

code language-sql
{%= isNotNull(person.homeAddress) %}

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.

Sintaxe
code language-sql
{%= camelCase(string)%}

Exemplo

A função a seguir coloca a primeira letra de uma palavra em maiúscula no endereço do perfil.

code language-sql
{%= camelCase(profile.homeAddress.street) %}

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.

Sintaxe
code language-sql
{%= charCodeAt(string,int) %}: int

Exemplo

A função a seguir retorna o valor ASCII de o (111).

code language-sql
{%= charCodeAt("some", 1)%}

concat concate

A função concat combina duas cadeias de caracteres em uma.

Sintaxe
code language-sql
{%= concat(string,string) %}

Exemplo

A função a seguir combina o perfil cidade e país em uma única sequência.

code language-sql
{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

contém contains

Use a função contains para determinar se uma cadeia de caracteres contém uma subsequência especificada.

Sintaxe
code language-sql
{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
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.

Sintaxe
code language-sql
{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}
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
{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}

doesNotEndWith doesNotEndWith

Use a função doesNotEndWith para determinar se uma cadeia de caracteres não termina com uma subcadeia especificada.

Sintaxe
code language-sql
{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
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
doesNotEndWith(person.emailAddress,".com")

doesNotStartWith doesNotStartWith

Use a função doesNotStartWith para determinar se uma cadeia de caracteres não inicia com uma subcadeia especificada.

Sintaxe
code language-sql
{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
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
{%= doesNotStartWith(person.name,"Joe")%}

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.

Sintaxe
code language-sql
{%= encode64(string) %}

endsWith endsWith

Use a função endsWith para determinar se uma sequência de caracteres termina com uma subsequência especificada.

Sintaxe
code language-sql
{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
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
{%= endsWith(person.emailAddress,".com") %}

é 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.

Sintaxe
code language-sql
{%= equals(STRING_1, STRING_2) %}
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
{%=equals(profile.person.name,"John") %}

equalsIgnoreCase equalsIgnoreCase

Use a função equalsIgnoreCase para determinar se uma cadeia de caracteres é igual à cadeia especificada, sem diferenciar maiúsculas de minúsculas.

Sintaxe
code language-sql
{%= equalsIgnoreCase(STRING_1, STRING_2) %}
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
{%= equalsIgnoreCase(profile.person.name,"John") %}

extractEmailDomain extractEmailDomain

Use a função extractEmailDomain para extrair o domínio de um endereço de email.

Sintaxe
code language-sql
{%= extractEmailDomain(string) %}

Exemplo

A consulta a seguir extrai o domínio de email do endereço de email pessoal.

code language-sql
{%= extractEmailDomain(profile.personalEmail.address) %}

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.

Sintaxe
code language-sql
{%= formatCurrency(number/double,string) %}: string

Exemplo

Esta consulta retorna £ 56,00

code language-sql
{%= formatCurrency(56L,"en_GB") %}

getUrlHost get-url-host

Use a função getUrlHost para recuperar o nome de host de uma URL.

Sintaxe
code language-sql
{%= getUrlHost(string) %}: string

Exemplo

code language-sql
{%= getUrlHost("https://www.myurl.com/contact") %}

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.

Sintaxe
code language-sql
{%= getUrlPath(string) %}: string

Exemplo

code language-sql
{%= getUrlPath("https://www.myurl.com/contact.html") %}

Retorna "/contact.html"

getUrlProtocol get-url-protocol

Use a função getUrlProtocol para recuperar o protocolo de uma URL.

Sintaxe
code language-sql
{%= getUrlProtocol(string) %}: string

Exemplo

code language-sql
{%= getUrlProtocol("https://www.myurl.com/contact.html") %}

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.

Sintaxe
code language-sql
{%= indexOf(STRING_1, STRING_2) %}: integer
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
{%= indexOf("hello world","world" ) %}

Retorna 6.

isEmpty isEmpty

Use a função isEmpty para determinar se uma cadeia de caracteres está vazia.

Sintaxe
code language-sql
{%= isEmpty(string) %}

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
{%= isEmpty(profile.mobilePhone.number) %}

isNotEmpty is-not-empty

Use a função isNotEmpty para determinar se uma cadeia de caracteres não está vazia.

Sintaxe
code language-sql
{= isNotEmpty(string) %}: boolean

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
{%= isNotEmpty(profile.mobilePhone.number) %}

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.

Sintaxe
code language-sql
{= lastIndexOf(STRING_1, STRING_2) %}: integer
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
{%= lastIndexOf("hello world","o" ) %}

Retorna 7.

leftTrim leftTrim

Use a função leftTrim para remover espaços em branco do início de uma cadeia.

Sintaxe
code language-sql
{%= leftTrim(string) %}

length length

Use a função length para obter o número de caracteres em uma cadeia de caracteres ou expressão.

Sintaxe
code language-sql
{%= length(string) %}

Exemplo

A função a seguir retorna o comprimento do nome da cidade do perfil.

code language-sql
{%= length(profile.homeAddress.city) %}

curtir like

Use a função like para determinar se uma cadeia de caracteres corresponde a um padrão especificado.

Sintaxe
code language-sql
{%= like(STRING_1, STRING_2) %}
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: % e _.

  • % é usado para representar zero ou mais caracteres.
  • _ é usado para representar exatamente um caractere.

Exemplo

A consulta a seguir recupera todas as cidades em que os perfis vivem contendo o padrão es.

code language-sql
{%= like(profile.homeAddress.city, "%es%")%}

lowerCase lower

Use a função lowerCase para converter uma cadeia de caracteres em letras minúsculas.

Sintaxe
code language-sql
{%= lowerCase(string) %}

Exemplo

Essa função converte o nome do perfil em letras minúsculas.

code language-sql
{%= lowerCase(profile.person.name.firstName) %}

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.

Sintaxe
code language-sql
{%= matches(STRING_1, STRING_2) %}

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
{%= matches(person.name.,"(?i)^John") %}

máscara mask

Use a função mask para substituir uma parte de uma cadeia de caracteres por caracteres "X".

Sintaxe
code language-sql
{%= mask(string,integer,integer) %}

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
{%= mask("123456789",1,2) %}

A consulta retorna 1XXXXXX89.

md5 md5

Use a função md5 para calcular e retornar o hash md5 de uma cadeia de caracteres.

Sintaxe
code language-sql
{%= md5(string) %}: string

Exemplo

code language-sql
{%= md5("hello world") %}

Retorna "5eb63bbbbe01eed093cb22bb8f5acdc3"

notEqualTo notEqualTo

Use a função notEqualTo para determinar se uma cadeia de caracteres não é igual à cadeia especificada.

Sintaxe
code language-sql
{%= notEqualTo(STRING_1, STRING_2) %}
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
{%= notEqualTo(profile.person.name,"John") %}

notEqualWithIgnoreCase not-equal-with-ignore-case

Use a função notEqualWithIgnoreCase para comparar duas cadeias de caracteres ignorando maiúsculas e minúsculas.

Sintaxe
code language-sql
{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean
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
{%= notEqualTo(profile.person.name,"john") %}

regexGroup regexGroup

Use a função regexGroup para extrair informações específicas com base na expressão regular fornecida.

Sintaxe
code language-sql
{%= regexGroup(STRING, EXPRESSION, GROUP) %}
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
{%= regexGroup(emailAddress,"@(\\w+)", 1) %}

replace replace

Use a função replace para substituir uma determinada substring em uma string por outra substring.

Sintaxe
code language-sql
{%= replace(STRING_1,STRING_2,STRING_3) %}:string
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
{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}

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.

Sintaxe
code language-sql
{%= replaceAll(string,string,string) %}
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.

Sintaxe
code language-sql
{%= rightTrim(string) %}

sha256 sha256

A função sha256 calcula e retorna o hash sha256 de uma cadeia de caracteres.

Sintaxe
code language-sql
{%= sha256(string) %} : string

Exemplo

code language-sql
{%= sha256("Eliechxh")%}

Retorna 0b0b207880b999adaad6231026abf87caa30760b6f326b21727b61139332257d

split split

Use a função split para dividir uma cadeia de caracteres por um determinado caractere.

Sintaxe
code language-sql
{%= split(string,string) %}

startsWith startsWith

Use a função startsWith para determinar se uma sequência de caracteres inicia com uma subsequência especificada.

Sintaxe
code language-sql
{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
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
{%= startsWith(person.name,"Joe") %}

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.

Sintaxe
code language-sql
{= stringToDate("date-time value","formatter" %}

Exemplo

code language-sql
{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}

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.

Sintaxe
code language-sql
{= string_to_integer(string) %}: int

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.

Sintaxe
code language-sql
{%= stringToNumber(string) %}: double

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.

Sintaxe
code language-sql
{= substr(string, integer, integer) %}: string

titleCase titleCase

Use a função titleCase para colocar as primeiras letras de cada palavra de uma cadeia de caracteres em maiúsculas.

Sintaxe
code language-sql
{%= titleCase(string) %}

Exemplo

Se a pessoa mora na Washington High Street, essa função retornará Washington High Street.

code language-sql
{%= titleCase(profile.person.location.Street) %}

toBool to-bool

Use a função toBool para converter um valor de argumento em um valor booleano, dependendo de seu tipo.

Sintaxe
code language-sql
{= toBool(string) %}: boolean

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.

Sintaxe
code language-sql
{%= toDateTime(string, string) %}: date-time

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.

Sintaxe
code language-sql
{%= toDateTimeOnly(string/date/long/int) %}: date-time

trim trim

A função trim remove todos os espaços em branco do início e do fim de uma cadeia de caracteres.

Sintaxe
code language-sql
{%= trim(string) %}

upperCase upper

A função upperCase converte uma cadeia de caracteres em letras maiúsculas.

Sintaxe
code language-sql
{%= upperCase(string) %}

Exemplo

Esta função converte o sobrenome do perfil em letras maiúsculas.

code language-sql
{%= upperCase(profile.person.name.lastName) %}

urlDecode url-decode

Use a função urlDecode para decodificar uma cadeia de caracteres codificada em URL.

Sintaxe
code language-sql
{%= urlDecode(string) %}: string

urlEncode url-encode

Use a função urlEncode para codificar uma cadeia de caracteres como uma URL.

Sintaxe
code language-sql
{%= urlEncode(string) %}: string
recommendation-more-help
6ef00091-a233-4243-8773-0da8461f7ef0