Introduzione alle funzioni helper functions

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:

NOTE
Le funzioni e le funzionalità disponibili nell'editor di personalizzazione sono diverse da quelle disponibili nell'editor di espressioni avanzate di Percorso.

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 functions-helper

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 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 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 map-functions

Ottieni
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 in base alla precisione richiesta.
A stringa
Questa funzione converte qualsiasi numero nella sua rappresentazione di stringa.

Funzioni oggetto object-functions

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 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
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 helper-helper

Gli helper sono descritti 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 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 introduttivo 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.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76