Comment formater un champ de personnalisation d'une campagne email applicative ?

Introduction

Il est possible de formater un champ de personnalisation afin que ce dernier ait un rendu en sortie modifié. 

Pré-requis : avoir à disposition l'api omnicanal de configurée sur la NMP.

 

Formater un champ de personnalisation

Pour formater un champ de personnalisation, il est nécessaire d'appliquer la transformation souhaitée au sein du contenu email.

Le formatage d'un champ suit le principe suivant : 

  • MM:CHAMP|mafonctiondetransformation avec 
    • MM:CHAMP : le champ concerné par le formatage
    • | : le caractère à utiliser afin d'introduire l'utilisation d'une fonction de formatage
    • mafonctiondetransformation : la fonction de formatage à appliquer

Les formatages disponibles sont les suivants : 

Nom de la fonction Description

{{MM:CHAMP|urlencode}}

 Permet d'encoder une valeur, par exemple une url

{{MM:CHAMP|int}}

 Permet d'avoir un format en entier

{{MM:CHAMP|upper}}

 Permet d'avoir l'intégralité du texte en majuscules

{{MM:CHAMP|lower}}

 Permet d'avoir l'intégralité du texte en minuscules

{{MM:CHAMP|capitalize}}

 Permet d'avoir la première lettre en majuscule et le reste en minuscule (exemple : Bonjour à vous)

{{MM:CHAMP|title}}

 Permet d'avoir la première lettre en majuscule et le reste en minuscule pour chaque mot (exemple : Bonjour À Vous)

{{MM:CHAMP|datetimeformat(format="%Y/%m/%d à %H:%M:%S", tz="Europe/Paris")}}

A partir d’un format ISO (exemple :

2024-10-03T10:15:30+01:00 ou sans heures et minutes (exemple : 2011-12-03), être en capacité de définir en sortie le format de date souhaité. Tout autre format en entrée ne sera accepté. 

 

Chaque caractère mentionné dans la partie format permettra de venir sélectionner une information spécifique relatif à une date. Les correspondances sont les suivantes : 

- Y : l'année

- m : le mois

- d : le jour

- H : l'heure

- M : la minute

- S : la seconde

 

A noter les séparateurs / ou - sont à ajouter de manière indépendante au sein du formatage en fonction du besoin.

 

Exemples d'usage : 

- dd/mm --> {{MM:CHAMP|datetimeformat(format="%d/%m", tz="Europe/Paris")}}
- hh:mm --> {{MM:CHAMP|datetimeformat(format="%H:%M", tz="Europe/Paris")}}
- dd/mm/yyyy --> {{MM:CHAMP|datetimeformat(format="%d/%m/%Y", tz="Europe/Paris")}}
{{MM:CHAMP|humanduration}}

A partir d’une valeur en secondes avoir la capacité de la transformer en heure/minutes

Exemples de rendu : 

- 1800 → 30 min
- 3600 → 1h
- 4500 → 1h15 min

Pour information, il est possible d’adapter une unité de la minute vers la seconde par le moyen suivant : 

- définir une nouvelle variable en début de contenu qui fera levier sur celle envoyée : {% set MA_VARIABLE_SECONDES = MA_VARIABLE_MINUTES * 60 %} avec la variable en SECONDES étant la nouvelle et celle en MINUTES celle d'origine

- il ne vous restera plus qu'à utiliser la nouvelle variable dans votre contenu : {{MM:MA_VARIABLE_SECONDES|humanduration}} 

 

Conclusion

Le formatage de campagne permet de modifier une valeur d'un champ de personnalisation selon un format spécifique.