Utilisation des assistants de modèles de messages - Amazon Pinpoint

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation des assistants de modèles de messages

Avec les modèles Pinpoint, les clients peuvent créer des modèles de messages réutilisables basés sur le langage Handlebars.js. Les assistants fournissent diverses fonctionnalités, telles que le formatage d'un prix dans la devise d'une région spécifique ou l'ajout d'un lieu basé sur un fuseau horaire. Un assistant peut utiliser une chaîne ou un entier spécifique pour la valeur ou une variable de message Amazon Pinpoint spécifique.

Voici les catégories d'assistants, décrites dans les sections suivantes :

Cette section décritintégréaides fournies par Handlebars. Pour la liste complète, voirAssistants intégrésàhandlebarsjs.com. Voici les aides intégrées :

  • each— Itére une liste.

    Note

    La taille maximale de la liste est de 15 éléments.

  • if— Évalue une déclaration.

chaque

Itére une liste. Cet assistant utilise uniquement une instruction de blocage. Vous pouvez éventuellement

  • Passe@indexdans la demande de référence à l'indice de boucle actuel.

  • Utilisez lethisassistant pour référencer l'élément en cours d'itération.

  • Renvoie la réponse d'assistance sous forme de liste, en utilisant le<li>étiquette.

Utilisation

{{#each value}}

Valeur à la position{{@index}}est{{this}}.

{{else}}

La condition est fausse.

{{/each}}

eachdoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/each}}dans l'instruction du bloc.

Example (Exemple)

Dans cet exemple,eachest utilisé pour renvoyer une liste des couleurs préférées d'un utilisateur. Pour unfalse, uneelsele relevé est renvoyé. Si la demande est la suivante

{{#each User.UserAttributes.FavoriteColors}}

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

{{else}}

Tu n'as pas de couleurs préférées.

{{/each}} renvoie

  • red

  • bleu

  • jaune

pour une déclaration vraie.

if

Évalue si quelque chose est vrai et renvoie une réponse basée sur l'évaluation.

Utilisation

{{#if value}}

La valeur n'est pas indéfinie

{{else}}

La valeur n'est pas définie

{{/if}}

ifdoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/if}}dans l'instruction du bloc.

Example (Exemple)

Dans cet exemple, leifhelper est utilisé pour évaluer si le prénom d'un utilisateur est bien connu. Si le nom est trouvé, un message d'accueil est renvoyé qui transmet le prénom de l'utilisateur dans la réponse. Dans le cas contraire, leelsestatement renvoie un message d'accueil alternatif.

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

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

{{else}}

Bonjour,

{{/if}}

retoursBonjour, Janesi leifhelper est vrai.

Cette section décritconditionnelaides.

Les assistants conditionnels peuvent être utilisés sur une seule ligne ou dans une instruction de bloc. Vous pouvez personnaliser la réponse quelle que soit la méthode d'assistance que vous utilisez. Vous pouvez transmettre des aides conditionnelles supplémentaires dans les instructions sur une seule ligne et dans les instructions par blocs. Les assistants conditionnels suivants indiquent l'utilisation d'abord pour une seule ligne, puis pour une instruction de bloc à l'aide d'une instruction facultativeelseclause. Voici les aides conditionnelles :

  • and— Compare si tous les éléments transmis sont égaux ou non.

  • eq— Teste si deux éléments sont égaux.

  • gt— Teste si un élément est supérieur à un autre.

  • gte— Teste si un élément est supérieur ou égal à un autre.

  • if— Évalue si quelque chose est vrai.

  • lt— Teste si un élément est inférieur à un autre.

  • lte— Teste si un élément est inférieur ou égal à un autre.

  • neq— Évalue si deux éléments ne sont pas égaux.

  • not— Inverse la réponse d'une opération booléenne.

  • or— Compare si l'un des éléments de l'argument est égal.

and

Compare sitousles éléments passés dans un argument sont égaux, puis renvoie la réponse en fonction du résultat. Cet assistant peut être utilisé pour les valeurs non booléennes. Vous devez transmettre au moins deux éléments pour la condition.

Utilisation

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

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.

  • {{#and valuea valueb}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/and}}

    anddoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/and}}dans l'instruction du bloc.

Example (Exemple)

Dans cet exemple,eqest utilisé dans leandinstruction block pour déterminer si les deux chaînes sont passées pour leLocation.City etLocation.Countryles attributs sont vrais. Si les deux conditions sont égales, une déclaration vraie est renvoyée. Si l'un de ces attributs est faux, alorselsele relevé est renvoyé.

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

Vous vivez à Los Angeles et aux États-Unis.

{{else}}

Vous ne vivez pas à Los Angeles ou aux États-Unis.

{{/and}}

eq

Teste si deux éléments sont égaux ou si la valeur d'un élément est égale à une chaîne passée.

Utilisation

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

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.

  • {{#eq valuea valueb}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/eq}}

    eqdoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/eq}}dans l'instruction du bloc.

Example (Exemple)

Dans cet exemple,eqest utilisé pour évaluer si la valeur deUser.UserAttributes.FavoriteColors.[0]estrouge. Si la réponse esttrue, une déclaration vraie est renvoyée. Si la réponse estfalse, puis unelsele relevé est renvoyé.

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

Ta couleur préférée est le rouge.

{{else}}

Tu n'aimes pas le rouge.

{{/eq}}

gt

Teste si la valeur d'un élément est supérieure à celle d'un autre.

Utilisation

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

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.

  • {{#gt valuea valueb}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/gt}}

    gtdoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/gt}}dans l'instruction du bloc.

Example (Exemple)

Dans cet exemple, l'assistant compare la valeur deUser.UserAttributes.UserAge.[0]attribut par rapport à une chaîne,17, pour vérifier si l'âge de l'utilisateur est supérieur à 17 ans. Si la réponse esttrue, une déclaration vraie est renvoyée. Si la réponse estfalse, puis unelsele relevé est renvoyé.

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

Vous êtes assez âgé pour louer une voiture.

{{else}}

Vous n'êtes pas assez âgé pour louer une voiture.

{{/gt}}

gte

Teste si la valeur d'un élément est supérieure ou égale à celle d'un autre.

Usage

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

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.

  • {{#gte valuea valueb}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/gte}}

    getdoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/gte}}dans l'instruction du bloc.

Example (Exemple)

Dans cet exemple, l'assistant compare lesUser.UserAttributes.UserAge.[0]attribut par rapport à une chaîne,18, pour vérifier si l'âge de l'utilisateur est supérieur ou égal à 18 ans. Si la réponse esttrue, une déclaration vraie est renvoyée. Si la réponse estfalse, puis unelsele relevé est renvoyé.

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

Vous êtes assez âgé pour louer une voiture.

{{else}}

Vous n'êtes pas assez âgé pour louer une voiture.

{{/gte}}

if

Évalue si quelque chose est vrai et renvoie une réponse basée sur l'évaluation.

Utilisation

  • {{#if value}}

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.

  • {{#if value}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/if}}

    ifdoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/if}}dans l'instruction du bloc.

Example (Exemple)

Dans cet exemple, l'assistant if est utilisé pour évaluer si le prénom d'un utilisateur est le premier. Si le nom est trouvé, un message d'accueil est renvoyé qui transmet le prénom de l'utilisateur dans la réponse. Dans le cas contraire, l'instruction else renvoie un autre message d'accueil.

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

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

{{else}}

Bonjour,

{{/if}}

retoursBonjour Jane,si l'assistant if est vrai.

lt

Teste si la valeur d'un élément est inférieure à celle d'un autre.

Utilisation

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

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.

  • {{#lt valuea valueb}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/lt}}

    ltdoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/lt}}dans l'instruction du bloc.

Example (Exemple)

Dans cet exemple, l'assistant compare lesUser.UserAttributes.UserAge.[0]attribut par rapport à une chaîne,18, pour vérifier si l'utilisateur est âgé de moins de 18 ans. Si la réponse esttrue, une déclaration vraie est renvoyée. Si la réponse estfalse, puis unelsele relevé est renvoyé.

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

Vous n'êtes pas assez âgé pour louer une voiture.

{{else}}

Vous êtes assez âgé pour louer une voiture.

{{/lt}}

lte

Teste si la valeur d'un élément est inférieure ou égale à celle d'un autre.

Utilisation

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

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.

  • {{#lte valuea valueb}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/lte}}

    ltedoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/lte}}dans l'instruction du bloc.

Example (Exemple)

Dans cette instruction de bloc, l'assistant compareUser.UserAttributes.UserAge.[0]attribut par rapport à une chaîne,17, pour vérifier si l'âge de l'utilisateur est inférieur ou égal à 17 ans. Si la réponse esttrue, une déclaration vraie est renvoyée. Si la réponse estfalse, puis unelsele relevé est renvoyé.

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

Vous n'êtes pas assez âgé pour louer une voiture.

{{else}}

Vous êtes assez âgé pour louer une voiture.

{{/lte}}

neq

Vérifiez si deux éléments sontpaségal.

Utilisation

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

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.

  • {{#neq valuea valueb}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/neq}}

    neqdoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/neq}}dans l'instruction du bloc.

Example (Exemple)

Dans cette déclaration de bloc,User.UserAttributes.FavoriteColors.[0]l'attribut est vérifié par rapport à une chaîne,Red. Si la réponse esttrue, une déclaration vraie est renvoyée. Si la réponse estfalse, puis unelsele relevé est renvoyé.

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

Tu n'aimes pas le rouge.

{{else}}

Tu aimes le rouge.

{{/neq}}

pas

Inverse la réponse d'une opération booléenne, de sorte que sinotest une comparaison positive, puis untruele relevé est renvoyé. Si la réponse est fausse, une instruction else est renvoyée.

Utilisation

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

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition.

  • {{#not value}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/not}}

    notdoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/not}}dans l'instruction du bloc.

Example (Exemple)

Dans cette déclaration de bloc,User.UerAttributes.FavoriteColors.[0]l'attribut est vérifié par rapport à une chaîne,rouge, en utilisant leeqassistant. Lenothelper renvoie alors le contraire deeqassistant. Si la réponse renvoie une couleur autre querouge, untrueun relevé est renvoyé. Si la réponse est renvoyéerouge, puis unelseune déclaration est renvoyée indiquant une fausse déclaration.

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

Tu n'aimes pas le rouge.

{{else}}

Tu aimes le rouge.

{{/not}}

Example (Exemple)

Dans cet exemple,

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

renvoie faux siUser.UserAttributes.FavoriteColors.[0]estrouge.

or

Compare sin'importe queldes éléments de l'argument sont égaux, puis renvoie une réponse basée sur le résultat. Cet assistant peut être utilisé pour les valeurs non booléennes.

Utilisation

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

    Vous pouvez remplaceryetnavec d'autres valeurs, telles queouietnon, ou toute autre chaîne que vous souhaitez renvoyer, en fonction de la condition. Vous devez transmettre au moins deux éléments pour la condition.

  • {{#or valuea valueb}}

    La condition est vraie.

    {{else}}

    La condition est fausse.

    {{/or}}

    ordoit être préfacé d'un signe de livre (#) et se terminent par une clôture{{/or}}dans l'instruction du bloc.

Example (Exemple)

Dans ceorinstruction de bloc, deux chaînes pour leLocation.Cityles attributs sont comparés en plus à l'aide dueqassistant. Si l'un des attributs esttrue, puis une déclaration vraie est renvoyée. Si une ou plusieurs des réponses sontfalse, puis unelsele relevé est renvoyé.

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

Vous vivez sur la côte ouest des États-Unis.

{{else}}

Vous ne vivez pas sur la côte ouest des États-Unis.

{{/or}}

Cette section décrit les points suivantschaîneassistants :

  • abbreviate— Tronque une valeur.

  • capitalize— Met en majuscule chaque mot entre des espaces blancs.

  • capitalizeFirst— Met en majuscule le premier caractère d'une valeur.

  • center— Centre une valeur.

  • cut— Supprime une valeur.

  • dateFormat— Définit le style de date.

  • inflect— Renvoie une chaîne au singulier ou au pluriel en fonction du nombre.

  • join— Joint un tableau, un itérateur ou un objet itérable.

  • ljust— Justifie une valeur dans la marge de gauche.

  • lower— Convertit une valeur en minuscules.

  • now— Imprime la date du jour.

  • ordinalize— Ordinalise une valeur numérique.

  • replace— Remplace une chaîne par une autre.

  • rjust— Justifie une valeur par la marge droite.

  • slugify— Convertit une valeur en minuscules et supprime les caractères autres que des mots, convertit les espaces en tirets et supprime les espaces blancs de fin.

  • stripTags— Supprime les balises HTML [X] d'une valeur.

  • substring— Renvoie une nouvelle chaîne sous forme de sous-chaîne d'une valeur transmise.

  • upper— Convertit la valeur transmise en majuscules.

  • yesno— Remplace le vrai, le faux et le non par « Oui », « Non » et « Peut-être ».

abréger

Tronque une valeur si celle-ci dépasse le nombre spécifié. Les espaces blancs sont inclus dans le décompte des longueurs. Une ellipse apparaît dans la réponse pour indiquer une valeur tronquée. Les points de suspension sont pris en compte dans la valeur tronquée de la réponse. Ce type d'assistant est utile si vous avez une grande table et un espace minimal. Le fait de tronquer les valeurs d'une cellule permet d'uniformiser l'apparence du tableau.

Utilisation

{{abbreviate value X}}, remplaçantXavec une valeur numérique indiquant le nombre de caractères à conserver. Les nombres négatifs ne sont pas pris en charge.

Example (Exemple)

Dans cet exemple,abbreviateest utilisé pour tronquerUser.UserAttributes.LastName.[0]jusqu'à six (6) caractères. La réponse comprend des points de suspension, dont les points sont pris en compte dans le total des six caractères.

{{abbreviate User.UserAttributes.LastName.[0] 6}} renvoie

Bière...siAlejandroest la valeur de[0].

capitaliser

Met en majuscule chaque mot entre des espaces blancs.

Utilisation

{{capitalize value}}

Example (Exemple)

Dans cet exemple, la capitalisation initiale est appliquée à chaque mot pour leAttributes.description.[0]entrée.

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

SiAttributes.description.[0]retours

Mon premier post, si la valeur deAttributes.description.[0]estmon premier post.

Capitaliser d'abord

Met en majuscule le premier caractère d'une valeur.

Utilisation

{{capitalizeFirst value}}

Example (Exemple)

Dans cet exemple, la mise en majuscule est appliquée au premier caractère du premier mot duAttributes.description.[0]entrée.

{{capitalizeFirst Attributes.description.[0]}} renvoie

Mon premier post, si la valeur deAttributes.description.[0]estmon premier post.

Example (Exemple)

centre

Centre la valeur dans un champ d'une largeur donnée par le nombre spécifié. Vous pouvez éventuellement transmettre un caractère à afficher pour le rembourrage ou laisser le champ vide. Si aucun caractère n'est transmis, un espace blanc est utilisé.

Utilisation

{{center value size=X [pad=" "}}, remplaçantXavec une valeur numérique.

Sipadest laissé en blanc, un espace blanc est utilisé comme rembourrage dans la réponse. Si vous transmettez un caractère, celui-ci apparaît dans chaque espace du rembourrage. Les nombres négatifs ne sont pas pris en charge.

Example (Exemple)

Dans cet exemple, la valeur deLocation.City est centré avec une taille de19.

{{center Location.City size=19}} renvoie

« Los Angeles »SiLocation.CityestLos Angeles. Notez que les guillemets affichés dans l'exemple de sortie ne sont fournis qu'à titre d'accentuation.

coupe

Supprime la valeur spécifiée d'une chaîne.

Utilisation

{{cut value [" "]}}, en remplaçant l'espace dans le paramètre entre guillemets par la valeur à couper. Si aucune valeur de paramètre n'est transmise, un espace blanc est utilisé.

Example (Exemple)

Cet exemple supprime la lettreeà partir duLocation.Cityattribut.

{{cut Location.City "e"}} renvoie

Los Angelssi[Location.CityestLos Angeles.

Format de date

Définit le style de date par défaut pour la date dans n'importe quelle réponse. Pour obtenir la liste des identifiants de fuseaux horaires, voirhttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

Utilisation

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

Leformatle paramètre doit être l'un des suivants :

  • «full« : format de date complet. Par exemple :le mardi 19 septembre 2020

  • «long« : format de date long. Par exemple :19 septembre 2020

  • «medium« : format de date moyen. Par exemple :19 septembre 2020

  • «short« : format de date court. Par exemple :19/09/2020

  • «pattern« : utilise un format de modèle de date personnalisé. Pour plus d'informations sur les modèles de dates, voirhttps://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.

«locale« : utilise un format de date basé sur une localisation donnée. Pour plus d'informations sur les paramètres régionaux, voirhttps://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-.

Si un format n'est pas transmis, alorsmediumest utilisé par défaut.

Example (Exemple)

Dans cet exemple, le[0]entrée pourUser.UserAttributes.StartDate.[0]est09/19/2020et un message est envoyé à un utilisateur à l'aide dufullformat de date basé surAmérique/Los_Angelesfuseau horaire.

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

Nous pouvons vous rencontrer à tout moment le mardi 19 septembre 2020.

infléchir

Renvoie une chaîne au singulier ou au pluriel en fonction de la valeur du décompte.

Utilisation

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

  • Entrez les formes singulière et plurielle de la chaîne que vous souhaitez transmettre dans l'argument.

  • SiincludeCountest défini surfalse, aucun nombre n'est renvoyé dans la réponse. S'il est réglé surtrue, lecountest inclus dans la réponse.

Example (Exemple)

Les exemples suivants montrent l'inflexion d'un achat de pommes, avec ou sansincludeCount.

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

Merci pour votre achat de pommes.

SiincludeCountest défini surtrue, alors la réponse est

Merci pour votre achat de 3 pommes.

join

Joint un tableau, un itérateur ou un objet itérable. La réponse renvoie une liste, chaque valeur de la liste étant concaténée par le caractère que vous avez passé dans lejoin. Par exemple, vous pouvez séparer les valeurs à l'aide d'une virgule (,). La valeur de cet assistant doit être une liste sans indice de position d'attribut. Par exemple, cela peut êtreAttributes.custom_attribute.

Utilisation

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

Example (Exemple)

Dans cet exemple, une liste de couleurs est renvoyée, séparée par une virgule et un espace (", ") :

{{join Attributes.favorite_colors ", "}} renvoie

bleu, rouge, vertsiAttributes.favorite_colorsest la listebleu, rouge, vert.

ljust

Justifie la valeur dans la marge de gauche et ajoute de l'espace sur la droite pour que la longueur de la valeur corresponde au nombre. Les nombres négatifs ne sont pas pris en charge.

Vous pouvez éventuellement transmettre un caractère à afficher pourpadou laissez le champ vide. Si vous quittez lepadvaleur vide, la valeur par défaut est un espace blanc.

Utilisation

{{ljust value size=X [pad=" "]}}, oùXest la longueur totale de la valeur, espaces blancs compris.

Example (Exemple)

Dans cet exemple, une valeur de justification gauche de15est appliqué à Location.City.

{{ljust Location.City size=15}} renvoie

« Los Angeles »si la valeur deLocation.CityestLos Angeles. Notez que les guillemets affichés dans l'exemple de sortie ne sont fournis qu'à titre d'accentuation.

lower

Convertit une valeur en minuscules.

Utilisation

{{lower value}}

Example (Exemple)

Dans cet exemple, le[0] entrée pourUser.UserAttributes.LastName.[0]est remplacé par des minuscules.

{{lower User.UserAttributes.LastName.[0]}} renvoie

santossiSantosest la valeur de[0].

maintenant

Imprime la date actuelle en fonction de l'ID de fuseau horaire passé. Pour obtenir la liste des identifiants de fuseaux horaires, voirhttps://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

Utilisation

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

Leformatle paramètre doit être l'un des suivants :

  • «full« : format de date complet. Par exemple :le mardi 19 septembre 2020

  • «long« : format de date long. Par exemple :19 septembre 2020

  • «medium« : format de date moyen. Par exemple : 19 septembre 2020

  • «short« : format de date court. Par exemple : 19/09/20

  • «pattern« : un modèle de date. Pour plus d'informations sur les modèles de dates, voirhttps://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.

«locale« : utilise un format de date basé sur une localisation donnée. Pour plus d'informations sur les paramètres régionaux, voirhttps://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-.

Si un format n'est pas transmis, alorsmediumest utilisé par défaut.

Example (Exemple)

Dans cet exemple, la date actuelle à Los Angeles est renvoyée avec unmediumformat.

{{now "medium" tz=America/Los_Angeles}} renvoie

19 septembre 2020.

ordinaliser

Ordinalise la valeur numérique transmise dans l'argument. Par exemple,1est ordinalisé comme1er,2comme2e, etc. Seules les valeurs numériques sont prises en charge.

Utilisation

{{ordinalize [number]}}

Example (Exemple)

Dans cet exemple, le[0]entrée deUser.UserAttributes.UserAgeest ordinalisé et renvoyé, accompagné d'un message.

Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!retours22ordinalisé comme22e.

Félicitations pour ton 22e anniversaire !

replace

Remplace une chaîne par une autre. Une chaîne ou une valeur numérique doit être littérale. Les caractères génériques ne sont pas pris en charge.

Utilisation

{{replace stringToReplace replacementValue}}

Example (Exemple)

Dans cet exemple, un trait de soulignement (_) remplace un espace blanc.

{{replace Location.City " " "_"}} renvoie

Los Angelessi leLocation.City estLos Angeles.

rouille

Justifie la valeur par la marge de droite et ajoute de l'espace vers la gauche pour que la longueur de la valeur corresponde au nombre. Les nombres négatifs ne sont pas pris en charge.

Vous pouvez éventuellement transmettre un caractère à afficher pourpadou laissez le champ vide. Si vous conservez lepadvaleur vide, la valeur par défaut est un espace blanc.

Utilisation

{{rjust value size=X [pad=" "]}}, oùXest la longueur totale de la valeur, espaces blancs compris.

Example (Exemple)

Dans cet exemple, une valeur de justification correcte de15est appliqué auLocation.Cityattribut.

{{rjust Location.City size=15}} renvoie

« Los Angeles ». si leLocation.CityestLos Angeles. Notez que les guillemets affichés dans la sortie ne sont fournis qu'à titre d'accentuation.

se solidifier

Convertit la valeur transmise en minuscules, supprime les caractères autres que les mots (alphanumériques et traits de soulignement), convertit les espaces en tirets et supprime tout espace blanc de début ou de fin.

Utilisation

{{slugify value}}

Example (Exemple)

Dans cet exemple, slugify est effectué pour leLocation.Cityattribut.

{{slugify Location.City}} renvoie

los-angelessiLocation.CityestLos Angeles.

Étiquettes à bande

Supprime les balises HTML [X] d'une valeur.

Utilisation

{{stripTags value}}

Example (Exemple)

Dans cet exemple, les balises HTML pour l'utilisateur.UserAttributes.interest. [0] sont supprimés.

{{stripTags User.UserAttributes.interests.[0]}} renvoie

Art, siUser.UserAttributes.interests.[0]est<h1>Art</h1>.

substring

Renvoie une nouvelle chaîne sous forme de sous-chaîne de la valeur transmise. La longueur et la position sont déterminées par lestartOffsetetendOffsetparamètres, qui doivent être des entiers. Les nombres négatifs ne sont pas pris en charge. Si unendOffsetn'est pas transmise, la sous-chaîne utilise la valeur de fin d'origine de la chaîne.

Utilisation

{{substring value startOffset [endOffset]}}

Example (Exemple)

Dans cet exemple, un décalage de 4 et un endOffset de 9 sont appliqués à l'attribut Location.City.

{{substring Location.City 4 9}} retours

Angelsi Los Angeles est la valeur deLocation.CityestLos Angeles.

upper

Convertit la valeur transmise en majuscules.

Utilisation

{{upper value}}

Example (Exemple)

Dans cet exemple, le[0] entrée pour leUser.UserAttributes.LastNamel'attribut est converti en majuscules.

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

CHEVREUILsi leUser.UserAttributes.LastName.[0]la valeur estCorbeau.

oui/non

Remplacetrue,false, etNULLavecYes,No, etMaybe.

Utilisation

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

Example (Exemple)

Dans cet exemple, leIsUserSubscribedL'attribut indique si un utilisateur est abonné à une liste particulière.

{{yesno Attributes.IsUserSubscribed}} renvoie

ouisiAttributes.IsUserSubscribedestvrai.

Cette section décritmathématiques et encodageaides.

  • add— Renvoie la somme de deux nombres.

  • ceiling— Arrondit un entier à son plafond mathématique.

  • decode64— Décode une valeur codée en Base64 en chaîne.

  • divide— Renvoie le quotient de deux nombres.

  • encode64— Encode une chaîne en utilisant Base64.

  • floor— Arrondit un entier à son plancher mathématique.

  • md5— Hache une chaîne transmise à l'aide de l'algorithme MD5.

  • modulo— Renvoie le reste des deux nombres en utilisant des virgules flottantes.

  • multiply— Renvoie le produit de deux nombres.

  • round— Arrondit un nombre décimal au nombre entier le plus proche.

  • sha256— Hache une chaîne transmise en utilisant SHA-256.

  • sha512— Hache une chaîne transmise en utilisant SHA-512.

  • subtract— Renvoie la différence de deux nombres.

  • uuid— Génère aléatoirement un UUID au format 128 bits.

ajouter

Renvoie la somme de deux nombres avec des virgules flottantes.

Utilisation

{{add arg1 arg2}}

Example (Exemple)

{{add 5 2.3}} retours

7.3

plafond

Arrondit un entier à son plafond mathématique, qui est le nombre entier le plus élevé le plus proche de la valeur transmise.

Utilisation

{{ceiling value}}

Example (Exemple)

{{ceiling 5.23}} renvoie

6

décode64

Décode une valeur codée en Base64 en chaîne.

Utilisation

{{decode64 "string"}}

Example (Exemple)

{{decode64 "SGVsbG8gd29ybGQ="}} renvoie

Hello World

diviser

Renvoie le quotient de deux nombres, virgules flottantes comprises.

Utilisation

{{divide arg1 arg2}}

Example (Exemple)

{{divide 5 2.3}} renvoie

2,17391304

encoder 64

Encode la chaîne transmise dans l'argument à l'aide de Base64.

Utilisation

{{encode64 "string"}}

Example (Exemple)

{{encode64 "Hello World"}}

sGvSBG8GD29yBgQ=

floor

Arrondit un entier à son plancher mathématique, qui est le plus petit nombre entier le plus proche de la valeur transmise.

Utilisation

{{floor value}}

Example (Exemple)

{{floor 5.23}} renvoie

5

md5

Hache une chaîne transmise à l'aide de l'algorithme MD5.

Utilisation

{{md5 "string"}}

Example (Exemple)

{{md5 "Hello World"}}

3e25960a79dbc69b674cd4ec67a72c62

modulo

Renvoie le reste des deux nombres en utilisant des virgules flottantes.

Utilisation

{{modulo arg1 arg2}}

Example (Exemple)

{{modulo 7 2}} renvoie

1

multiplier

Renvoie le produit de deux nombres, avec les virgules flottantes éventuelles.

Utilisation

{{multiply arg1 arg2}}

Example (Exemple)

{{multiply 5 2.3}} renvoie

11.5

round

Arrondit une décimale vers le haut ou vers le bas au nombre entier le plus proche.

Utilisation

{{round value}}

Example (Exemple)

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

Vous avez passé en moyenne 19 minutes par jour sur notre site Web.

sha256

Hache une chaîne transmise à l'aide de la sécurité cryptographique SHA-256.

Utilisation

{{sha256 "string"}}

Example (Exemple)

{{sha256 "Hello World"}} renvoie

a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e

sha512

Hache une chaîne transmise à l'aide de la sécurité cryptographique SHA-512.

Utilisation

{{sha512 "string"}}

Example (Exemple)

{{sha512 "Hello World"}} renvoie

2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0da0daa8f51671064615d645ae27acb15bfb1447f459b

soustraire

Renvoie la différence de deux nombres, avec des virgules flottantes éventuelles.

Utilisation

{{subtract arg1 arg2}}

Example (Exemple)

{{subtract 5 2.3}} renvoie

2,7

uuid

Génère aléatoirement un UUID dans un format standard de 128 bits. Aucune valeur ne doit être transmise dans l'argument.

Utilisation

{{uuid}}

Example (Exemple)

{{uuid}} renvoie

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

Bien qu'ils ne soient techniquement pas utiles, les partiels intégrés sont un moyen utilisé par Handlebar pour simplifier les modèles qui incluent des chaînes répétées, afin de faciliter leur réutilisation. Pour plus d'informations, voirPartiels en ligneàhandlebarsjs.com.

Utilisation

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

Pour référencer le contenu du partiel en ligne ailleurs, utilisez :

{{> inlineName}}

Example (Exemple)

L'exemple suivant crée un extrait intégré qui inclut le prénom du destinataire et, s'il est disponible, son nom de famille, en ajoutant le code suivant au début du modèle :

{{#* inline "fullName"}}

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

{{/inline}}

Après avoir créé lefullNamepartiel, vous pouvez l'inclure n'importe où dans votre modèle en faisant précéder le nom du partiel d'un>symbole (supérieur à), suivi d'un espace, comme dans l'exemple suivant :{{> fullName}}.

Hello {{> fullName}}

renvoie le prénom et le nom de famille de l'utilisateur s'ils sont vrais, par exemple,Bonjour Jane Doe. Sinon, si aucun nom de famille n'est trouvé,Bonjour Janeest renvoyé.

Le guidon inclut des fonctionnalités supplémentaires en plus de celles décrites ici. Pour plus d'informations, voirhandlebarsjs.com.

Utilisation de variables avec des assistants de modèles de messages

Les attributs personnalisés d'Amazon Pinpoint, tels queUser.UserAttributes.LastName, sont stockés sous forme de liste, qu'il s'agisse d'un ou de plusieurs éléments. Lorsque vous transmettez une liste dans un assistant qui attend une chaîne, vous devez spécifier la valeur de l'index d'attribut ainsi que le nom de l'attribut. Cette valeur d'index d'attribut indique la position d'une valeur dans la liste d'attributs :.[0]pour la première entrée de la liste,.[1]pour le second,.[2]pour le troisième, et ainsi de suite. Supposons, par exemple, que vous utilisiez leupperassistant pour convertir le premier ([0]) entrée deUser.UserAttributes.LastNameà toutes les majuscules. L'utilisation de l'assistant est{{upper value}}, et l'attribut formaté commeUser.UserAttributes.LastName. Remplacervaleuravec le nom de l'attribut et la valeur de l'index de l'attribut.[0]comme suit :{{upper User.UserAttributes.LastName.[0]}}. La réponse renvoie ensuite le[0]entrée de la liste, mise en forme entièrement en majuscules. Par exemple, si la valeur de[0]estSantos, la réponse renvoieSANTOS.

Les noms des attributs personnalisés Amazon Pinpoint prennent en charge les espaces. Pour avoir un attribut personnalisé appelé"Last Name"vous devez formater l'attribut commeUser.UserAttributes.[Last Name]. Pour accéder à la première entrée de la liste d'index d'attributs, le format estUser.UserAttributes.[Last Name].[0].

Un nom d'attribut personnalisé peut contenir jusqu'à 50 caractères. Une valeur d'attribut peut contenir jusqu'à 100 caractères. Lorsque vous définissez le nom d'un attribut personnalisé, évitez d'utiliser les caractères suivants : signe numérique (#), deux-points (:), point d'interrogation (?) , barre oblique inverse (\) et barre oblique (/). La console Amazon Pinpoint ne peut pas afficher les noms d'attributs contenant ces caractères. Cette restriction ne s'applique pas aux valeurs d'attribut.

Utilisation d'aides imbriquées

Vous pouvez imbriquer plusieurs modèles de messages d'assistance les uns dans les autres. L'exemple suivant montre comment formater deux assistants :{{ first helper (second helper)}}. Le second assistant est traité en premier, suivi du premier assistant. N'oubliez pas que le premier assistant détermine toujours la sortie. Les assistants suivants doivent être imbriqués dans l'assistant précédent comme suit :{{ first helper (second helper (third helper) )}}.

L'exemple suivant montre comment imbriquer deux assistants pour changerJANEpourJane:{{capitalizeFirst (lower "JANE")}}.lowerpremiers convertisJANEpourjane. PuiscapitalizeFirstconvertitjanepourJane.