Introduzione alle funzioni helper
- Argomenti:
- Personalizzazione
Creato per:
- Esperto
- Sviluppatore
Utilizza il linguaggio di modelli Journey Optimizer per eseguire operazioni sui dati, ad esempio calcoli, formattazione o conversioni di dati, condizioni e manipolarli nel contesto della personalizzazione. Scopri le linee guida sulla sintassi di personalizzazione in questa pagina.
➡️ Scopri come utilizzare le funzioni di assistenza in questo video
Il linguaggio dei modelli viene utilizzato nelle funzioni di supporto disponibili nell’elenco a discesa di personalizzazione dell’editor di personalizzazione, come segue:
Nell'editor di personalizzazione Journey Optimizer, le funzioni di supporto sono raggruppate in tre categorie: Funzioni, Helper e Operatori.
Seleziona una categoria per accedere alle sottocategorie e alle funzioni.
Accedere alle sottocategorie facendo clic sull'icona >
. Selezionare una funzione facendo clic sull'icona +
: la funzione viene aggiunta automaticamente alla schermata di personalizzazione.
Fare clic sull'icona ...
per visualizzare la descrizione della funzione e aggiungerla ai preferiti. Ulteriori informazioni
Funzioni
Funzioni di aggregazione e array
Medio | Questa funzione restituisce la media aritmetica di tutti i valori selezionati all’interno dell’array. |
Conteggio | Questa funzione restituisce il numero di elementi all’interno dell’array specificato |
Conteggio solo valori 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 |
Diverso | Questa funzione ottiene valori da un array o da un elenco con valori duplicati rimossi |
Conteggio valori univoci con 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/i 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 |
Interseca | Questa funzione determina se due array o elenchi hanno almeno un membro comune |
Ultimo/i 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 |
Somma | Questa funzione restituisce la somma di tutti i valori selezionati all’interno dell’array. |
Superset 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
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 date1 è uguale a date2, -1 se date1 è precedente a date2 e 1 se date1 è successiva a date2. |
Converti ZonedDateTime | Questa funzione converte una data/ora in un determinato fuso orario. |
Ora corrente in millisecondi | Questa funzione recupera l’ora 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 marca temporale determinata. |
Estrai minuti | Questa funzione estrae il componente minuto da una determinata 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 marca temporale determinata. |
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 a Inizio del giorno | Questa funzione modifica una data-ora 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 determinata impostandola sull’inizio della settimana (lunedì alle 00:00). |
truncateToStartOfYear | Questa funzione modifica una data-ora determinata 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
Funzioni matematiche
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 in base alla precisione richiesta. |
A stringa | Questa funzione converte qualsiasi numero nella sua rappresentazione di stringa. |
Funzioni oggetto
Non è Null | Questa funzione viene utilizzata per determinare se esiste un riferimento a un oggetto |
È Null | Questa funzione viene utilizzata per determinare se un riferimento a un oggetto non esiste |
Funzioni stringa
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 |
Concatena | Questa funzione viene utilizzata per combinare due stringhe in una |
Contains | 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 |
Uguale a ignora distinzione tra maiuscole e minuscole | 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 distinzione tra maiuscole e minuscole | Questa funzione confronta due stringhe ignorando la distinzione tra maiuscole e 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. |
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 della 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 |
A valore booleano | Questa funzione converte un valore di un 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 codificato dell’URL. |
Codifica URL | Questa funzione viene utilizzata per la codifica URL di una stringa. |
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 |
Each | Questa funzione viene utilizzata per eseguire iterazioni su un array |
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 |
Unless | Questa funzione viene utilizzata per definire un blocco condizionale. Se la valutazione dell’espressione restituisce false, viene eseguito il rendering del blocco |
With | Questa funzione viene utilizzata per modificare il token di valutazione della parte modello |
Operatori
Funzioni aritmetiche
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
Le funzioni booleane vengono utilizzate per eseguire la logica booleana su elementi diversi.
Funzioni di confronto
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 introduttivo
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.