Utilisation de variables (balise SG:VAR)
Vous pouvez rendre le contenu du bloc de contenu dépendant d'une variable. Les variables sont définies dans les templates et ajoutent de la flexibilité lorsqu'un template est utilisé dans un Journey. En définissant les valeurs des variables, vous pouvez influencer l'aspect final du contenu.
Exemple : vous souhaitez créer un bouton multifonctionnel qui vous permet d'ajuster sa taille et son alignement. Pour ce faire, vous créez un bloc de contenu pour le bouton et définissez deux variables, par exemple :
- Couleur
- Alignement
Lorsque vous utilisez le template, vous remplissez ces variables pour contrôler la façon dont le bouton s'affiche.
Variables de template
Une variable de template existe au niveau du template. Lorsque vous utilisez une variable de template dans un bloc de contenu, la valeur sélectionnée pour cette variable s'applique à tous les blocs de contenu du template qui utilisent la même variable.
Pour utiliser une variable de template existante dans le bloc de contenu, la syntaxe suivante est utilisée.
[%[VARIABLE.Name]%]
Tout le contenu placé entre ces balises <sg:conditional> dépend de la valeur que vous avez définie pour la variable.
Variables locales
Les variables locales sont définies et utilisées au sein même du bloc de contenu. Vous pouvez utiliser une variable locale lorsqu'elle n'existe pas encore dans le template.
Définir une variable locale
Utilisez la syntaxe SG ci-après :
<sg:var name="" type="" value="" alias="" description="" />Vous pouvez définir les propriétés suivantes des variables :
- Nom — Nom interne de la variable.
- Type — Détermine la valeur attendue et la manière dont elle s'affiche dans l'interface :
- Text : champ de texte
- Color : sélecteur de couleurs
- Boolean : case à cocher
- Valeur par défaut (facultatif) — Appliquée automatiquement lorsque la variable est utilisée.
- Alias (facultatif) — Nom affiché dans les propriétés du bloc de contenu. S'il n'est pas fourni, le nom de la variable est utilisé.
- Description (facultatif) — Texte d'aide affiché sous le champ de la variable dans les propriétés du bloc de contenu.
Exemples de types de variables
<sg:var name="MyText" type="Text" value="mytext" alias="my_alias" description="my_description" />
<sg:var name="Mycolor" type="Color" value="#0000FF" alias="my_alias" description="my_description" />
<sg:var name="MyName" type="Number" value="75" alias="my_alias" description="my_description" />
<sg:var name="MyBoolean" type="Boolean" value="TRUE" alias="my_alias" description="my_description" />
<sg:var name="MyDecimal" type="Decimal" value="0,01" alias="my_alias" description="my_description" />
<sg:var name="MyDateTime" type="Datetime" value="2019-10-17 10:00" alias="my_alias" description="my_description" />
<sg:var name="MyDate" type="Date" value="2019-10-17" alias="my_alias" description="my_description" />
<sg:var name="MyTime" type="Time" value="10:00" alias="my_alias" description="my_description" />
<sg:var name="My_image" type="image" value="" />
Affichage des variables dans l'interface
Lorsqu'un bloc de contenu contient des variables :
- Les variables booléennes s'affichent comme d'interrupteurs.
- Les variables de texte s'affichent comme des champs de texte.
- Les variables de couleur s'affichent comme des sélecteurs de couleur.
L'alias et la description aident les utilisateurs à comprendre comment configurer chaque variable.
Exemple :
À gauche, le bloc de contenu créé dans le chapitre Bibliothèque contient 3 variables de type booléen, texte et couleur.
À droite, lors de l'utilisation du bloc de contenu dans un message, la fenêtre des propriétés affiche les trois variables (booléen comme bascule, texte comme champ de texte, couleur comme sélecteur de couleur), avec leur alias et leur description. 
Définir plusieurs options de variables
Vous pouvez utiliser <sg:option> pour définir une liste de valeurs autorisées pour une variable.
<sg:var name="MyValues" type="text" value="option2">
<sg:option value="option1">Option 1</sg:option>
<sg:option value="option2">Option 2</sg:option>
</sg:var> Exemple 1 : sélection de couleurs basée sur une variable
Dans cet exemple, une variable « color » définit la couleur d'arrière-plan de l'en-tête d'un template :
- Le bloc de contenu contient une variable de couleur avec deux options possibles :
- Lorsque vous utilisez le bloc de contenu dans un template, la variable de couleur s'affiche dans ses propriétés.
- Vous pouvez alterner entre les deux options de couleur.
Avec le bloc de contenu dans un template, la variable de couleur est répertoriée dans les propriétés du composant du bloc de contenu. Les deux options de couleur s'affichent et peuvent être modifiées.
Dans la boîte de dialogue de style de l'en-tête du template, l'ajout de background-color: [nom de la variable de couleur] comme style personnalisé applique l'option sélectionnée de la variable de couleur sg:var dans le bloc de contenu comme couleur d'arrière-plan à l'en-tête du message (qui est actuellement violet).
Lorsque vous passez à l'autre option de couleur :
- La couleur de l'en-tête du template est mise à jour automatiquement.
- Chaque section du template qui utilise la variable est également mise à jour.
Example 2 : variable d'image
Vous pouvez ajouter une variable de type Image à un bloc de contenu et y faire référence dans une balise image. Lorsque vous utilisez le bloc de contenu dans un message, vous pouvez sélectionner une image pour cette variable.
Dans le message, une image peut être sélectionnée pour cette variable :
Remarque : les variables locales sont définies dans le bloc de contenu. Pour chaque instance du bloc de contenu ajoutée à un template, vous devez définir la valeur de la variable. Cela permet de réutiliser le même bloc de contenu plusieurs fois avec des apparences différentes.
Les variables de template sont définies une seule fois au niveau du modèle. La valeur sélectionnée s'applique à tous les blocs de contenu qui utilisent cette variable.