Utilizzo degli helper dei modelli di messaggio - Amazon Pinpoint
Utilizzo di variabili con gli helper dei modelli di messaggioutilizzo degli helper nidificati

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo degli helper dei modelli di messaggio

Con i modelli Pinpoint, i clienti possono creare modelli di messaggi riutilizzabili basati sul linguaggio Handlebars.js. Gli helper forniscono una varietà di funzionalità come la formattazione di un prezzo nella valuta di una regione specifica o l'aggiunta di una località basata sul fuso orario. Un helper può utilizzare una stringa o un numero intero specifico per il valore o una variabile di messaggio Amazon Pinpoint specifica.

Queste sono le categorie di aiutanti, descritte nelle sezioni seguenti:

Questa sezione descrive ilintegratoaiutanti forniti da Handlebars. Per l'elenco completo consultaAiutanti integratialhandlebarsjs.com. Questi sono gli aiutanti integrati:

  • each— Iterazione di un elenco.

    Nota

    La dimensione massima dell'elenco è di 15 articoli.

  • if— Valuta una dichiarazione.

ogni

Itera un elenco. Questo helper utilizza solo un'istruzione a blocchi. È inoltre possibile

  • Pass@indexnella richiesta di fare riferimento all'indice del ciclo corrente.

  • Utilizzo dell'thishelper per fare riferimento all'elemento corrente che viene iterato.

  • Restituisci la risposta dell'helper in un elenco, utilizzando il<li>etichetta.

Utilizzo

{{#each value}}

Valore in posizione{{@index}}è{{this}}.

{{else}}

Condition in false.

{{/each}}

eachdeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/each}}nell'istruzione a blocchi.

Esempio

In questo esempio,eachviene utilizzato per restituire un elenco dei colori preferiti di un utente. Per unfalse, unelsela dichiarazione viene restituita. Se la richiesta è questa

{{#each User.UserAttributes.FavoriteColors}}

<li>{{this}}</li>

{{else}}

Non hai colori preferiti.

Valori restituiti da {{/each}}

  • red

  • blu

  • giallo

per una dichiarazione vera.

if

Valuta se qualcosa è vero e restituisce una risposta in base alla valutazione.

Utilizzo

{{#if value}}

Il valore non è indefinito

{{else}}

Il valore non è definito

{{/if}}

ifdeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/if}}nell'istruzione a blocchi.

Esempio

In questo esempio,ifhelper viene utilizzato per valutare se il nome di un utente. Se viene trovato il nome, viene restituito un messaggio di saluto che trasmette il nome dell'utente nella risposta. In caso contrario, laelsedichiarazione restituisce un saluto alternativo.

{{#if User.UserAttributes.FirstName.[0]}}

Hello {{User.UserAttributes.FirstName.[0]}},

{{else}}

Hello,

{{/if}}

restituisceHello, Janese ilifl'aiutante è vero.

Questa sezione descrive ilcondizionalegli helper.

Gli helper condizionali possono essere usati su una singola riga o in un'istruzione a blocchi. È possibile personalizzare la risposta indipendentemente dal metodo di supporto utilizzato. È possibile passare aiutanti condizionali aggiuntivi sia nelle istruzioni a riga singola che in quelle a blocco. I seguenti helper condizionali mostrano l'utilizzo prima per una singola riga e poi per un'istruzione a blocchi utilizzando un opzionaleelseClausola. Questi sono gli aiutanti condizionali:

  • and— Confronta se tutti gli elementi passati sono uguali.

  • eq— Verifica se due elementi sono uguali.

  • gt— Verifica se un elemento è maggiore di un altro.

  • gte— Verifica se un elemento è maggiore o uguale a un altro.

  • if— Valuta se qualcosa è vero.

  • lt— Verifica se un elemento è inferiore a un altro.

  • lte— Verifica se un elemento è minore o uguale a un altro.

  • neq— Valuta se due elementi non sono uguali.

  • not— Inverte la risposta di un'operazione booleana.

  • or— Confronta se uno qualsiasi degli elementi dell'argomento è uguale.

e

Confrontare setuttigli elementi passati in un argomento sono uguali e quindi restituiscono la risposta in base al risultato. Questo helper può essere usato per valori non booleani. È necessario passare almeno due elementi per la condizione.

Utilizzo

  • {{and valuea valueb valuec valued yes='y' no='n'}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione.

  • {{#and valuea valueb}}

    Condition è true

    {{else}}

    Condition in false.

    {{/and}}

    anddeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/and}}nell'istruzione a blocchi.

Esempio

In questo esempio,eqviene utilizzato all'interno delandistruzione block per determinare se entrambe le stringhe sono state passate perLocation.City eLocation.Countrygli attributi sono true. Se entrambe le condizioni sono uguali, viene restituita una dichiarazione vera. Se uno di questi attributi è falso, alloraelsela dichiarazione viene restituita.

{{#and (eq Location.City "Los Angeles") (eq Location.Country "US")}}

Vivi a Los Angeles e negli Stati Uniti.

{{else}}

Non vivi a Los Angeles e negli Stati Uniti.

{{/and}}

eq

Verifica se due elementi sono uguali o se il valore di un elemento è uguale a una stringa passata.

Utilizzo

  • {{eq valuea valueb yes='y' no='n'}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione.

  • {{#eq valuea valueb}}

    Condition è true

    {{else}}

    Condition in false.

    {{/eq}}

    eqdeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/eq}}nell'istruzione a blocchi.

Esempio

In questo esempio,eqviene utilizzato per valutare se il valore diUser.UserAttributes.FavoriteColors.[0]èRosso. Se Condition ètrue, viene restituita una dichiarazione vera. Se Condition èfalse, quindi unelsela dichiarazione viene restituita.

{{#eq User.UserAttributes.FavoriteColors.[0] "red"}}

Il tuo colore preferito è il rosso.

{{else}}

Non ti piace il rosso.

{{/eq}}

gt

Verifica se il valore di un elemento è maggiore di un altro.

Utilizzo

  • {{gt valuea valueb yes='y' no='n'}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione.

  • {{#gt valuea valueb}}

    Condition è true

    {{else}}

    Condition in false.

    {{/gt}}

    gtdeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/gt}}nell'istruzione a blocchi.

Esempio

In questo esempio, l'helper confronta il valore diUser.UserAttributes.UserAge.[0]attributo contro una stringa,17, per verificare se l'età dell'utente è maggiore di 17 anni. Se Condition ètrue, viene restituita una dichiarazione vera. Se Condition èfalse, quindi unelsela dichiarazione viene restituita.

{{#gt User.UserAttributes.UserAge.[0] "17"}}

Sei abbastanza grande per noleggiare un'auto.

{{else}}

Non sei abbastanza grande per noleggiare un'auto.

{{/gt}}

Gte

Verifica se il valore di un elemento è maggiore o uguale a un altro.

Usage

  • {{gte valuea valueb yes='y' no='n'}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione.

  • {{#gte valuea valueb}}

    Condition è true

    {{else}}

    Condition in false.

    {{/gte}}

    getdeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/gte}}nell'istruzione a blocchi.

Esempio

In questo esempio, l'helper confronta ilUser.UserAttributes.UserAge.[0]attributo contro una stringa,18, per verificare se l'età dell'utente è superiore o uguale a 18 anni. Se Condition ètrue, viene restituita una dichiarazione vera. Se Condition èfalse, quindi unelsela dichiarazione viene restituita.

{{#gte User.UserAttributes.UserAge.[0] "18"}}

Sei abbastanza grande per noleggiare un'auto.

{{else}}

Non sei abbastanza grande per noleggiare un'auto.

{{/gte}}

if

Valuta se qualcosa è vero e restituisce una risposta in base alla valutazione.

Utilizzo

  • {{#if value}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione.

  • {{#if value}}

    Condition è true

    {{else}}

    Condition in false.

    {{/if}}

    ifdeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/if}}nell'istruzione a blocchi.

Esempio

In questo esempio, l'helper if viene utilizzato per valutare se il nome di un utente. Se viene trovato il nome, viene restituito un messaggio di saluto che trasmette il nome dell'utente nella risposta. In caso contrario, l'istruzione else restituisce un saluto alternativo.

{{#if User.UserAttributes.FirstName.[0]}}

Ciao {{User.UserAttributes.FirstName.[0]}},

{{else}}

Hello,

{{/if}}

restituisceHello Jane,se l'helper if è vero.

Lt

Verifica se il valore di un elemento è inferiore al valore di un altro.

Utilizzo

  • {{lt valuea valueb yes='y' no='n'}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione.

  • {{#lt valuea valueb}}

    Condition è true

    {{else}}

    Condition in false.

    {{/lt}}

    ltdeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/lt}}nell'istruzione a blocchi.

Esempio

In questo esempio, l'helper confronta ilUser.UserAttributes.UserAge.[0]attributo contro una stringa,18, per verificare se l'età dell'utente è inferiore a 18 anni. Se Condition ètrue, viene restituita una dichiarazione vera. Se Condition èfalse, quindi unelsela dichiarazione viene restituita.

{{#lt User.UserAttributes.UserAge.[0] "18"}}

Non sei abbastanza grande per noleggiare un'auto.

{{else}}

Sei abbastanza grande per noleggiare un'auto.

{{/lt}}

Lte

Verifica se il valore di un elemento è minore o uguale a un altro.

Utilizzo

  • {{lte valuea valueb yes='y' no='n'}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione.

  • {{#lte valuea valueb}}

    Condition è true

    {{else}}

    Condition in false.

    {{/lte}}

    ltedeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/lte}}nell'istruzione a blocchi.

Esempio

In questa istruzione a blocchi, l'helper confronta ilUser.UserAttributes.UserAge.[0]attributo contro una stringa,17, per verificare se l'età dell'utente è uguale o inferiore a 17 anni. Se Condition ètrue, viene restituita una dichiarazione vera. Se Condition èfalse, quindi unelsela dichiarazione viene restituita.

{{#lte User.UserAttributes.Age.[0] "17"}}

Non sei abbastanza grande per noleggiare un'auto.

{{else}}

Sei abbastanza grande per noleggiare un'auto.

{{/lte}}

Neq

Verifica se due elementi sonononUguale.

Utilizzo

  • {{neq valuea valueb yes='y' no='n'}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione.

  • {{#neq valuea valueb}}

    Condition è true

    {{else}}

    Condition in false.

    {{/neq}}

    neqdeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/neq}}nell'istruzione a blocchi.

Esempio

In questa dichiarazione di blocco, ilUser.UserAttributes.FavoriteColors.[0]l'attributo viene confrontato con una stringa,Red. Se Condition ètrue, viene restituita una dichiarazione vera. Se Condition èfalse, quindi unelsela dichiarazione viene restituita.

{{#neq User.UserAttributes.Favorite.Colors.[0] "red"}}

Non ti piace il rosso.

{{else}}

Ti piace il rosso.

{{/neq}}

not

Inverte la risposta di un'operazione booleana, in modo che senotè un confronto positivo, quindi untruela dichiarazione viene restituita. Se la risposta è falsa, viene restituita un'istruzione else.

Utilizzo

  • {{not value yes='y' no='n'}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione.

  • {{#not value}}

    Condition è true

    {{else}}

    Condition in false.

    {{/not}}

    notdeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/not}}nell'istruzione a blocchi.

Esempio

In questa dichiarazione di blocco, ilUser.UerAttributes.FavoriteColors.[0]l'attributo viene confrontato con una stringa,red, utilizzando ileqassistente. Lanothelper restituisce quindi l'opposto deleqassistente. Se la risposta restituisce un colore diverso dared, untrueviene restituita una dichiarazione. Se la risposta viene restituitared, quindi unelseviene restituita una dichiarazione che indica una dichiarazione falsa.

{{#not (eq User.UserAttributes.Favorite.Colors.[0] "red")}}

Non ti piace il rosso.

{{else}}

Ti piace il rosso.

{{/not}}

Esempio

In questo esempio,

{{not (eq User.UserAttributes.FavoriteColors.[0] "red")}}

restituisce falseUser.UserAttributes.FavoriteColors.[0]èred.

oppure

Confrontare sequalsiasidegli elementi dell'argomento sono uguali e quindi restituisce una risposta in base al risultato. Questo helper può essere usato per valori non booleani.

Utilizzo

  • {{or valuea valueb valuec valued yes='y' no='n'}}

    È possibile sostituireyencon altri valori, ad esempiosìenoo qualsiasi altra stringa che desideri restituire, a seconda della condizione. È necessario passare almeno due elementi per la condizione.

  • {{#or valuea valueb}}

    Condition è true

    {{else}}

    Condition in false.

    {{/or}}

    ordeve essere preceduto dal simbolo della sterlina (#) e concludono con una chiusura{{/or}}nell'istruzione a blocchi.

Esempio

In questooristruzione block, due stringhe per ilLocation.Citygli attributi vengono confrontati ulteriormente utilizzando ileqassistente. Se uno degli attributi ètrue, quindi viene restituita una dichiarazione vera. Se una o più risposte sonofalse, quindi unelsela dichiarazione viene restituita.

{{#or (eq Location.City "Los Angeles") (eq Location.City "Seattle")}}

Vivi sulla costa occidentale degli Stati Uniti.

{{else}}

Non vivi sulla costa occidentale degli Stati Uniti.

{{/or}}

Questa sezione descrive quanto seguecordagli helper

  • abbreviate— Tronca un valore.

  • capitalize— Mette in maiuscolo ogni parola tra gli spazi bianchi.

  • capitalizeFirst— Converte in maiuscolo il primo carattere di un valore.

  • center— Centra un valore.

  • cut— Taglia un valore.

  • dateFormat— Imposta lo stile della data.

  • inflect— Restituisce una stringa singolare o plurale in base al conteggio.

  • join— Unisce un array, un iteratore o un oggetto iterabile.

  • ljust— Giustifica un valore sul margine sinistro.

  • lower— Converte un valore in lettere minuscole.

  • now— Stampa la data corrente.

  • ordinalize— Ordinalizza un valore numerico.

  • replace— Sostituisce una stringa con un'altra.

  • rjust— Giustifica un valore sul margine destro.

  • slugify— Converte un valore in lettere minuscole e rimuove i caratteri diversi da una parola, converte gli spazi in trattini e rimuove gli spazi bianchi finali.

  • stripTags— Rimuove [X] i tag HTML da un valore.

  • substring— Restituisce una nuova stringa come sottostringa di un valore passato.

  • upper— Converte il valore passato in lettere maiuscole.

  • yesno— Sostituisce vero, falso e no con Sì, No e Forse.

abbreviare

Tronca un valore se il valore supera il numero specificato. Gli spazi bianchi sono inclusi nel conteggio delle lunghezze. Nella risposta viene visualizzata un'ellisse per indicare un valore troncato. I puntini di sospensione vengono conteggiati ai fini del valore troncato nella risposta. Questo tipo di aiutante è utile se si dispone di un tavolo grande e uno spazio minimo. Il troncamento dei valori in una cella consente di avere un aspetto più uniforme della tabella.

Utilizzo

{{abbreviate value X}}, sostituendoXcon un valore numerico che indica il numero di caratteri da conservare. I numeri negativi non sono supportati.

Esempio

In questo esempio,abbreviateè usato per troncareUser.UserAttributes.LastName.[0]a sei (6) caratteri. La risposta include dei puntini di sospensione, i cui punti contano per il totale di sei caratteri.

Valori restituiti da {{abbreviate User.UserAttributes.LastName.[0] 6}}

Birra...seAlejandroè il valore di[0].

capitalizzare

Mette in maiuscolo ogni parola tra spazi bianchi.

Utilizzo

{{capitalize value}}

Esempio

In questo esempio, la capitalizzazione iniziale viene applicata a ogni parola perAttributes.description.[0]Voce.

{{capitalize Attributes.description.[0]}}

SeAttributes.description.[0]restituisce

My World Post, se il valore diAttributes.description.[0]èmio primo post.

Capitalizza prima

Converte in maiuscolo il primo carattere di un valore.

Utilizzo

{{capitalizeFirst value}}

Esempio

In questo esempio, la maiuscola viene applicata al primo carattere della prima parola delAttributes.description.[0]Voce.

Valori restituiti da {{capitalizeFirst Attributes.description.[0]}}

My first post, se il valore diAttributes.description.[0]èmio primo post.

Esempio

centro

Centra il valore in un campo di una determinata larghezza in base al numero specificato. Facoltativamente, puoi passare un carattere da visualizzare per la spaziatura interna o lasciare il campo vuoto. Se non viene passato alcun carattere, viene utilizzato uno spazio bianco.

Utilizzo

{{center value size=X [pad=" "}}, sostituendoXcon un valore numerico.

Sepadviene mantenuto vuoto, lo spazio bianco viene utilizzato come imbottitura nella risposta. Se passi un carattere, quel carattere viene visualizzato in ogni spazio della spaziatura interna. I numeri negativi non sono supportati.

Esempio

In questo esempio, il valore diLocation.City è centrato con una dimensione di19.

Valori restituiti da {{center Location.City size=19}}

«Los Angeles»SeLocation.CityèLos Angeles. Nota che le virgolette visualizzate nell'output di esempio sono fornite solo a scopo enfatico.

tagliare

Rimuove il valore specificato da una stringa.

Utilizzo

{{cut value [" "]}}, sostituendo lo spazio all'interno del parametro delle virgolette con il valore da tagliare. Se non viene passato alcun valore di parametro, viene utilizzato uno spazio bianco.

Esempio

Questo esempio rimuove la letteraedagliLocation.Cityattributo.

Valori restituiti da {{cut Location.City "e"}}

Los Angelesse[Location.CityèLos Angeles.

Voce di inserimento

Imposta lo stile di data predefinito per la data in qualsiasi risposta. Per un elenco degli ID dei fusi orari, vederehttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

Utilizzo

{{dateFormat date [inputFormat="format1"] [outputFormat="format2"][tz=timeZoneId]}}

Laformatil parametro deve essere uno tra:

  • "full«: formato data. Ad esempio: martedì 19 settembre 2020

  • "long«: formato data. Ad esempio: 19 settembre 2020

  • "medium«: formato data. Ad esempio: 19 settembre 2020

  • "short«: formato di data. Ad esempio: 19/9/20

  • "pattern«: utilizza un formato di modello di data personalizzato. Per ulteriori informazioni sui modelli di data, consultahttps://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.

Se non viene passato un formato, alloramediumè utilizzata per impostazione predefinita.

Esempio

In questo esempio,[0]Voce di inserimentoUser.UserAttributes.StartDate.[0]è09/19/2020e un messaggio viene inviato a un utente utilizzando ilfullformato della data basato sulAmerica/Los_AngelesFuso orario.

Valori restituiti da We can meet with you any time on {{dateFormat User.UserAttributes.StartDate.[0] inputFormat="MM/dd/yyyy" outputFormat="full" tz=America/Los_Angeles}}.

Possiamo incontrarti in qualsiasi momento martedì 19 settembre 2020.

inflettere

Restituisce una stringa singolare o plurale in base al valore di conteggio.

Utilizzo

{{inflect count singular plural [includeCount=false]}}

  • Inserisci le forme singolare e plurale della stringa che desideri trasmettere nell'argomento.

  • SeincludeCountè impostato su .false, non viene restituito alcun conteggio nella risposta. Se impostato sutrue, ilcountè incluso nella risposta.

Esempio

I seguenti esempi mostrano l'andamento dell'acquisto di mele, con e senzaincludeCount.

Thank you for your purchase of {{inflect 3 apple apples includeCount=false}}.restituisce:

Grazie per aver acquistato delle mele.

SeincludeCountè impostato su .true, allora la risposta è

Grazie per aver acquistato 3 mele.

join

Unisce un array, un iteratore o un oggetto iterabile. La risposta restituisce un elenco, con ogni valore dell'elenco concatenato dal carattere passato neljoin. Ad esempio, puoi separare i valori usando una virgola (,). Il valore in questo helper deve essere una lista senza un indice di posizione degli attributi. Ad esempio, potrebbe essereAttributes.custom_attribute.

Utilizzo

{{join value " // " [prefix=""] [suffix=""]}}

Esempio

In questo esempio, viene restituito un elenco di colori, con l'elenco separato da una virgola e uno spazio (", "):

Valori restituiti da {{join Attributes.favorite_colors ", "}}

blu, rosso, verdeseAttributes.favorite_colorsè la listablu, rosso, verde.

lussuria

Giustifica il valore sul margine sinistro e aggiunge spazio a destra in modo che la lunghezza del valore corrisponda al numero. I numeri negativi non sono supportati.

Facoltativamente, è possibile passare un carattere da visualizzare perpado lascia vuoto il campo. Se lasci ilpadvalore vuoto, il valore predefinito è uno spazio.

Utilizzo

{{ljust value X [pad=" "]}}, doveXè la lunghezza totale del valore, incluso lo spazio.

Esempio

In questo esempio, un valore di giustificazione a sinistra di15viene applicato a Location.City.

Valori restituiti da {{ljust Location.City 15}}

«Los Angeles»se il valore diLocation.CityèLos Angeles. Nota che le virgolette visualizzate nell'output di esempio sono fornite solo a scopo enfatico.

inferiore

Converte un valore in lettere minuscole.

Utilizzo

{{lower value}}

Esempio

In questo esempio,[0] Voce di inserimentoUser.UserAttributes.LastName.[0]viene cambiato in lettere minuscole.

Valori restituiti da {{lower User.UserAttributes.LastName.[0]}}

santosseSantosè il valore di[0].

ora

Stampa la data corrente in base all'ID del fuso orario passato. Per un elenco degli ID dei fusi orari, vederehttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

Utilizzo

{{now ["format"] [tz=timeZoneId]}}

Laformatil parametro deve essere uno tra:

  • "full«: formato data. Ad esempio: martedì 19 settembre 2020

  • "long«: formato data. Ad esempio: 19 settembre 2020

  • "medium«: formato data. Ad esempio: 19 settembre 2020

  • "short«: formato di data. Ad esempio: 19/9/20

  • "pattern«: uno schema di data. Per ulteriori informazioni sui modelli di data, consultahttps://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.

Se non viene passato un formato, alloramediumè utilizzata per impostazione predefinita.

Esempio

In questo esempio, la data corrente a Los Angeles viene restituita con unmedium.

Valori restituiti da {{now "medium" tz=America/Los_Angeles}}

19 settembre 2020.

ordinalus

Ordinalizza il valore numerico passato nell'argomento. Ad esempio,1è ordinalizzato come1°,2come2°, e così via. Sono supportati solo valori numerici.

Utilizzo

{{ordinalize [number]}}

Esempio

In questo esempio,[0]Voce di inserimentoUser.UserAttributes.UserAgeviene ordinalizzato e restituito, insieme a un messaggio.

Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!restituisce22ordinalizzati come22°.

Congratulazioni per il tuo 22esimo compleanno!

replace

Sostituisce una stringa con un'altra stringa. Una stringa o un valore numerico deve essere letterale. I caratteri jolly non sono supportati.

Utilizzo

{{replace stringToReplace replacementValue}}

Esempio

In questo esempio, un carattere di sottolineatura (_) sostituisce uno spazio bianco.

Valori restituiti da {{replace Location.City " " "_"}}

Los_Angelesse ilLocation.City èLos Angeles.

ruggine

Giustifica il valore sul margine destro e aggiunge spazio a sinistra in modo che la lunghezza del valore corrisponda al numero. I numeri negativi non sono supportati.

Facoltativamente, è possibile passare un carattere da visualizzare perpado lascia vuoto il campo. Se conservi ilpadvalore vuoto, il valore predefinito è uno spazio.

Utilizzo

{{rjust value X [pad=" "]}}, doveXè la lunghezza totale del valore, incluso lo spazio.

Esempio

In questo esempio, un valore di giustificazione corretto di15viene applicato alLocation.Cityattributo.

Valori restituiti da {{rjust Location.City 15}}

«Los Angeles». se ilLocation.CityèLos Angeles. Nota che le virgolette visualizzate nell'output sono fornite solo a scopo enfatico.

slugificare

Converte il valore passato in lettere minuscole, rimuove i caratteri diversi da una parola (alfanumerici e di sottolineatura), converte gli spazi in trattini e rimuove qualsiasi spazio bianco iniziale o finale.

Utilizzo

{{slugify value}}

Esempio

In questo esempio, slugify viene eseguito perLocation.Cityattributo.

Valori restituiti da {{slugify Location.City}}

los angelesseLocation.CityèLos Angeles.

Etichette a strisce

Rimuove [X] i tag HTML da un valore.

Utilizzo

{{stripTags value}}

Esempio

In questo esempio, i tag HTML per l'utente.UserAttributes.interest. [0] vengono rimossi.

Valori restituiti da {{stripTags User.UserAttributes.interests.[0]}}

Art (Arte), seUser.UserAttributes.interests.[0]è<h1>Art</h1>.

substring

Restituisce una nuova stringa come sottostringa del valore passato. La lunghezza e la posizione sono determinate dalstartOffseteendOffsetparametri, che devono essere valori interi. I numeri negativi non sono supportati. Se unendOffsetnon viene passata, la sottostringa utilizza il valore finale originale della stringa.

Utilizzo

{{substring value startOffset [endOffset]}}

Esempio

In questo esempio, un offset di 4 e EndOffset di 9 vengono applicati all'attributo Location.City.

{{substring Location.City 4 9}} restituisce

Angelse Los Angeles è il valore diLocation.CityèLos Angeles.

superiore

Converte il valore passato in lettere maiuscole.

Utilizzo

{{upper value}}

Esempio

In questo esempio,[0] Voce di inserimentoUser.UserAttributes.LastNamel'attributo viene convertito in lettere maiuscole.

{{upper User.UserAttributes.LastName.[0]}}restituisce

CAPRAse ilUser.UserAttributes.LastName.[0]Valore ècapri.

sì/no

Sostituiscetrue,falseeNULLconYes,NoeMaybe.

Utilizzo

{{yesno value [yes="yes"] [no="no"] maybe=["maybe"]}}

Esempio

In questo esempio,IsUserSubscribedattribute restituisce se un utente è iscritto a un determinato elenco.

Valori restituiti da {{yesno Attributes.IsUserSubscribed}}

sìseAttributes.IsUserSubscribedèvero.

Questa sezione descrive ilmatematica e coditiongli helper.

  • add— Restituisce la somma di due numeri.

  • ceiling— Mette in maiuscolo ogni parola tra gli spazi bianchi.

  • decode64— Decodifica un valore Base64Encoded in una stringa.

  • divide— Restituisce il quoziente di due numeri.

  • encode64— Codifica una stringa utilizzando Base64.

  • floor— Arrotonda un numero intero al suo livello matematico.

  • md5— Esegue l'hash di una stringa passata utilizzando l'algoritmo MD5.

  • modulo— Restituisce il resto di due numeri utilizzando virgole mobili.

  • multiply— Restituisce il prodotto di due numeri.

  • round— Arrotondare un decimale al numero intero più vicino.

  • sha256— Esegue l'hash di una stringa passata utilizzando SHA-256.

  • sha512— Esegue l'hash di una stringa passata utilizzando SHA-512.

  • subtract— Restituisce la differenza di due numeri.

  • uuid— Genera casualmente un UUID in un formato a 128 bit.

aggiungi

Restituisce la somma di due numeri insieme a virgolette.

Utilizzo

{{add arg1 arg2}}

Esempio

{{add 5 2.3}} restituisce

7.3

soffitto

Arrotonda un numero intero al suo limite matematico, che è il numero intero più alto più vicino al valore passato.

Utilizzo

{{ceiling value}}

Esempio

Valori restituiti da {{ceiling 5.23}}

6

decodificare 64

Decodifica un valore codificato Base64 in una stringa.

Utilizzo

{{decode64 "string"}}

Esempio

Valori restituiti da {{encode64 "SGVsbG8gd29ybGQ="}}

Hello World

dividere

Restituisce il quoziente di due numeri, compresi i virgole mobili.

Utilizzo

{{divide arg1 arg2}}

Esempio

Valori restituiti da {{divide 5 2.3}}

2.17391304

codificare 64

Codifica la stringa passata nell'argomento utilizzando Base64.

Utilizzo

{{encode64 "string"}}

Esempio

{{encode64 "Hello World"}}

SGV vs BG8GD29 YBGQ =

pavimento

Arrotonda un numero intero al suo livello matematico, che è il numero intero più basso vicino al valore passato.

Utilizzo

{{floor value}}

Esempio

Valori restituiti da {{floor 5.23}}

5

md5

Esegue l'hash di una stringa passata utilizzando l'algoritmo MD5.

Utilizzo

{{md5 "string"}}

Esempio

{{md5 "Hello World"}}

3e25960a79dbc69b674cd4ec67a72c62

modulo

Restituisce il resto di due numeri utilizzando virgole mobili.

Utilizzo

{{modulo arg1 arg2}}

Esempio

Valori restituiti da {{modulo 7 2}}

1

moltiplicare

Restituisce il prodotto di due numeri, con qualsiasi virgola mobile.

Utilizzo

{{multiply arg1 arg2}}

Esempio

Valori restituiti da {{multiply 5 2.3}}

11.5

rotondo

Arrotondare una posizione decimale al numero intero più vicino.

Utilizzo

{{round value}}

Esempio

You spent an average of {{round 19.21}} minutes on our website each day.restituisce:

Hai trascorso in media 19 minuti sul nostro sito web ogni giorno.

sha256

Esegue l'hash di una stringa passata utilizzando la sicurezza crittografica SHA-256.

Utilizzo

{{sha256 "string"}}

Esempio

Valori restituiti da {{sha256 "Hello World"}}

a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e

sha512

Esegue l'hash di una stringa passata utilizzando la sicurezza crittografica SHA-512.

Utilizzo

{{sha512 "string"}}

Esempio

Valori restituiti da {{sha512 "Hello World"}}

2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0daa8f51671064615d645ae27acb15bfb1447f459b

togliere

Restituisce la differenza di due numeri, con qualsiasi virgola mobile.

Utilizzo

{{subtract arg1 arg2}}

Esempio

Valori restituiti da {{subtract 5 2.3}}

2.7

uuid

Genera casualmente un UUID in un formato standard a 128 bit. Non è necessario passare alcun valore nell'argomento.

Utilizzo

{{uuid}}

Esempio

Valori restituiti da {{uuid}}

95f36680-152c-4052-99ec-cc3cdf7ca594

Sebbene tecnicamente non sia un aiuto, i parziali in linea sono un modo di Handlebar per semplificare i modelli che includono stringhe ripetute, consentendone un più facile riutilizzo. Per ulteriori informazioni, consultaParziali in lineaalhandlebarsjs.com.

Utilizzo

{{#* inline "inlineName"}}Content to reuse{{/inline}}

Per fare riferimento al contenuto del parziale in linea altrove, usa:

{{> inlineName}}

Esempio

L'esempio seguente crea una funzione in linea che include il nome del destinatario e, se è disponibile, cognome aggiungendo il codice seguente all'inizio del modello:

{{#* inline "fullName"}}

{{User.UserAttributes.FirstName.[0]}} {{#if User.UserAttributes.LastName.[0]}} {{User.UserAttributes.LastName.[0]}} {{/if}}

{{/inline}}

Dopo aver creato ilfullNameparziale, puoi includerlo in qualsiasi punto del tuo modello anteponendo al nome della funzione>simbolo (maggiore di), seguito da uno spazio, come nell'esempio seguente:{{> fullName}}.

Hello {{> fullName}}

restituisce il nome e il cognome dell'utente se vero, ad esempioHello Jane Doe. Altrimenti, se non viene trovato alcun cognome,Hello Janeviene restituiti.

I manubri includono altre caratteristiche oltre quelle documentate qui. Per ulteriori informazioni, consulta la paginahandlebarsjs.com.

Utilizzo di variabili con gli helper dei modelli di messaggio

Individua gli attributi personalizzati, ad esempioUser.UserAttributes.LastName, vengono archiviati come elenco, indipendentemente dal fatto che vi sia un singolo elemento o più elementi. Quando si passa una lista in un helper che si aspetta una stringa, è necessario specificare il valore dell'indice dell'attributo insieme al nome dell'attributo. Questo valore dell'indice di attributo indica la posizione di un valore dall'elenco degli attributi:.[0]per la prima voce nell'elenco,.[1]per il secondo,.[2]per il terzo e così via. Ad esempio, supponiamo che tu stia utilizzando ilupperaiutante per convertire il primo ([0]) Voce di inserimentoUser.UserAttributes.LastNamea tutte le lettere maiuscole. L'utilizzo dell'helper{{upper value}}e l'attributo formattato comeUser.UserAttributes.LastName. Replace (Sostituisci)valorecon il nome attributo e il valore indice dell'attributo.[0]come segue: {{upper User.UserAttributes.LastName.[0]}}. La risposta, quindi, restituisce il[0]voce dall'elenco, formattata interamente in maiuscolo. Ad esempio, se il valore di[0]èSantos, la risposta viene restituitaSANTOS.

utilizzo degli helper nidificati

Puoi annidare più helper dei modelli di messaggi l'uno nell'altro. Gli esempi seguenti mostrano come formattare due helper: {{ first helper (second helper)}}. Il secondo helper viene elaborato per primo, seguito dal primo helper. Ricorda che il primo helper determina sempre l'output. Gli helper successivi devono essere annidati all'interno dell'helper precedente come segue:{{ first helper (second helper (third helper) )}}.

L'esempio seguente mostra come annidare due aiutanti per cambiarliJANEaJane:{{capitalizeFirst (lower "JANE")}}.lowerprimi convertitiJANEajane. PoicapitalizeFirstconvertejaneaJane.