Introduzione alle funzioni helper

Ultimo aggiornamento: 2023-08-17
  • Argomenti:
  • Personalization
    Visualizza ulteriori informazioni su questo argomento
  • Creato per:
  • Experienced
    Developer

Utilizzare Journey Optimizer linguaggio di template 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 espressioni, come segue:

In Journey Optimizer Le funzioni di supporto dell’editor di espressioni sono raggruppate in tre categorie: Funzioni, Helper e Operatori.

Seleziona una categoria per accedere alle sottocategorie e alle funzioni.

Accedere alle sottocategorie facendo clic sul pulsante > icona. Seleziona una funzione facendo clic sul pulsante + icona: la funzione viene aggiunta automaticamente alla schermata di personalizzazione.

Fai clic su ... per visualizzare la descrizione della funzione e aggiungerla ai preferiti. Ulteriori informazioni

Funzioni

Funzioni di aggregazione e array

MedioQuesta funzione restituisce la media aritmetica di tutti i valori selezionati all’interno dell’array.
ConteggioQuesta funzione restituisce il numero di elementi all’interno dell’array specificato
Count Only NullQuesta funzione conta il numero di valori Null nell’elenco.
Conteggio con valori NullQuesta funzione conta tutti gli elementi dell’elenco, compresi i valori nulli
DistinctQuesta funzione ottiene valori da un array o da un elenco con valori duplicati rimossi
Conteggio valori univoci con valori NullQuesta funzione conta il numero di valori diversi, inclusi i valori Null.
Primo elementoQuesta funzione restituisce il primo elemento di un array o di un elenco.
Primo n nell’arrayQuesta funzione restituisce i primi elementi "N" di un array, se ordinati in ordine crescente in base alla data espressione numerica
InQuesta funzione viene utilizzata per determinare se un elemento è membro di un array o di un elenco
IncludeQuesta funzione determina se un array o un elenco contiene un dato elemento
IntersectsQuesta funzione determina se due array o elenchi hanno almeno un membro comune
Ultimo n nell’arrayQuesta funzione restituisce gli ultimi elementi "N" di un array, se ordinati in ordine crescente in base alla data espressione numerica
MassimoQuesta funzione restituisce il più grande di tutti i valori selezionati all’interno di un array.
MinimoQuesta funzione restituisce il più piccolo di tutti i valori selezionati all’interno dell’array.
Non in entrataQuesta funzione determina se un elemento non è un membro di un array o di un elenco
Sottoinsieme diQuesta 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
SommaQuesta funzione restituisce la somma di tutti i valori selezionati all’interno dell’array.
Soprainsieme diQuesta 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

EtàQuesta funzione recupera l’età da una data specificata
Ora corrente in millisecondiQuesta funzione recupera l’ora corrente in millisecondi epoca
Differenza dataQuesta funzione recupera la differenza tra due date in numero di giorni.
Giorno della settimanaQuesta funzione recupera il giorno della settimana
Giorno dell’annoQuesta funzione recupera il giorno dell’anno
Formato dataQuesta funzione formatta un valore di data e ora
Formattare la data con il supporto delle impostazioni internazionaliQuesta funzione formatta un valore di data e ora nella corrispondente rappresentazione sensibile alla lingua, ovvero nelle impostazioni internazionali desiderate.
Imposta giorniQuesta funzione imposta il giorno del mese per la data/ora specificata
Imposta oreQuesta funzione imposta l’ora della data/ora
A UTCQuesta funzione converte un datetime in UTC.
Settimana dell’annoQuesta funzione restituisce la settimana dell’anno.

Funzioni mappa

OttenereQuesta funzione viene utilizzata per recuperare il valore di una mappa per una determinata chiave
ChiaviQuesta funzione viene utilizzata per recuperare tutte le chiavi per una data mappa
ValoriQuesta funzione recupera tutti i valori di una data mappa

Funzioni matematiche

AssolutoQuesta funzione formatta qualsiasi numero nella sua rappresentazione sensibile alla lingua.
Formato numeroQuesta funzione formatta qualsiasi numero nella sua rappresentazione sensibile alla lingua.
RandomQuesta funzione restituisce un valore casuale compreso tra 0 e 1.
Arrotonda per difettoQuesta funzione arrotonda un numero per difetto
Arrotonda per eccessoQuesta funzione arrotonda un numero per eccesso
Alla stringa esadecimaleconverte qualsiasi numero nella relativa stringa esadecimale.
A percentualeQuesta funzione converte un numero in percentuale.
Per la precisioneQuesta funzione converte un numero con la precisione richiesta.
A stringaQuesta funzione converte qualsiasi numero nella sua rappresentazione di stringa.

Funzioni oggetto

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

Funzioni stringa

Camel CaseQuesta funzione viene utilizzata per scrivere in maiuscolo la prima lettera di ogni parola di una stringa
Codice carattere in corrispondenza diQuesta funzione restituisce il valore ASCII di un carattere, come la funzione charCodeAt in JavaScript
ConcatQuesta funzione viene utilizzata per combinare due stringhe in una
ContainsQuesta funzione viene utilizzata per determinare se una stringa contiene una sottostringa specificata
Non contieneQuesta funzione viene utilizzata per determinare se una stringa non contiene una sottostringa specificata
Non termina conQuesta funzione viene utilizzata per determinare se una stringa non termina con una sottostringa specificata
Non inizia conQuesta funzione viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata
Codifica 64Questa funzione viene utilizzata per codificare o decodificare una stringa.
Termina conQuesta funzione viene utilizzata per determinare se una stringa termina con una sottostringa specificata
È uguale aQuesta funzione viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata, con distinzione tra maiuscole e minuscole
Ignora maiuscole/minuscole uguale aQuesta funzione viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata, senza distinzione tra maiuscole e minuscole
Estrai dominio e-mailQuesta funzione viene utilizzata per estrarre il dominio di un indirizzo e-mail
Formato valutaQuesta 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 URLQuesta funzione viene utilizzata per ottenere l’host URL.
Ottieni percorso URLQuesta funzione viene utilizzata per ottenere il percorso URL
Ottieni protocollo URLQuesta funzione viene utilizzata per ottenere il protocollo URL
Indice diQuesta funzione restituisce la posizione (nel primo argomento) della prima occorrenza del secondo parametro. Restituisce -1 se non viene trovata alcuna corrispondenza
IsEmptyQuesta funzione viene utilizzata per verificare se una stringa o un’espressione è vuota.
Non è vuotoQuesta funzione restituisce true se la stringa nel parametro non è vuota.
Ultimo indice diQuesta funzione restituisce la posizione (nel primo argomento) dell’ultima occorrenza del secondo parametro. Restituisce -1 se non viene trovata alcuna corrispondenza.
Taglia a sinistraQuesta funzione rimuove gli spazi bianchi dall’inizio di una stringa
LunghezzaQuesta funzione viene utilizzata per ottenere il numero di caratteri in una stringa o in un’espressione
Mi piaceQuesta funzione viene utilizzata per determinare se una stringa corrisponde a un pattern specificato
MinuscoloQuesta funzione converte una stringa in lettere minuscole.
MascheraQuesta funzione viene utilizzata per sostituire una parte di stringa con caratteri "X".
CorrispondeQuesta funzione viene utilizzata per determinare se una stringa corrisponde a una specifica espressione regolare.
MD5Questa funzione restituisce l’hash MD5 della stringa di input.
Diverso daQuesta funzione viene utilizzata per determinare se una stringa non è uguale alla stringa specificata
Non uguale con ignora maiuscole/minuscoleQuesta funzione confronta due stringhe ignorando le maiuscole/minuscole.
Gruppo di espressioni regolariQuesta funzione viene utilizzata per estrarre informazioni specifiche, in base all’espressione regolare fornita
SostituisciQuesta funzione sostituisce una determinata sottostringa in una stringa con un’altra sottostringa
Sostituisci tuttoQuesta funzione sostituisce tutte le sottostringhe di un testo che corrisponde alla "destinazione" con la stringa letterale "replace" specificata
Taglia a destraQuesta funzione rimuove gli spazi bianchi dalla fine di una stringa.
SplitQuesta funzione viene utilizzata per dividere una stringa per un determinato carattere
Inizia conQuesta funzione viene utilizzata per determinare se una stringa inizia con una sottostringa specificata
Stringa a dataQuesta funzione converte un valore stringa in un valore data-ora.
Stringa a numero interoQuesta funzione converte un valore stringa in un valore intero.
Stringa a numeroQuesta funzione viene utilizzata per convertire una stringa in numero. In caso di input non valido, restituisce la stessa stringa come output.
SottostringaQuesta funzione restituisce la sottostringa dell’espressione stringa tra l’indice iniziale e l’indice finale.
Tutte iniziali maiuscoleQuesta funzione viene utilizzata per rendere maiuscole le prime lettere di ogni parola di una stringa
To BoolQuesta funzione converte un valore di argomento in un valore booleano, a seconda del tipo.
A Data/OraQuesta funzione viene utilizzata per convertire una stringa in data. In caso di input non valido, restituisce la data epoca come output.
Solo a data/oraQuesta 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.
Trim (Taglia)Questa funzione rimuove gli spazi bianchi dall’inizio e dalla fine di una stringa.
MaiuscoloQuesta funzione converte una stringa in lettere maiuscole.
Decodifica URLQuesta funzione viene utilizzata per decodificare una stringa con codifica URL.
Codifica URLQuesta funzione viene utilizzata per la codifica URL di una stringa.

Helper

Gli helper sono descritti in questa pagina.

Valore di fallback predefinitoQuesta funzione viene utilizzata per eseguire il rendering di una variabile con il valore predefinito
OgniQuesta funzione viene utilizzata per eseguire iterazioni su un array
SeQuesta funzione viene utilizzata per definire un blocco condizionale. Se la valutazione dell’espressione restituisce true, viene eseguito il rendering del blocco.
LetQuesta funzione consente di memorizzare un’espressione come variabile da utilizzare successivamente in una query
A meno cheQuesta funzione viene utilizzata per definire un blocco condizionale. Se la valutazione dell’espressione restituisce false, viene eseguito il rendering del blocco
ConQuesta 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.

AggiuntaQuesto operatore viene utilizzato per trovare la somma di due espressioni di argomento
DividiQuesto operatore viene utilizzato per trovare il quoziente di due espressioni di argomento
MoltiplicazioneQuesto operatore viene utilizzato per trovare il prodotto di due espressioni di argomento
Rimanente 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.

EQuesto operatore crea una congiunzione logica
OppureQuesto operatore crea una disgiunzione logica

Funzioni di confronto

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

È uguale aQuesta operazione controlla se i valori sono uguali
Maggiore diQuesto operatore controlla se il primo valore è maggiore del secondo valore
Maggiore o uguale aQuesto 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 aQuesto 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.

In questa pagina