Funzioni Helper

Utilizza le funzioni helper nell’editor di personalizzazione per definire esperienze di contenuto personalizzate con precisione ed efficienza, manipolando i dati, eseguendo calcoli e formattando i contenuti. Esplora e sperimenta queste funzioni, operatori e collaboratori per scoprire come collaborano per aiutarti a creare percorsi personalizzati basati sui dati.

Funzioni di aggregazione

Utilizzare le funzioni di aggregazione per raggruppare più valori in modo da formare un singolo valore di riepilogo. È inoltre possibile utilizzare le funzioni array ed elenco per definire più facilmente le interazioni con array, elenchi e stringhe.

media average

Utilizzare la funzione average per restituire la media aritmetica di tutti i valori selezionati all'interno dell'array.

{%= average(array) %}

{%=average(orders.order.price)%}

conteggio count

Utilizzare la funzione count per restituire il numero di elementi all'interno dell'array specificato.

{%= count(array) %}

{%= count(orders) %}

max max

Utilizzare la funzione max per restituire il più grande di tutti i valori selezionati all'interno dell'array.

{%= max(array) %}

{%=max(orders.order.price)%}

min min

Utilizzare la funzione min per restituire il più piccolo di tutti i valori selezionati all'interno dell'array.

{%= min(array) %}

{%=min(orders.order.price) %}

sum sum

Utilizzare la funzione sum per restituire la somma di tutti i valori selezionati all'interno dell'array.

{%= sum(array) %}

 {%=sum(orders.order.price)%}

Funzioni aritmetiche maths

Utilizza le funzioni aritmetiche per eseguire calcoli di base sui valori.

aggiungi add

Utilizzare la funzione + (addizione) per trovare la somma di due espressioni di argomento.

{%= double + double %}

{%= product1.price + product2.price %}

moltiplicare multiply

Utilizzare la funzione * (moltiplicazione) per trovare il prodotto di due espressioni di argomento.

{%= double * double %}

{%= product.inventory * product.price %}

sottrarre substract

Utilizzare la funzione - (sottrazione) per trovare la differenza tra due espressioni di argomento.

{%= double - double %}

{%= product1.price - product2.price %}

dividere divide

Utilizzare la funzione / (divisione) per trovare il quoziente di due espressioni di argomento.

{%= double / double %}

{%= totalProduct.price / totalProduct.sold %}

resto remainder

Utilizzare la funzione % (resto) per trovare il resto dopo aver diviso le due espressioni di argomento.

{%= double % double %}

{%= person.age % 5 = 0 %}

Funzioni array ed elenco arrays

Utilizzare queste funzioni per semplificare l'interazione con array, elenchi e stringhe.

countOnlyNull count-only-null

Utilizzare la funzione countOnlyNull per contare il numero di valori Null in un elenco.

{%= countOnlyNull(array) %}

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

countWithNull count-with-null

Utilizzare la funzione countWithNull per contare tutti gli elementi di un elenco, inclusi i valori Null.

{%= countWithNull(array) %}

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

distinct distinct

Utilizzare la funzione distinct per ottenere valori da un array o da un elenco con valori duplicati rimossi.

{%= distinct(array) %}

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

distinctCountWithNull distinct-count-with-null

Utilizzare la funzione distinctCountWithNull per contare il numero di valori diversi in un elenco, inclusi i valori Null.

{%= distinctCountWithNull(array) %}

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

testa head

Utilizzare la funzione head per restituire il primo elemento di un array o di un elenco.

{%= head(array) %}

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

topN first-n

La funzione topN ordina una matrice in ordine decrescente in base all'espressione numerica specificata e restituisce i primi N elementi. Se la dimensione dell'array è inferiore a N, restituisce l'intero array ordinato.

{%= topN(array, value, amount) %}

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

in in

Utilizzare la funzione in per determinare se un elemento è membro di un array o di un elenco.

{%= in(value, array) %}

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

include includes

Utilizzare la funzione includes per determinare se un array o un elenco contiene un elemento specifico.

{%= includes(array,item) %}

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

interseca intersects

La funzione intersects viene utilizzata per determinare se due array o elenchi hanno almeno un membro comune.

{%= intersects(array1, array2) %}

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

bottomN last-n

La funzione bottomN ordina una matrice in ordine crescente in base all'espressione numerica specificata e restituisce i primi N elementi. Se la dimensione dell'array è inferiore a N, restituisce l'intero array ordinato.

{%= bottomN(array, value, amount) %}

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

notIn notin

Utilizzare la funzione notIn per determinare se un elemento non è un membro di un array o di un elenco.

{%= notIn(value, array) %}

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

subsetOf subset

Utilizzare la funzione subsetOf per determinare se un array specifico (array A) è un sottoinsieme di un altro array (array B). In altre parole, che tutti gli elementi nell'array A sono elementi dell'array B.

{%= subsetOf(array1, array2) %}

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

supersetOf superset

Utilizzare la funzione supersetOf per determinare se un array specifico (array A) è un superset di un altro array (array B). In altre parole, l’array A contiene tutti gli elementi dell’array B.

{%= supersetOf(array1, array2) %}

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

Funzioni data e ora date-time

Utilizzare le funzioni di data e ora per eseguire operazioni di data e ora sui valori.

addDays add-days

La funzione addDays regola una data specificata di un numero specificato di giorni, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.

{%= addDays(date, number) %}

addHours add-hours

La funzione addHours regola una data specificata di un numero specificato di ore, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.

{%= addHours(date, number) %}

addMinutes add-minutes

La funzione addMinutes regola una data specificata di un numero specificato di minuti, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.

{%= addMinutes(date, number) %}

addMonths add-months

La funzione addMonths regola una data specificata di un numero specificato di mesi, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.

{%= addMonths(date, number) %}

addSeconds add-seconds

La funzione addSeconds regola una data specificata di un numero specificato di secondi, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.

{%= addSeconds(date, number) %}

addYears add-years

La funzione addYears regola una data specificata di un numero specificato di anni, utilizzando valori positivi per l'incremento e valori negativi per la riduzione.

{%= addYears(date, number) %}

età age

Utilizzare la funzione age per recuperare l'età da una data specificata.

 {%= age(datetime) %}

ageInDays age-days

La funzione ageInDays calcola il numero di giorni trascorsi tra la data specificata e la data corrente. Utilizza valori negativi per le date future e positivi per le date passate.

{%= ageInDays(date) %}

ageInMonths age-months

La funzione ageInMonths calcola il numero di mesi trascorsi tra la data specificata e la data corrente. Utilizza valori negativi per le date future e positivi per le date passate.

{%= ageInMonths(date) %}

compareDates compare-dates

La funzione compareDates confronta la prima data di input con l'altra. Restituisce 0 se data1 è uguale a data2, -1 se data1 precede data2 e 1 se data1 segue data2.

{%= compareDates(date1, date2) %}

convertZonedDateTime convert-zoned-date-time

La funzione convertZonedDateTime converte una data/ora in un determinato fuso orario.

{%= convertZonedDateTime(dateTime, timezone) %}

currentTimeInMillis current-time

Utilizzare la funzione currentTimeInMillis per recuperare il tempo corrente in millisecondi epoca.

{%= currentTimeInMillis() %}

dateDiff date-diff

Utilizzare la funzione dateDiff per recuperare la differenza tra due date in un numero di giorni.

{%= dateDiff(datetime,datetime) %}

dayOfMonth day-month

dayOfMonth restituisce il numero che rappresenta il giorno del mese.

{%= dayOfMonth(datetime) %}

DayOfWeek day-week

Utilizzare la funzione dayOfWeek per recuperare il giorno della settimana.

{%= dayOfWeek(datetime) %}

dayOfYear day-year

Utilizzare la funzione dayOfYear per recuperare il giorno dell'anno.

{%= dayOfYear(datetime) %}

diffInSeconds diff-seconds

La funzione diffInSeconds restituisce la differenza tra due date in secondi.

{%= diffInSeconds(endDate, startDate) %}

extractHours extract-hours

La funzione extractHours estrae il componente Ora da un determinato timestamp.

{%= extractHours(date) %}

extractMinutes extract-minutes

La funzione extractMinutes estrae il componente del minuto da un determinato timestamp.

{%= extractMinutes(date) %}

extractMonths extract-months

La funzione extractMonth estrae il componente mese da un determinato timestamp.

{%= extractMonths(date) %}

extractSeconds extract-seconds

La funzione extractSeconds estrae il secondo componente da un determinato timestamp.

{%= extractSeconds(date) %}

formatDate format-date

Utilizzare la funzione formatDate per formattare un valore di data e ora. Il formato deve essere un pattern Java DateTimeFormat valido.

{%= formatDate(datetime, format) %}

{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}

Caratteri pattern pattern-characters

Alcune lettere di serie possono avere un aspetto simile, ma rappresentano concetti diversi.

Formattare la data con il supporto delle impostazioni internazionali format-date-locale

È possibile utilizzare la funzione formatDate per formattare un valore di data e ora nella corrispondente rappresentazione sensibile alla lingua, ad esempio per le impostazioni locali desiderate. Il formato deve essere un pattern Java DateTimeFormat valido.

{%= formatDate(datetime, format, locale) %}

{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY", "fr_FR") %}

getCurrentZonedDateTime get-current-zoned-date-time

La funzione getCurrentZonedDateTime restituisce la data e l'ora correnti con le informazioni sul fuso orario.

{%= getCurrentZonedDateTime() %}

diffInHours hours-difference

La funzione diffInHours restituisce la differenza tra due date in termini di ore.

{%= diffInHours(endDate, startDate) %}

diffInMinutes diff-minutes

La funzione diffInMinutes restituisce la differenza tra due date in termini di minuti.

{%= diffInMinutes(endDate, startDate) %}

diffInMonths months-difference

La funzione diffInMonths restituisce la differenza tra due date in termini di mesi.

{%= diffInMonths(endDate, startDate) %}

setDays set-days

Utilizzare la funzione setDays per impostare il giorno del mese per la data/ora specificata.

{%= setDays(datetime, day) %}

setHours set-hours

Utilizzare la funzione setHours per impostare l'ora della data/ora.

{%= setHours(datetime, hour) %}

toDateTime string-to-date-time

La funzione toDateTime converte la stringa in data. In caso di input non valido, restituisce la data epoca come output.

{%= toDateTime(string, string) %}

toUTC to-utc

Utilizzare la funzione toUTC per convertire un datetime in UTC.

{%= toUTC(datetime) %}

truncateToStartOfDay truncate-day

Utilizzare la funzione truncateToStartOfDay per modificare una data/ora specificata impostandola all'inizio del giorno con ora 00:00.

{%= truncateToStartOfDay(date) %}

truncateToStartOfQuarter truncate-quarter

Utilizzare la funzione truncateToStartOfQuarter per troncare una data/ora al primo giorno del trimestre (ad esempio 1 gennaio, 1 aprile, 1 luglio, 1 ottobre) alle 00:00.

{%= truncateToStartOfQuarter(dateTime) %}

truncateToStartOfWeek truncate-week

La funzione truncateToStartOfWeek modifica una data/ora specificata impostandola all'inizio della settimana (lunedì alle 00:00).

{%= truncateToStartOfWeek(dateTime) %}

truncateToStartOfYear truncate-year

Utilizzare la funzione truncateToStartOfYear per modificare una data/ora specificata troncandola al primo giorno dell'anno (1 gennaio) alle 00:00.

{%= truncateToStartOfYear(dateTime) %}

weekOfYear week-of-year

Utilizzare la funzione weekOfYear per recuperare la settimana dell'anno.

{%= weekOfYear(datetime) %}

diffInYears diff-years

Utilizzare la funzione diffInYears per restituire la differenza tra due date in termini di anni.

{%= diffInYears(endDate, startDate) %}: int

Funzioni dell'operatore operators

Utilizza le funzioni booleane e di confronto per eseguire valutazioni logiche.

e and

La funzione and viene utilizzata per creare una congiunzione logica.

{%= query1 and query2 %}

{%= profile.homeAddress.country = "France" and profile.person.birthYear = 1985 %}

oppure or

La funzione or viene utilizzata per creare una disgiunzione logica.

{%= query1 or query2 %}

{%= profile.homeAddress.country = "France" or profile.person.birthYear = 1985 %}

uguale a operator-equals

La funzione = (è uguale a) controlla se un valore o un'espressione è uguale a un altro valore o espressione.

{%= expression = value %}

{%= profile.homeAddress.country = "France" %}

non uguale notequal

La funzione != (diverso da) controlla se un valore o un'espressione è diverso uguale a un altro valore o espressione.

{%= expression != value %}

{%= profile.homeAddress.country != "France" %}

maggiore di greaterthan

Utilizzare la funzione > (maggiore di) per verificare se il primo valore è maggiore del secondo valore.

{%= expression1 > expression2 %}

{%= profile.person.birthYear > 1970 %}

maggiore o uguale a greaterthanorequal

Utilizzare la funzione >= (maggiore o uguale a) per verificare se il primo valore è maggiore o uguale al secondo valore.

{%= expression1 >= expression2 %}

{%= profile.person.birthYear >= 1970 %}

minore di lessthan

Utilizzare la funzione di confronto < (minore di) per verificare se il primo valore è minore del secondo valore.

{%= expression1 < expression2 %}

{%= profile.person.birthYear < 2000 %}

minore o uguale a lessthanorequal

Utilizzare la funzione di confronto <= (minore o uguale a) per verificare se il primo valore è minore o uguale al secondo valore.

{%= expression1 <= expression2 %}

{%= profile.person.birthYear <= 2000 %}

Funzioni dinamiche dynamic-helpers

Utilizza le funzioni di assistenza dinamica per utilizzare valutazioni condizionali, iterazioni e assegnazioni di variabili per la personalizzazione dinamica.

Valore di fallback predefinito default-value

L'helper Default Fallback Value viene utilizzato per restituire un valore di fallback predefinito se un attributo è vuoto o nullo. Questo meccanismo funziona per gli attributi del profilo e gli eventi di Percorso.

Hello {%=profile.personalEmail.name.firstName ?: "there" %}!

if (condizioni) if-function

L'helper if viene utilizzato per definire un blocco condizionale.
Se la valutazione dell’espressione restituisce true, il blocco viene renderizzato, altrimenti viene saltato.

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

{
    {
        {%#if condition1%} element_1
        {%else if condition2%} element_2
        {%else%} default_element
        {%/if%}
    }
}

salvo unless

Utilizzare l'helper unless per definire un blocco condizionale. In opposizione all'helper if, se la valutazione dell'espressione restituisce false, viene eseguito il rendering del blocco.

{%#unless unlessCondition%} element_1 {%else%} default_element {%/unless%}

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

ogni each

Utilizza l'helper each per eseguire l'iterazione su un array.

La struttura helper è {{#each ArrayName}} YourContent {{/each}}

È possibile utilizzare la parola chiave this all'interno del blocco per fare riferimento ai singoli elementi dell'array. Utilizzare {{@index}} per eseguire il rendering dell'indice dell'elemento dell'array.

{{#each profile.productsInCart}}
    <li>{{this.name}}</li>
{{/each}}

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

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

con with

Utilizza l'helper with per modificare il token di valutazione della parte modello.

{{#with profile.person.name}}
{{this.firstName}} {{this.lastName}}
{{/with}}

{{#with profile.person.name as |name|}}
 Hi {{name.firstName}} {{name.lastName}}!
 Checkout our trending products for today!
{{/with}}

let let

La funzione let consente di archiviare un'espressione come variabile da utilizzare successivamente in una query.

{% let variable = expression %} {{variable}}

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

Metadati di esecuzione execution-metadata

Utilizzare executionMetadata per acquisire e archiviare coppie chiave-valore personalizzate in modo dinamico nel contesto di esecuzione del messaggio.

Con questa funzione, puoi aggiungere informazioni contestuali a qualsiasi azione nativa delle campagne o dei percorsi. Utilizzalo per esportare i dati contestuali di consegna in tempo reale verso sistemi esterni per vari scopi, come tracciamento, analisi, personalizzazione ed elaborazione a valle.

Ad esempio, puoi utilizzare l'helper executionMetadata per aggiungere un ID specifico a ciascuna consegna inviata a ciascun profilo. Queste informazioni vengono generate durante il runtime e i metadati di esecuzione arricchiti possono quindi essere esportati per la riconciliazione a valle con una piattaforma di reporting esterna.

{{executionMetadata key="your_key" value="your_value"}}

"_experience": {
  "customerJourneyManagement": {
    "messageExecution": {
      "metadata": {
        "your_key": "your_value"
      }
    }
  }
}

{{executionMetadata key="firstName" value=profile.person.name.firstName}}

{
  "key": "firstName",
  "value": "Alex"
}

Funzioni di mappatura maps

Utilizza le funzioni mappa nella personalizzazione per semplificare l’interazione con le mappe.

get get

Utilizzare la funzione get per recuperare il valore di una mappa per una determinata chiave.

{%= get(map, string) %}

{%= get(identityMap,"example@example.com") %}

tasti keys

Utilizzare la funzione keys per recuperare tutte le chiavi per una determinata mappa.

{%= keys(map) %}

{%= keys(identityMap) %}

valori values

La funzione values viene utilizzata per recuperare tutti i valori di una determinata mappa.

{%= values(map) %}

{%= values(identityMap) %}

Funzioni matematiche math

Scopri come utilizzare le funzioni matematiche nell’editor di personalizzazione.

assoluto absolute

Utilizzare la funzione absolute per convertire un numero nel relativo valore assoluto.

{%= absolute(int) %}: int

formatNumber format-number

Utilizzare la funzione formatNumber per formattare qualsiasi numero nella relativa rappresentazione sensibile alla lingua.

Accetta un numero e una stringa che rappresenta la lingua e restituisce una stringa formattata del numero nella lingua desiderata.

{%= formatNumber(number/double,string) %}: string

{%= formatNumber(123456.789, "ar_EG") %}

random random

Utilizzare la funzione random per restituire un valore casuale compreso tra 0 e 1.

{%= random() %}: double

roundDown round-down

Utilizzare la funzione roundDown per arrotondare un numero per difetto.

{%= roundDown(double) %}: double

roundUp round-up

Utilizzare la funzione roundUp per arrotondare un numero per eccesso.

{%= roundUp(double) %}: double

toHexString to-hex-string

La funzione toHexString converte qualsiasi numero nella relativa stringa esadecimale.

{%= toHexString(number) %}: string

{%= toHexString(158) %}

toInt to-int

Utilizzare la funzione toInt per convertire i tipi (number, double, integer, long, float, short, byte, boolean, string) in un numero intero.

{%= toInt(<valueToConvert>) %}: integer

{%= toInt(42.6) %}: integer

toPercentage to-percentage

Utilizzare la funzione toPercentage per convertire un numero in percentuale.

{%= toPercentage(double) %}: string

toPrecision to-precision

Utilizzare la funzione toPrecision per convertire un numero con la precisione richiesta.

{%= toPrecision(double,int) %}: string

toString to-string

La funzione toString converte qualsiasi numero nella relativa rappresentazione di stringa.

{%= toString(string) %}: string

{%= toString(12) %}

Funzioni oggetto objects

Funzioni oggetto per eseguire query sulle proprietà o sugli attributi dell'oggetto.

isNull isNull

La funzione isNull determina se un riferimento a un oggetto non esiste.

{%= isNull(object) %}

{%= isNull(person.homeAddress) %}

isNotNull isNotNull

La funzione isNotNull determina se esiste un riferimento a un oggetto.

{%= isNotNull(object) %}

{%= isNotNull(person.homeAddress) %}

Funzioni stringa string-functions

Scopri come utilizzare le funzioni stringa nell’editor di personalizzazione.

CamelCase camelCase

La funzione camelCase utilizza l'iniziale maiuscola di ogni parola di una stringa.

{%= camelCase(string)%}

{%= camelCase(profile.homeAddress.street) %}

charCodeAt char-code-at

La funzione charCodeAt restituisce il valore ASCII di un carattere, come la funzione charCodeAt in JavaScript. Come argomenti di input sono necessari una stringa e un numero intero (che definisce la posizione di un carattere) e viene restituito il valore ASCII corrispondente.

{%= charCodeAt(string,int) %}: int

{%= charCodeAt("some", 1)%}

concatena concate

La funzione concat combina due stringhe in una.

{%= concat(string,string) %}

{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

contiene contains

Utilizzare la funzione contains per determinare se una stringa contiene una sottostringa specificata.

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}

doesNotContain doesNotContain

Utilizzare la funzione doesNotContain per determinare se una stringa non contiene una sottostringa specificata.

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}

{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}

doesNotEndWith doesNotEndWith

Utilizzare la funzione doesNotEndWith per determinare se una stringa non termina con una sottostringa specificata.

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

doesNotEndWith(person.emailAddress,".com")

doesNotStartWith doesNotStartWith

Utilizzare la funzione doesNotStartWith per determinare se una stringa non inizia con una sottostringa specificata.

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

{%= doesNotStartWith(person.name,"Joe")%}

encode64 encode64

Utilizzare la funzione encode64 per codificare una stringa per conservare le informazioni personali (PI), ad esempio da includere in un URL.

{%= encode64(string) %}

endsWith endsWith

Utilizzare la funzione endsWith per determinare se una stringa termina con una sottostringa specificata.

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

{%= endsWith(person.emailAddress,".com") %}

uguale a equals

Utilizzare la funzione equals per determinare se una stringa è uguale alla stringa specificata, con distinzione tra maiuscole e minuscole.

{%= equals(STRING_1, STRING_2) %}

{%=equals(profile.person.name,"John") %}

equalsIgnoreCase equalsIgnoreCase

Utilizzare la funzione equalsIgnoreCase per determinare se una stringa è uguale alla stringa specificata, senza distinzione tra maiuscole e minuscole.

{%= equalsIgnoreCase(STRING_1, STRING_2) %}

{%= equalsIgnoreCase(profile.person.name,"John") %}

extractEmailDomain extractEmailDomain

Utilizzare la funzione extractEmailDomain per estrarre il dominio di un indirizzo e-mail.

{%= extractEmailDomain(string) %}

{%= extractEmailDomain(profile.personalEmail.address) %}

formatCurrency format-currency

Utilizzare la funzione formatCurrency per convertire qualsiasi numero nella corrispondente rappresentazione della valuta sensibile alla lingua a seconda delle impostazioni locali passate come stringa nel secondo argomento.

{%= formatCurrency(number/double,string) %}: string

{%= formatCurrency(56L,"en_GB") %}

getUrlHost get-url-host

Utilizzare la funzione getUrlHost per recuperare il nome host di un URL.

{%= getUrlHost(string) %}: string

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

getUrlPath get-url-path

Utilizzare la funzione getUrlPath per recuperare il percorso dopo il nome di dominio di un URL.

{%= getUrlPath(string) %}: string

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

getUrlProtocol get-url-protocol

Utilizzare la funzione getUrlProtocol per recuperare il protocollo di un URL.

{%= getUrlProtocol(string) %}: string

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

indexOf index-of

Utilizzare la funzione indexOf per restituire la posizione della prima occorrenza del secondo parametro nel primo argomento. Restituisce -1 se non viene trovata alcuna corrispondenza.

{%= indexOf(STRING_1, STRING_2) %}: integer

{%= indexOf("hello world","world" ) %}

IsEmpty isEmpty

Utilizzare la funzione isEmpty per determinare se una stringa è vuota.

{%= isEmpty(string) %}

{%= isEmpty(profile.mobilePhone.number) %}

isNotEmpty is-not-empty

Utilizzare la funzione isNotEmpty per determinare se una stringa non è vuota.

{= isNotEmpty(string) %}: boolean

{%= isNotEmpty(profile.mobilePhone.number) %}

lastIndexOf last-index-of

Utilizzare la funzione lastIndexOf per restituire la posizione (nel primo argomento) dell'ultima occorrenza del secondo parametro. Restituisce -1 se non viene trovata alcuna corrispondenza.

{= lastIndexOf(STRING_1, STRING_2) %}: integer

{%= lastIndexOf("hello world","o" ) %}

leftTrim leftTrim

Utilizzare la funzione leftTrim per rimuovere gli spazi dall'inizio di una stringa.

{%= leftTrim(string) %}

length length

Utilizzare la funzione length per ottenere il numero di caratteri in una stringa o in un'espressione.

{%= length(string) %}

{%= length(profile.homeAddress.city) %}

mi piace like

Utilizzare la funzione like per determinare se una stringa corrisponde a uno schema specificato.

{%= like(STRING_1, STRING_2) %}

{%= like(profile.homeAddress.city, "%es%")%}

lowerCase lower

Utilizzare la funzione lowerCase per convertire una stringa in lettere minuscole.

{%= lowerCase(string) %}

{%= lowerCase(profile.person.name.firstName) %}

matches matches

Utilizzare la funzione matches per determinare se una stringa corrisponde a una specifica espressione regolare. Per ulteriori informazioni sui pattern corrispondenti nelle espressioni regolari, consulta la documentazione di Oracle.

{%= matches(STRING_1, STRING_2) %}

{%= matches(person.name.,"(?i)^John") %}

maschera mask

Utilizzare la funzione mask per sostituire una parte di stringa con caratteri "X".

{%= mask(string,integer,integer) %}

{%= mask("123456789",1,2) %}

md5 md5

Utilizzare la funzione md5 per calcolare e restituire l'hash MD5 di una stringa.

{%= md5(string) %}: string

{%= md5("hello world") %}

notEqualTo notEqualTo

Utilizzare la funzione notEqualTo per determinare se una stringa non è uguale alla stringa specificata.

{%= notEqualTo(STRING_1, STRING_2) %}

{%= notEqualTo(profile.person.name,"John") %}

notEqualWithIgnoreCase not-equal-with-ignore-case

Utilizzare la funzione notEqualWithIgnoreCase per confrontare due stringhe ignorando la distinzione tra maiuscole e minuscole.

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean

{%= notEqualTo(profile.person.name,"john") %}

regexGroup regexGroup

Utilizza la funzione regexGroup per estrarre informazioni specifiche, in base all'espressione regolare fornita.

{%= regexGroup(STRING, EXPRESSION, GROUP) %}

{%= regexGroup(emailAddress,"@(\\w+)", 1) %}

replace replace

Utilizzare la funzione replace per sostituire una determinata sottostringa in una stringa con un'altra sottostringa.

{%= replace(STRING_1,STRING_2,STRING_3) %}:string

{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}

replaceAll replaceAll

Utilizzare la funzione replaceAll per sostituire tutte le sottostringhe di un testo che corrisponde all'espressione regex con la stringa di sostituzione letterale specificata. Regex gestisce in modo speciale \ e + e tutte le espressioni regex seguono la strategia di escape di PQL. La sostituzione procede dall'inizio della stringa alla fine, ad esempio sostituendo aa con b nella stringa aaa si ottiene ba anziché ab.

{%= replaceAll(string,string,string) %}

rightTrim rightTrim

La funzione rightTrim rimuove gli spazi dalla fine di una stringa.

{%= rightTrim(string) %}

sha256 sha256

La funzione sha256 calcola e restituisce l'hash sha256 di una stringa.

{%= sha256(string) %} : string

{%= sha256("Eliechxh")%}

split split

Utilizzare la funzione split per dividere una stringa per un determinato carattere.

{%= split(string,string) %}

startsWith startsWith

Utilizzare la funzione startsWith per determinare se una stringa inizia con una sottostringa specificata.

{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

{%= startsWith(person.name,"Joe") %}

stringToDate string-to-date

La funzione stringToDate converte un valore stringa in un valore data-ora. Sono necessari due argomenti: la rappresentazione in forma di stringa di una data/ora e la rappresentazione in forma di stringa del formattatore.

{= stringToDate("date-time value","formatter" %}

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

string_to_intero string-to-integer

Utilizzare la funzione string_to_integer per convertire un valore stringa in un valore intero.

{= string_to_integer(string) %}: int

stringToNumber string-to-number

Utilizzare la funzione stringToNumber per convertire una stringa in numero. In caso di input non valido, restituisce la stessa stringa come output.

{%= stringToNumber(string) %}: double

substr sub-string

Utilizzare la funzione substr per restituire la sottostringa dell'espressione stringa tra l'indice iniziale e l'indice finale.

{= substr(string, integer, integer) %}: string

titleCase titleCase

Utilizzare la funzione titleCase per rendere maiuscole le prime lettere di ogni parola di una stringa.

{%= titleCase(string) %}

{%= titleCase(profile.person.location.Street) %}

toBool to-bool

Utilizzare la funzione toBool per convertire un valore di argomento in un valore booleano, a seconda del tipo.

{= toBool(string) %}: boolean

toDateTime to-date-time

Utilizzare la funzione toDateTime per convertire la stringa in data. In caso di input non valido, restituisce la data epoca come output.

{%= toDateTime(string, string) %}: date-time

toDateTimeOnly to-date-time-only

Utilizzare la funzione toDateTimeOnly per convertire un valore di argomento in un valore solo di data e ora. In caso di input non valido, restituisce la data epoca come output. Questa funzione accetta tipi di campo stringa, data, long e integer.

{%= toDateTimeOnly(string/date/long/int) %}: date-time

trim trim

La funzione trim rimuove tutti gli spazi dall'inizio e dalla fine di una stringa.

{%= trim(string) %}

upperCase upper

La funzione upperCase converte una stringa in lettere maiuscole.

{%= upperCase(string) %}

{%= upperCase(profile.person.name.lastName) %}

urlDecode url-decode

Utilizzare la funzione urlDecode per decodificare una stringa con codifica URL.

{%= urlDecode(string) %}: string

urlEncode url-encode

Utilizzare la funzione urlEncode per codificare una stringa come URL.

{%= urlEncode(string) %}: string