DocumentazioneJourney OptimizerGuida di Journey Optimizer

Introduzione alle funzioni helper functions

Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Sviluppatore

Le funzioni di supporto consentono di trasformare e manipolare i dati all’interno dei contenuti personalizzati. Puoi utilizzarli per eseguire calcoli, formattare dati, applicare condizioni ed eseguire varie operazioni per creare esperienze dinamiche e personalizzate per i clienti.

Queste funzioni sfruttano il linguaggio di modelli Journey Optimizer. Scopri le linee guida sulla sintassi di personalizzazione in questa pagina.

➡️ Scopri come utilizzare le funzioni di assistenza in questo video

Accedere alle funzioni di assistenza

Le funzioni helper sono disponibili dal menu delle funzioni dell’editor di personalizzazione:

Le funzioni sono organizzate in tre categorie per facilitarne la navigazione:

  • Funzioni - Operazioni di trasformazione e manipolazione dei dati
  • Helpers - Logica condizionale e funzioni di utilità
  • Operatori - Operatori logici e di confronto

Per utilizzare una funzione helper:

  1. Seleziona una categoria per visualizzarne le sottocategorie e le funzioni disponibili
  2. Fai clic sull'icona > per espandere le sottocategorie
  3. Fai clic sull'icona + accanto a una funzione per aggiungerla al codice di personalizzazione
  4. Fare clic sull'icona ... per visualizzare la descrizione della funzione o aggiungerla ai preferiti. Ulteriori informazioni
NOTE
Le funzioni e le funzionalità disponibili nell'editor di personalizzazione sono diverse da quelle disponibili nell'editor di espressioni avanzate di Percorso. La funzione now() è ad esempio disponibile solo nelle espressioni di percorso. Ulteriori informazioni

Funzioni functions-helper

Funzioni di aggregazione e array

Medio
Questa funzione restituisce la media aritmetica di tutti i valori selezionati all’interno dell’array.
Count
Questa funzione restituisce il numero di elementi all’interno dell’array specificato
Count Only Null
Questa funzione conta il numero di valori Null nell’elenco.
Conteggio con valori Null
Questa funzione conta tutti gli elementi dell’elenco, compresi i valori nulli
Distinct
Questa funzione ottiene valori da un array o da un elenco con valori duplicati rimossi
Conteggio valori univoci con valori Null
Questa funzione conta il numero di valori diversi, inclusi i valori Null.
Primo elemento
Questa funzione restituisce il primo elemento di un array o di un elenco.
Primo n nell’array
Questa funzione restituisce i primi elementi "N" di un array, se ordinati in ordine crescente in base alla data espressione numerica
In entrata
Questa funzione viene utilizzata per determinare se un elemento è membro di un array o di un elenco
Include
Questa funzione determina se un array o un elenco contiene un dato elemento
Intersects
Questa funzione determina se due array o elenchi hanno almeno un membro comune
Ultimo n nell’array
Questa funzione restituisce gli ultimi elementi "N" di un array, se ordinati in ordine crescente in base alla data espressione numerica
Massimo
Questa funzione restituisce il più grande di tutti i valori selezionati all’interno di un array.
Minimo
Questa funzione restituisce il più piccolo di tutti i valori selezionati all’interno dell’array.
Non in
Questa funzione determina se un elemento non è un membro di un array o di un elenco
Sottoinsieme di
Questa funzione determina se un array specifico (array A) è un sottoinsieme di un altro array (array B), ovvero se tutti gli elementi nell’array A sono elementi dell’array B
Sum
Questa funzione restituisce la somma di tutti i valori selezionati all’interno dell’array.
Soprainsieme di
Questa funzione determina se un array specifico (array A) è un superset di un altro array (array B), ovvero se l’array A contiene tutti gli elementi dell’array B

Funzioni data/ora date-functions

Aggiungi giorni
Questa funzione regola una data specificata di un numero specificato di giorni, utilizzando valori positivi per incrementare e valori negativi per diminuire.
Aggiungi ore
Questa funzione regola una data specificata di un numero specificato di ore, utilizzando valori positivi per incrementare e valori negativi per diminuire.
Aggiungi minuti
Questa funzione regola una data specificata di un numero specificato di minuti, utilizzando valori positivi per incrementare e valori negativi per diminuire.
Aggiungi mesi
Questa funzione regola una data specificata di un numero specificato di mesi, utilizzando valori positivi per incrementare e valori negativi per diminuire.
Aggiungi secondi
Questa funzione regola una data specificata di un numero specificato di secondi, utilizzando valori positivi per incrementare e valori negativi per diminuire.
Aggiungi anni
Questa funzione adegua una data specificata di un numero specificato di anni, utilizzando valori positivi per incrementare e valori negativi per diminuire.
Età
Questa funzione recupera l’età da una data specificata.
Età in giorni
Questa funzione calcola l’età di una data specificata in giorni, ovvero il numero di giorni trascorsi tra la data specificata e la data corrente, negativo per le date future e positivo per le date passate.
Età in mesi
Questa funzione calcola l’età di una data specificata in mesi, ovvero il numero di mesi trascorsi tra la data specificata e la data corrente, negativo per le date future e positivo per le date passate.
Confronta date
Questa funzione 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.
Converti DataOraZona
Questa funzione converte una data/ora in un determinato fuso orario.
Ora corrente in millisecondi
Questa funzione recupera il tempo corrente in millisecondi epoca.
Differenza data
Questa funzione recupera la differenza tra due date in numero di giorni.
Giorno del mese
Questa funzione restituisce il numero che rappresenta il giorno del mese.
Giorno della settimana
Questa funzione recupera il giorno della settimana.
Giorno dell’anno
Questa funzione recupera il giorno dell’anno.
Differenza In Secondi
Questa funzione restituisce la differenza tra due date in termini di secondi.
Estrai ore
Questa funzione estrae il componente Ora da una data marca temporale.
Estrai minuti
Questa funzione estrae il componente minuto da una data marca temporale.
Estrai mesi
Questa funzione estrae il componente mese da una data marca temporale.
Estrai secondi
Questa funzione estrae il secondo componente da una data marca temporale.
Formato data
Questa funzione formatta un valore di data e ora.
Formattare la data con il supporto delle impostazioni internazionali
Questa funzione formatta un valore di data e ora nella corrispondente rappresentazione sensibile alla lingua, ovvero nelle impostazioni internazionali desiderate.
Ottieni CurrentZonedDateTime
Questa funzione restituisce la data e l’ora correnti con le informazioni sul fuso orario.
Differenza ore
Questa funzione restituisce la differenza tra due date in termini di ore.
Differenza minuti
Questa funzione restituisce la differenza tra due date in termini di minuti.
Differenza mesi
Questa funzione restituisce la differenza tra due date in termini di mesi.
Imposta giorni
Questa funzione imposta il giorno del mese per la data/ora specificata.
Imposta ore
Questa funzione imposta l’ora della data/ora.
A Data/Ora
Questa funzione converte la stringa in data. In caso di input non valido, restituisce la data epoca come output.
A UTC
Questa funzione converte un datetime in UTC.
Tronca all'inizio del giorno
Questa funzione modifica una data/ora specificata impostandola sull’inizio del giorno con l’ora impostata su 00:00.
truncateToStartOfQuarter
Questa funzione tronca una data/ora al primo giorno del trimestre (ad esempio 1 gennaio, 1 aprile, 1 luglio, 1 ottobre) alle 00:00.
truncateToStartOfWeek
Questa funzione modifica una data/ora impostandola sull’inizio della settimana (lunedì alle 00:00).
truncateToStartOfYear
Questa funzione modifica una data/ora specificata troncandola al primo giorno dell’anno (1° gennaio) alle 00:00.
Settimana dell’anno
Questa funzione restituisce la settimana dell’anno.
Differenza anni
Questa funzione restituisce la differenza tra due date in termini di anni.

Funzioni mappa map-functions

Ottenere
Questa funzione viene utilizzata per recuperare il valore di una mappa per una determinata chiave
Chiavi
Questa funzione viene utilizzata per recuperare tutte le chiavi per una data mappa
Valori
Questa funzione recupera tutti i valori di una data mappa

Funzioni matematiche math-functions

Assoluto
Questa funzione formatta qualsiasi numero nella sua rappresentazione sensibile alla lingua.
Formato numero
Questa funzione formatta qualsiasi numero nella sua rappresentazione sensibile alla lingua.
Casuale
Questa funzione restituisce un valore casuale compreso tra 0 e 1.
Arrotonda per difetto
Questa funzione arrotonda un numero per difetto
Arrotonda per eccesso
Questa funzione arrotonda un numero per eccesso
Alla stringa esadecimale
Converte qualsiasi numero nella relativa stringa esadecimale.
ToInt
Converte uno qualsiasi di questi tipi (number, double, int, long, float, short, byte, boolean, string) in un numero intero.
A percentuale
Questa funzione converte un numero in percentuale.
Per la precisione
Questa funzione converte un numero con la precisione richiesta.
A stringa
Questa funzione converte qualsiasi numero nella sua rappresentazione di stringa.

Funzioni oggetto object-functions

Non è nullo
Questa funzione viene utilizzata per determinare se esiste un riferimento a un oggetto
È nullo
Questa funzione viene utilizzata per determinare se un riferimento a un oggetto non esiste

Funzioni stringa string-functions

Camel Case
Questa funzione viene utilizzata per scrivere in maiuscolo la prima lettera di ogni parola di una stringa
Codice carattere in corrispondenza di
Questa funzione restituisce il valore ASCII di un carattere, come la funzione charCodeAt in JavaScript
Concat
Questa funzione viene utilizzata per combinare due stringhe in una
Contiene
Questa funzione viene utilizzata per determinare se una stringa contiene una sottostringa specificata
Non contiene
Questa funzione viene utilizzata per determinare se una stringa non contiene una sottostringa specificata
Non termina con
Questa funzione viene utilizzata per determinare se una stringa non termina con una sottostringa specificata
Non inizia con
Questa funzione viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata
Codifica 64
Questa funzione viene utilizzata per codificare una stringa
Termina con
Questa funzione viene utilizzata per determinare se una stringa termina con una sottostringa specificata
È uguale a
Questa funzione viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata, con distinzione tra maiuscole e minuscole
Ignora maiuscole/minuscole uguale a
Questa funzione viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata, senza distinzione tra maiuscole e minuscole
Estrai dominio e-mail
Questa funzione viene utilizzata per estrarre il dominio di un indirizzo e-mail
Formato valuta
Questa funzione converte qualsiasi numero nella corrispondente rappresentazione della valuta sensibile alla lingua, a seconda delle impostazioni locali passate come stringa nel secondo argomento.
Ottieni host URL
Questa funzione viene utilizzata per ottenere l’host URL.
Ottieni percorso URL
Questa funzione viene utilizzata per ottenere il percorso URL
Ottieni protocollo URL
Questa funzione viene utilizzata per ottenere il protocollo URL
Indice di
Questa funzione restituisce la posizione (nel primo argomento) della prima occorrenza del secondo parametro. Restituisce -1 se non viene trovata alcuna corrispondenza
IsEmpty
Questa funzione viene utilizzata per verificare se una stringa o un’espressione è vuota.
Non è vuoto
Questa funzione restituisce true se la stringa nel parametro non è vuota.
Ultimo indice di
Questa funzione restituisce la posizione (nel primo argomento) dell’ultima occorrenza del secondo parametro. Restituisce -1 se non viene trovata alcuna corrispondenza.
Taglia a sinistra
Questa funzione rimuove gli spazi bianchi dall’inizio di una stringa
Lunghezza
Questa funzione viene utilizzata per ottenere il numero di caratteri in una stringa o in un’espressione
Simile a
Questa funzione viene utilizzata per determinare se una stringa corrisponde a un pattern specificato
Minuscolo
Questa funzione converte una stringa in lettere minuscole.
Maschera
Questa funzione viene utilizzata per sostituire una parte di stringa con caratteri "X".
Corrisponde a
Questa funzione viene utilizzata per determinare se una stringa corrisponde a una specifica espressione regolare.
MD5
Questa funzione restituisce l’hash MD5 della stringa di input.
Non uguale a
Questa funzione viene utilizzata per determinare se una stringa non è uguale alla stringa specificata
Non uguale con ignora maiuscole/minuscole
Questa funzione confronta due stringhe ignorando le maiuscole/minuscole.
Gruppo di espressioni regolari
Questa funzione viene utilizzata per estrarre informazioni specifiche, in base all’espressione regolare fornita
Sostituisci
Questa funzione sostituisce una determinata sottostringa in una stringa con un’altra sottostringa
Sostituisci tutto
Questa funzione sostituisce tutte le sottostringhe di un testo che corrisponde alla "destinazione" con la stringa letterale "replace" specificata
Taglia a destra
Questa funzione rimuove gli spazi bianchi dalla fine di una stringa.
SHA256
Questa funzione calcola e restituisce l’hash sha256 di una stringa.
Dividi
Questa funzione viene utilizzata per dividere una stringa per un determinato carattere
Inizia con
Questa funzione viene utilizzata per determinare se una stringa inizia con una sottostringa specificata
Stringa a data
Questa funzione converte un valore stringa in un valore data-ora.
Stringa a numero intero
Questa funzione converte un valore stringa in un valore intero.
Stringa a numero
Questa funzione viene utilizzata per convertire una stringa in numero. In caso di input non valido, restituisce la stessa stringa come output.
Sottostringa
Questa funzione restituisce la sottostringa dell’espressione stringa tra l’indice iniziale e l’indice finale.
Tutte iniziali maiuscole
Questa funzione viene utilizzata per rendere maiuscole le prime lettere di ogni parola di una stringa
To Bool
Questa funzione converte un valore di argomento in un valore booleano, a seconda del tipo.
A Data/Ora
Questa funzione viene utilizzata per convertire una stringa in data. In caso di input non valido, restituisce la data epoca come output.
Solo a data/ora
Questa funzione converte un valore di argomento in un valore solo di data e ora. In caso di input non valido, restituisce la data epoca come output.
Taglia
Questa funzione rimuove gli spazi bianchi dall’inizio e dalla fine di una stringa.
Maiuscolo
Questa funzione converte una stringa in lettere maiuscole.
Decodifica URL
Questa funzione viene utilizzata per decodificare una stringa con codifica URL.
Codifica URL
Questa funzione viene utilizzata per la codifica URL di una stringa.

Helper helper-helper

Gli helper sono dettagliati in questa pagina.

Valore di fallback predefinito
Questa funzione viene utilizzata per eseguire il rendering di una variabile con il valore predefinito
Ogni
Questa funzione viene utilizzata per eseguire iterazioni su un array
Metadati di esecuzione
Questo helper acquisisce metadati personalizzati chiave-valore durante il rendering dei messaggi in modo che possano essere memorizzati nell’oggetto metadati di esecuzione runtime
Se
Questa funzione viene utilizzata per definire un blocco condizionale. Se la valutazione dell’espressione restituisce true, viene eseguito il rendering del blocco.
Let
Questa funzione consente di memorizzare un’espressione come variabile da utilizzare successivamente in una query
A meno che
Questa funzione viene utilizzata per definire un blocco condizionale. Se la valutazione dell’espressione restituisce false, viene eseguito il rendering del blocco
Con
Questa funzione viene utilizzata per modificare il token di valutazione della parte modello

Operatori operators-helper

Funzioni aritmetiche arithmetic-helper

Le funzioni aritmetiche vengono utilizzate per eseguire calcoli di base sui valori.

Addizione
Questo operatore viene utilizzato per trovare la somma di due espressioni di argomento
Dividi
Questo operatore viene utilizzato per trovare il quoziente di due espressioni di argomento
Moltiplicazione
Questo operatore viene utilizzato per trovare il prodotto di due espressioni di argomento
Resto
Questo operatore viene utilizzato per trovare il resto dopo aver diviso le due espressioni di argomento
Sottrazione
Questo operatore trova la differenza tra due espressioni

Funzioni booleane boolean-functions

Le funzioni booleane vengono utilizzate per eseguire la logica booleana su elementi diversi.

E
Questo operatore crea una congiunzione logica
Oppure
Questo operatore crea una disgiunzione logica

Funzioni di confronto comparison-functions

Le funzioni di confronto vengono utilizzate per confrontare espressioni e valori diversi, restituendo di conseguenza true o false.

È uguale a
Questa operazione controlla se i valori sono uguali
Maggiore di
Questo operatore controlla se il primo valore è maggiore del secondo valore
Maggiore o uguale a
Questo operatore controlla se il primo valore è maggiore o uguale al secondo valore
Minore o uguale a
Questo operatore controlla se il primo valore è minore o uguale al secondo valore
Non è uguale a
Questo operatore controlla se l’espressione data non è uguale al valore dato

Video dimostrativo video

Scopri come trasformare i valori di personalizzazione utilizzando le funzioni di assistenza alla personalizzazione e studia diversi casi d’uso per le funzioni di supporto.

https://video.tv.adobe.com/v/3416645?captions=ita&quality=12
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76