Aviso de fim do suporte: em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Depois de 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint ou os recursos do Amazon Pinpoint (endpoints, segmentos, campanhas, viagens e análises). Para obter mais informações, consulte Fim do suporte do Amazon Pinpoint. Observação: APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Usar assistentes de modelos de mensagens
Com os modelos do Amazon Pinpoint, os clientes podem criar modelos de mensagens reutilizáveis com base na linguagem Handlebars.js. Os assistentes fornecem uma variedade de recursos, como formatar um preço para a moeda de uma Região específica ou adicionar um local com base no fuso horário. Um assistente pode usar uma cadeia de caracteres ou número inteiro específico para o valor ou para uma variável de mensagem específica do Amazon Pinpoint.
As categorias de assistentes estão descritas nas seções a seguir:
Esta seção descreve os assistentes integrados fornecidos pelo Handlebars. Para obter a lista completa, consulte Built-in Helpers
-
each: itera uma lista.nota
O tamanho máximo da lista é de 15 itens.
-
if: avalia uma declaração.
- cada
-
Itera uma lista. Esse assistente usa somente uma declaração de bloco. Você pode, opcionalmente:
-
Passar
@indexna solicitação para fazer referência ao índice de loop atual. -
Usar o assistente
thispara referenciar o elemento atual que está sendo iterado. -
Retornar a resposta do assistente em uma lista, usando a tag
<li>.
Uso
{{#eachvalue}}O valor na posição
{{@index}}é{{this}}.{{else}}A condição é falsa.
{{/each}}eachdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/each}}na declaração de bloco.Exemplo
Neste exemplo,
eaché usado para retornar uma lista das cores favoritas de um usuário. Parafalse, uma declaraçãoelseé retornada. Se a solicitação for essa:{{#each User.UserAttributes.FavoriteColors}}<li>{{this}}</li>{{else}}You have no favorite colors.{{/each}}retorna-
red -
blue -
yellow
para uma declaração verdadeira.
-
- se
-
Avalia se algo é verdadeiro e retorna uma resposta com base na avaliação.
Uso
{{#ifvalue}}O valor é indefinido
{{else}}O valor é indefinido
{{/if}}ifdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/if}}na declaração de bloco.Exemplo
Neste exemplo, o assistente
ifé usado para avaliar o primeiro nome de um usuário. Se o nome for encontrado, será retornada uma saudação que passa o primeiro nome do usuário na resposta. Caso contrário, a declaraçãoelseretornará uma saudação alternativa.{{#if User.UserAttributes.FirstName.[0]}}Hello{{User.UserAttributes.FirstName.[0]}},{{else}}Hello,{{/if}}retorna
Hello, Janese oifauxiliar for verdadeiro.
Esta seção descreve os assistentes condicionais.
Os assistentes condicionais podem ser usados em uma única linha ou em uma declaração de bloco. Você pode personalizar a resposta independentemente do método assistente usado. Você pode passar assistentes condicionais adicionais em declarações de linha única e de bloco. Os seguintes assistentes condicionais mostram, primeiramente, o uso de uma única linha e, depois, de uma declaração de bloco usando uma cláusula opcional else. Os assistentes condicionais são os seguintes:
-
and: compara se todos os elementos passados são iguais. -
eq: testa se dois elementos são iguais. -
gt: testa se um elemento é maior que outro. -
gte: testa se um elemento é maior ou igual a outro. -
if: avalia se algo é verdadeiro. -
lt: testa se um elemento é menor que outro. -
lte: testa se um elemento é menor ou igual a outro. -
neq: avalia se dois elementos não são iguais. -
not: inverte a resposta de uma operação booleana. -
or: compara se algum dos elementos do argumento é igual.
- and
-
Compara se todos os elementos passados em um argumento são iguais e retorna a resposta com base no resultado. Esse assistente pode ser usado para valores não booleanos. Você deve passar pelo menos dois elementos para a condição.
Uso
-
{{andvalueavaluebvaluecvaluedyes='y' no='n'}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. -
{{#andvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/and}}anddeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/and}}na declaração de bloco.
Exemplo
Neste exemplo,
eqé usado na declaração de blocoandpara determinar se ambas as cadeias de caracteres passadas para os atributosLocation.CityeLocation.Countrysão verdadeiras. Se as duas condições forem iguais, uma declaração verdadeira será retornada. Se algum desses atributos for falso, uma declaraçãoelseserá retornada.{{#and (eq Location.City "Los Angeles") (eq Location.Country "US")}}You live in Los Angeles and the US.{{else}}You don’t live in Los Angeles and the US.{{/and}} -
- eq
-
Testa se dois elementos são iguais ou se o valor de um elemento é igual a uma cadeia de caracteres passada.
Uso
-
{{eqvalueavaluebyes='y' no='n'}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. -
{{#eqvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/eq}}eqdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/eq}}na declaração de bloco.
Exemplo
Neste exemplo,
eqé usado para avaliar se o valor deUser.UserAttributes.FavoriteColors.[0]éRed. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#eq User.UserAttributes.FavoriteColors.[0] "red"}}Your favorite color is red.{{else}}You don't like red.{{/eq}} -
- gt
-
Testa se o valor de um elemento é maior que o de outro.
Uso
-
{{gtvalueavaluebyes='y' no='n'}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. -
{{#gtvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/gt}}gtdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/gt}}na declaração de bloco.
Exemplo
Neste exemplo, o auxiliar compara o valor do
User.UserAttributes.UserAge.[0]atributo com uma string17, para verificar se a idade do usuário é maior que 17. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#gt User.UserAttributes.UserAge.[0] "17"}}You are old enough to rent a car.{{else}}You are not old enough to rent a car.{{/gt}} -
- gte
-
Testa se o valor de um elemento é maior ou igual a outro.
Usage-
{{gtevalueavaluebyes='y' no='n'}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. -
{{#gtevalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/gte}}getdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/gte}}na declaração de bloco.
Exemplo
Neste exemplo, o auxiliar compara o
User.UserAttributes.UserAge.[0]atributo com uma string18, para verificar se a idade do usuário é maior ou igual a 18 anos. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#gte User.UserAttributes.UserAge.[0] "18"}}You are old enough to rent a car.{{else}}You are not old enough to rent a car.{{/gte}} -
- se
-
Avalia se algo é verdadeiro e retorna uma resposta com base na avaliação.
Uso
-
{{#ifvalue}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. -
{{#if}}valueA condição é verdadeira.
{{else}}A condição é falsa.
{{/if}}ifdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/if}}na declaração de bloco.
Exemplo
Neste exemplo, o assistente é usado para avaliar o primeiro nome de um usuário. Se o nome for encontrado, será retornada uma saudação que passa o primeiro nome do usuário na resposta. Caso contrário, a declaração else retornará uma saudação alternativa.
{{#if User.UserAttributes.FirstName.[0]}}Hello{{User.UserAttributes.FirstName.[0]}},{{else}}Hello,{{/if}}retorna
Hello Jane,se o auxiliar for verdadeiro. -
- lt
-
Testa se o valor de um elemento é menor que o valor de outro.
Uso
-
{{ltvalueavaluebyes='y' no='n'}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. -
{{#ltvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/lt}}ltdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/lt}}na declaração de bloco.
Exemplo
Neste exemplo, o auxiliar compara o
User.UserAttributes.UserAge.[0]atributo com uma string18para verificar se a idade do usuário é menor que 18 anos. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#lt User.UserAttributes.UserAge.[0] "18"}}You are not old enough to rent a car.{{else}}You are old enough to rent a car.{{/lt}} -
- lte
-
Testa se o valor de um elemento é menor ou igual a outro.
Uso
-
{{ltevalueavaluebyes='y' no='n'}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. -
{{#ltevalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/lte}}ltedeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/lte}}na declaração de bloco.
Exemplo
Nessa declaração de bloco, o auxiliar compara o
User.UserAttributes.UserAge.[0]atributo com uma string17para verificar se a idade do usuário é igual a 17 anos ou menos. Se a resposta fortrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#lte User.UserAttributes.Age.[0] "17"}}You are not old enough to rent a car.{{else}}You are old enough to rent a car.{{/lte}} -
- neq
-
Teste se dois elementos não são iguais.
Uso
-
{{neqvalueavaluebyes='y' no='n'}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. -
{{#neqvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/neq}}neqdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/neq}}na declaração de bloco.
Exemplo
Nessa declaração de bloco, o atributo
User.UserAttributes.FavoriteColors.[0]é verificado em relação a uma cadeia de caracteres,. Se a resposta forRedtrue, uma declaração verdadeira será retornada. Se a resposta forfalse, uma declaraçãoelseserá retornada.{{#neq User.UserAttributes.Favorite.Colors.[0] "red"}}You do not like red.{{else}}You like red.{{/neq}} -
- not
-
Inverte a resposta de uma operação booleana, de forma que, se
notfor uma comparação positiva, uma declaraçãotrueserá retornada. Se a resposta for falsa, uma declaração else será retornada.Uso
-
{{notvalueyes='y' no='n'}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. -
{{#not}}valueA condição é verdadeira.
{{else}}A condição é falsa.
{{/not}}notdeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/not}}na declaração de bloco.
Exemplo
Nessa instrução de bloco, o
User.UerAttributes.FavoriteColors.[0]atributo é verificado em relação a uma stringred, usando oeqauxiliar. O assistentenotentão retorna o oposto do assistenteeq. Se a resposta retornar qualquer cor diferente dered,trueuma declaração a será retornada. Se a resposta retornarred, umaelsedeclaração será retornada indicando uma declaração falsa.{{#not (eq User.UserAttributes.Favorite.Colors.[0] "red")}}You do not like red.{{else}}You like red.{{/not}}Exemplo
Neste exemplo,
{{not (eq User.UserAttributes.FavoriteColors.[0] "red")}}retorna falso se
User.UserAttributes.FavoriteColors.[0]forred. -
- or
-
Compara se algum dos elementos no argumento é igual e retorna uma resposta com base no resultado. Esse assistente pode ser usado para valores não booleanos.
Uso
-
{{orvalueavaluebvaluecvaluedyes='y' no='n'}}Você pode
nsubstituirye por outros valores, comoyesandno, ou qualquer outra string que você deseja retornar, dependendo da condição. Você deve passar pelo menos dois elementos para a condição. -
{{#orvalueavalueb}}A condição é verdadeira.
{{else}}A condição é falsa.
{{/or}}ordeve ser precedido por um sinal de libra (#) e concluir com um fechamento{{/or}}na declaração de bloco.
Exemplo
Nessa declaração de bloco
or, duas cadeias de caracteres do atributoLocation.Citysão comparadas, adicionalmente, usando o assistenteeq. Se algum dos atributos fortrue, uma declaração verdadeira será retornada. Se uma ou mais das respostas foremfalse, uma declaraçãoelseserá retornada.{{#or (eq Location.City "Los Angeles") (eq Location.City "Seattle")}}You live on the West Coast of the United States.{{else}}You do not live on the West Coast of the United States.{{/or}} -
Esta seção descreve os seguintes assistentes de cadeia de caracteres:
-
abbreviate: trunca um valor. -
capitalize: coloca cada palavra entre espaços em branco. -
capitalizeFirst: capitaliza o primeiro caractere de um valor. -
center: centraliza um valor. -
cut: corta um valor. -
dateFormat: define o estilo da data. -
inflect: retorna uma cadeia de caracteres singular ou plural com base na contagem. -
join: une uma matriz, iterador ou objeto iterável. -
ljust: justifica um valor na margem esquerda. -
lower: converte um valor em letras minúsculas. -
now: imprime a data atual. -
ordinalize: transforma um valor numérico em número decimal. -
replace: substitui uma cadeia de caracteres por outra. -
rjust: justifica um valor na margem direita. -
slugify: converte um valor em letras minúsculas e remove caracteres que não sejam palavras, converte espaços em hifens e remove o espaço em branco à direita. -
stripTags: retira as tags [X]HTML de um valor. -
substring: retorna uma nova cadeia de caracteres como sub-cadeia de um valor passado. -
upper: converte o valor passado em letras maiúsculas.
-
yesno: substitui verdadeiro, falso e não por Sim, Não e Talvez.
- abreviar
-
Trunca um valor se este exceder o número especificado. Os espaços em branco estão incluídos na contagem de comprimento. Reticências são exibidas na resposta para indicar um valor truncado. As reticências contam para o valor truncado na resposta. Esse tipo de assistente é útil se você tiver uma mesa grande e espaço mínimo. Truncar valores em uma célula permite que você tenha uma aparência mais uniforme da tabela.
Uso
{{abbreviate,valueX}}Xsubstituindo por um valor numérico indicando o número de caracteres a serem mantidos. Não há suporte para números negativos.Exemplo
Neste exemplo,
abbreviateé usado para truncarUser.UserAttributes.LastName.[0]para seis (6) caracteres. A resposta inclui reticências, cujos pontos contam para o total de seis caracteres.{{abbreviateretornaUser.UserAttributes.LastName.[0]6}}Ale...seAlejandroé o valor de[0]. - capitalize
-
Capitaliza cada palavra entre espaços em branco.
Uso
{{capitalizevalue}}Exemplo
Neste exemplo, a capitalização inicial é aplicada a cada palavra da entrada
Attributes.description.[0].{{capitalizeAttributes.description.[0]}}Se
Attributes.description.[0]retornarMy First Post, se o valor deAttributes.description.[0]formy first post. - capitalizeFirst
-
Capitaliza o primeiro caractere de um valor.
Uso
{{capitalizeFirstvalue}}Exemplo
Neste exemplo, a capitalização é aplicada ao primeiro caractere da primeira palavra da entrada
Attributes.description.[0].{{capitalizeFirstretornaAttributes.description.[0]}}My first post, se o valor deforAttributes.description.[0]my first post.Exemplo
- center
-
Centraliza o valor em um campo de uma determinada largura pelo número especificado. Opcionalmente, você pode passar um caractere para exibir no preenchimento ou deixar o campo em branco. Se nenhum caractere for passado, um espaço em branco será usado.
Uso
{{center,valuesize=X[pad=" "}}Xsubstituindo por um valor numérico.Se
padfor mantido em branco, o espaço em branco será usado como preenchimento na resposta. Se você passar um caractere, esse caractere será exibido em cada espaço do preenchimento. Não há suporte para números negativos.Exemplo
Neste exemplo, o valor de
Location.Cityé centralizado com um tamanho de19.{{centerretornaLocation.Citysize=19}}" Los Angeles "SeLocation.CityforLos Angeles. Observe que as aspas exibidas no exemplo são fornecidas apenas para dar ênfase. - cut
-
Remove o valor especificado de uma cadeia de caracteres.
Uso
{{cut, substituindo o espaço dentro do parâmetro de aspas pelo valor a ser cortado. Se nenhum valor de parâmetro for passado, um espaço em branco será usado.value[" "]}}Exemplo
Este exemplo remove a letra
edoLocation.Cityatributo.{{cutretornaLocation.City"e"}}Los Anglsse[Location.CityéLos Angeles. - dateFormat
-
Define o estilo de data padrão para a data em qualquer resposta. Para obter uma lista do fuso horário IDs, consultehttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones
. Uso
{{dateFormat date [inputFormat="format1"] [outputFormat="format2"] [tz=timeZoneId] [locale=localeID]}}O parâmetro
formatdeve ser:-
“
full“: formato de data completo. Por exemplo:Tuesday, September 19, 2020 -
“
long“: formato de data longo. Por exemplo:September 19, 2020 -
“
medium“: formato de data médio. Por exemplo:Sept 19, 2020 -
“
short“: formato de data abreviada. Por exemplo:9/19/20 -
“
pattern“: usa um formato de padrão de data personalizado. Para obter mais informações sobre padrões de datas, consulte https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.
“
locale“: usa um formato de data baseado em uma determinada localidade. Para mais informações sobre esses locais, consulte https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-. Se um formato não for passado,
mediumserá usado por padrão.Exemplo
Neste exemplo, a
[0]entrada paraéUser.UserAttributes.StartDate.[0]09/19/2020e uma mensagem é enviada a um usuário usando o formato defulldata com base no fusoAmerica/Los_Angeleshorário.We can meet with you any time on{{dateFormat User.UserAttributes.StartDate.[0] inputFormat="MM/dd/yyyy" outputFormat="full" tz=America/Los_Angeles}}.retornaWe can meet with you any time on Tuesday, September 19, 2020. -
- inflect
-
Retorna uma cadeia de caracteres singular ou plural com base no valor de contagem.
Uso
{{inflectcountsingularplural[includeCount=false]}}-
Insira as formas singular e plural da cadeia de caracteres que você deseja passar no argumento.
-
Se
includeCountestiver definido comofalse, nenhuma contagem será retornada na resposta. Se definido comotrue, ocounté incluído na resposta.
Exemplo
Os exemplos a seguir mostram a inflexão de uma compra de maçãs, com e sem
includeCount.Thank you for your purchase of {{inflectretorna:3appleapplesincludeCount=false}}.Thank you for your purchase of apples.Se
includeCountestiver definido comotrue, a resposta seráThank you for your purchase of 3 apples. -
- ingressar
-
Une uma matriz, um iterador ou um objeto iterável. A resposta retorna uma lista, com cada valor na lista concatenado pelo caractere que você passa no
join. Por exemplo, você pode separar valores usando uma vírgula (,). O valor nesse assistente deve ser uma lista sem um índice de posição do atributo. Por exemplo, pode serAttributes.custom_attribute.Uso
{{joinvalue" // " [prefix=""] [suffix=""]}}Exemplo
Neste exemplo, uma lista de cores é retornada, com a lista separada por uma vírgula e um espaço (
", "):{{joinretornaAttributes.favorite_colors","}}blue, red, greenseAttributes.favorite_colorsé a listablue,red,green. - ljust
-
Justifica o valor na margem esquerda e adiciona espaço à direita, para que o comprimento do valor corresponda ao número. Não há suporte para números negativos.
Opcionalmente, você pode passar um caractere para exibir no
padou deixar o campo em branco. Se você deixar o valorpadem branco, o valor padrão será um espaço em branco.Uso
{{ljust, ondevaluesize=X[pad=" "]}}Xé o comprimento total do valor, incluindo espaço em branco.Exemplo
Neste exemplo, um valor de justificação à esquerda de
15é aplicado ao Location.City.{{ljustretornaLocation.Citysize=15}}"Los Angeles "se o valor deLocation.CityforLos Angeles. Observe que as aspas exibidas no exemplo são fornecidas apenas para dar ênfase. - lower
-
Converte um valor em todas as letras minúsculas.
Uso
{{lowervalue}}Exemplo
Neste exemplo, a entrada
[0]paraUser.UserAttributes.LastName.[0]é alterada para minúscula.{{lowerretornaUser.UserAttributes.LastName.[0]}}santosseSantosé o valor de[0]. - agora
-
Imprime a data atual com base no ID de fuso horário aprovado. Para obter uma lista do fuso horário IDs, consultehttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones
. Uso
{{now [format="format"] [tz=timeZoneId] [locale=localeID]}}O parâmetro
formatdeve ser:-
“
full“: formato de data completo. Por exemplo:Tuesday, September 19, 2020 -
“
long“: formato de data longo. Por exemplo:September 19, 2020 -
“
medium“: formato de data médio. Por exemplo: 19 de set de 2020 -
“
short“: formato de data abreviada. Por exemplo: 19/09/20 -
“
pattern“: um padrão de data. Para obter mais informações sobre padrões de datas, consulte https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.
“
locale“: usa um formato de data baseado em uma determinada localidade. Para mais informações sobre esses locais, consulte https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-. Se um formato não for passado,
mediumserá usado por padrão.Exemplo
Neste exemplo, a data atual em Los Angeles é retornada com um formato
medium.{{now "medium" tz=retornaAmerica/Los_Angeles}}Sept 19, 2020. -
- ordinalize
-
Ordena o valor numérico passado no argumento. Por exemplo,
1é ordinalizado como1ste2como2nd. Somente valores numéricos são compatíveis.Uso
{{ordinalize [number]}}Exemplo
Neste exemplo, a entrada
[0]deUser.UserAttributes.UserAgeé transformada em número ordinal e retornada junto com uma mensagem.Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!retorna22ordinalizado como22nd.Congratulations on your 22nd birthday! - subtituir
-
Substitui uma cadeia de caracteres por outra. Uma cadeia de caracteres ou um valor numérico deve ser literal. Caracteres curinga não são compatíveis.
Uso
{{replacestringToReplacereplacementValue}}Exemplo
Neste exemplo, um sublinhado (_) substitui um espaço em branco.
{{replaceretornaLocation.City" " "_"}}Los_AngelesseLocation.Cityfor o casoLos Angeles. - rjust
-
Justifica o valor na margem esquerda e adiciona espaço à esquerda, para que o comprimento do valor corresponda ao número. Não há suporte para números negativos.
Opcionalmente, você pode passar um caractere para exibir no
padou manter o campo em branco. Se você deixar o valorpadem branco, o valor padrão será um espaço em branco.Uso
{{rjust, ondevaluesize=X[pad=" "]}}Xé o comprimento total do valor, incluindo espaço em branco.Exemplo
Neste exemplo, um valor de justificação correta de
15é aplicado aoLocation.Cityatributo.{{rjustretornaLocation.Citysize=15}}" Los Angeles". seLocation.CityforLos Angeles. Observe que as aspas exibidas no resultado são fornecidas apenas para dar ênfase. - slugify
-
Converte o valor passado em letras minúsculas, remove caracteres que não são palavras (alfanuméricos ou sublinhados), converte espaços em hifens e remove espaços em branco à direita e à esquerda.
Uso
{{slugifyvalue}}Exemplo
Neste exemplo, o slugify é executado para o atributo
Location.City.{{slugifyretornaLocation.City}}los-angelesseLocation.CityéLos Angeles. - stripTags
-
Retira as tags [X]HTML de um valor.
Uso
{{stripTagsvalue}}Exemplo
Neste exemplo, as tags HTML para o usuário. UserAttributes.interest. [0] são removidos.
{{stripTagsretornaUser.UserAttributes.interests.[0]}}Art, seUser.UserAttributes.interests.[0]for<h1>Art</h1>. - substring
-
Retorna uma nova cadeia de caracteres como sub-cadeia do valor passado. O comprimento e a posição são determinados pelos parâmetros
startOffseteendOffset, que devem ser números inteiros. Não há suporte para números negativos. Se umendOffsetnão for passado, a sub-cadeia usará o valor final original da cadeia de caracteres.Uso
{{substringvaluestartOffset[endOffset]}}Exemplo
Neste exemplo, um offset de 4 e endOffset de 9 são aplicados ao atributo Location.City.
{{substringretornaLocation.City 4 9}}se Los Angeles é o valor deAngelLocation.CityéLos Angeles. - upper
-
Converte o valor passado em letras maiúsculas.
Uso
{{uppervalue}}Exemplo
Neste exemplo, todas as letras da entrada
[0]do atributoUser.UserAttributes.LastNamesão convertidas em maiúsculas.{{upper User.UserAttributes.LastName.[0]}}retornaROEse oUser.UserAttributes.LastName.[0]valor forRoe. - yesno
-
Substitui
true,falseeNULLporYes,NoeMaybe.Uso
{{yesno value [yes="yes"] [no="no"] maybe=["maybe"]}}Exemplo
Neste exemplo, o atributo
IsUserSubscribedretorna se um usuário está inscrito em uma lista específica.{{yesno Attributes.IsUserSubscribed}}retornayesseAttributes.IsUserSubscribedétrue.
Esta seção descreve os assistentes de matemática e codificação.
-
add: retorna a soma de dois números. -
ceiling: arredonda um número inteiro até seu teto matemático. -
decode64: decodifica um valor codificado em base64 em uma cadeia de caracteres. -
divide: retorna o quociente de dois números. -
encode64: codifica uma cadeia de caracteres usando base64. -
floor: arredonda um número inteiro até seu piso matemático. -
md5— Faz o hash de uma string passada usando o MD5 algoritmo. -
modulo: retorna o resto de dois números usando pontos flutuantes. -
multiply: retorna o produto de dois números. -
round: arredonda um decimal para o número inteiro mais próximo. -
sha256: faz o hash de uma cadeia de caracteres passada usando SHA-256. -
sha512: faz o hash de uma cadeia de caracteres passada usando SHA-512. -
subtract: retorna a diferença de dois números. -
uuid: gera aleatoriamente um UUID em um formato de 128 bits.
- add
-
Retorna a soma de dois números junto com vírgulas flutuantes.
Uso
{{addarg1arg2}}Exemplo
{{addretorna5 2.3}}7.3 - ceiling
-
Arredonda um inteiro até seu teto matemático, que é o maior número inteiro mais próximo do valor passado.
Uso
{{ceilingvalue}}Exemplo
{{ceilingretorna5.23}}6 - decode64
-
Decodifica um valor codificado em base64 em uma cadeia de caracteres.
Uso
{{decode64 "string"}}Exemplo
{{decode64 "retornaSGVsbG8gd29ybGQ="}}Hello World - divide
-
Retorna o quociente de dois números, incluindo vírgulas flutuantes.
Uso
{{dividearg1arg2}}Exemplo
{{divideretorna5 2.3}}2.17391304 - encode64
-
Codifica a cadeia de caracteres passada no argumento usando base64.
Uso
{{encode64 "string"}}Exemplo
{{encode64 "Hello World"}}SGVsbG8gd29ybGQ= - floor
-
Arredonda um número inteiro para seu piso matemático, que é o menor número inteiro mais próximo do valor passado.
Uso
{{floorvalue}}Exemplo
{{floorretorna5.23}}5 - md5
-
Faz o hash de uma string passada usando o MD5 algoritmo.
Uso
{{md5 "string"}}Exemplo
{{md5 "Hello World"}}3e25960a79dbc69b674cd4ec67a72c62 - modulo
-
Retorna o resto de dois números usando vírgulas flutuantes.
Uso
{{moduloarg1arg2}}Exemplo
{{moduloretorna7 2}}1 - multiply
-
Retorna o produto de dois números junto com vírgulas flutuantes.
Uso
{{multiplyarg1arg2}}Exemplo
{{multiplyretorna5 2.3}}11.5 - round
-
Arredonda uma casa decimal para cima ou para baixo para o número inteiro mais próximo.
Uso
{{roundvalue}}Exemplo
You spent an average of {{roundretorna:19.21}} minutes on our website each day.You spent an average of 19 minutes on our website each day. - sha256
-
Faz o hash de uma cadeia de caracteres passada usando a segurança criptográfica SHA-256.
Uso
{{sha256 "string"}}Exemplo
{{sha256 "retornaHello World"}}a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e - sha512
-
Faz o hash de uma cadeia de caracteres passada usando a segurança criptográfica SHA-512.
Uso
{{sha512 "string"}}Exemplo
{{sha512 "retornaHello World"}}2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0daa8f51671064615d645ae27acb15bfb1447f459b - subtract
-
Retorna a diferença de dois números junto com vírgulas flutuantes.
Uso
{{subtractarg1arg2}}Exemplo
retorna{{subtract5 2.3}}2.7 - uuid
-
Gera aleatoriamente um UUID em um formato padrão de 128 bits. Nenhum valor precisa ser passado no argumento.
Uso
{{uuid}}Exemplo
retorna{{uuid}}95f36680-152c-4052-99ec-cc3cdf7ca594
Embora tecnicamente não sejam assistentes, as parciais em linha são uma forma do Handlebar de simplificar modelos que incluem cadeias de caracteres repetidas, facilitando a reutilização. Para obter mais informações, consulte Inline partials
Uso
{{#* inline "inlineName"}}Content to reuse{{/inline}}
Para referenciar o conteúdo da parcial em linha em outro lugar, use:
{{> inlineName}}
Exemplo
O seguinte exemplo cria uma parcial em linha que inclui o nome do destinatário e, se disponível, o sobrenome, adicionando o seguinte código no início do modelo:
{{#* inline "fullName"}}
{{User.UserAttributes.FirstName.[0]}} {{#if
User.UserAttributes.LastName.[0]}} {{User.UserAttributes.LastName.[0]}} {{/if}}
{{/inline}}
Depois de criar a parcial fullName, você pode incluí-la em qualquer lugar em seu modelo colocando antes do nome da parcial um sinal de > (maior que), seguido por um espaço, como no exemplo a seguir: {{>
fullName}}.
Hello {{> fullName}}
retorna o nome e o sobrenome do usuário, se verdadeiros — por exemplo,Hello
Jane Doe. Caso contrário, se nenhum sobrenome for encontrado, Hello
Jane será retornado.
O Handlebars inclui atributos adicionais além dos documentados aqui. Para obter mais informações, consulte handlebarsjs.com
Usar variáveis com assistentes de modelo de mensagem
Os atributos personalizados do Amazon Pinpoint, como User.UserAttributes.LastName, são armazenados como uma lista, independentemente de haver um único item ou vários. Ao passar uma lista em um assistente que espera uma cadeia de caracteres, especifique o valor do índice do atributo junto com o nome do atributo. Esse valor de índice de atributo indica a posição de um valor na lista de atributos: .[0] para a primeira entrada na lista, .[1] para a segunda, .[2] para a terceira e assim por diante. Por exemplo, digamos que você esteja usando o assistente upper para converter a primeira entrada ([0]) de User.UserAttributes.LastName em maiúsculas. O uso do assistente é{{upper , e o atributo está formatado como value}}User.UserAttributes.LastName. valueSubstitua pelo nome do atributo e pelo valor do índice do atributo da seguinte forma:.[0]{{upper
User.UserAttributes.LastName.[0]}}. Em seguida, a resposta retorna a entrada [0] da lista, formatada em letras maiúsculas. Por exemplo, se o valor de [0] forSantos, a resposta será retornadaSANTOS.
Os nomes de atributos personalizados do Amazon Pinpoint oferecem suporte a espaços. Para ter um atributo personalizado chamado "Last Name", você precisa formatar o atributo como User.UserAttributes.[Last Name]. Para acessar a primeira entrada na lista de índices de atributos, o formato é User.UserAttributes.[Last
Name].[0].
Um nome de atributo personalizado pode conter até 50 caracteres. Um valor de atributo pode conter até 100 caracteres. Ao definir o nome de um atributo personalizado, evite usar os seguintes caracteres: sinal numérico (#), dois pontos (:), ponto de interrogação (?) , barra invertida (\) e barra (/). O console do Amazon Pinpoint não pode exibir nomes de atributos que contenham esses caracteres. Essa restrição não se aplica aos valores dos atributos.
Usar assistentes aninhados
Você pode agrupar vários assistentes de modelos de mensagens dentro uns dos outros. O exemplo a seguir mostra como formatar dois assistentes: {{ first helper (second helper)}}. O segundo assistente é processado primeiro, seguido pelo primeiro. Lembre-se de que o primeiro assistente sempre determina a saída. Os assistentes subsequentes devem estar aninhados no assistente anterior da seguinte forma: {{ first helper (second helper (third helper)
)}}.
O exemplo a seguir mostra como reunir dois assistentes para alterar JANE para Jane:{{capitalizeFirst
(lower ". JANE")}}lower primeiro converte JANE em jane. Em seguida, capitalizeFirst converte jane em Jane.