Introduction aux Expressions Dynamiques

Les Expressions Dynamiques vous permettent de créer du contenu personnalisé et axé sur les données dans votre espace de travail. En combinant des variables de données, des traductions personnalisées et des formules, vous pouvez rendre votre contenu plus dynamique et adapté à votre public.

Par exemple, vous pouvez afficher un message personnalisé en tapant :

"Bon retour, {{ sessionUser.name }}!"

Ceci insère le nom de l'utilisateur directement dans le message.

Afin que notre système puisse renseigner les données et de les différencier visuellement des autres contenus, les expressions dynamiques sont toujours encadrées par des doubles accolades : {{ ... }}.

Comment écrire votre première expression dynamique

1. Naviguez vers un champ de texte où les expressions sont autorisées (par exemple, une question de collecte d'idées).
2. Tapez { pour faire apparaître une liste des variables et fonctions disponibles.
3. Sélectionnez une suggestion ou écrivez votre propre expression.
4. Ajoutez des opérateurs et des fonctions au besoin.
5. Cliquez à l'extérieur pour voir votre expression dynamique en action.

De nombreux champs de texte calculeront et afficheront immédiatement le résultat de l'évaluation de toutes les expressions dynamiques qu'ils contiennent, par rapport à vous et à vos propres données, une fois qu'ils auront perdu le focus. Vérifiez si vous obtenez le résultat attendu. Et ne vous inquiétez pas, vous n'avez rien perdu de ce que vous avez écrit – si vous cliquez à nouveau sur le champ de texte, vous verrez vos expressions dynamiques réapparaître et pourrez continuer à les modifier.

Types d'expressions dynamiques

Les expressions dynamiques sont composées de différents éléments qui travaillent ensemble pour afficher des résultats personnalisés ou calculés.

Variables de données

Les variables de données représentent des données spécifiques à votre espace de travail, telles que les noms d'utilisateur, le nombre d'idées ou les valeurs de formulaire.

• Exemple : {{sessionUser.name}} peut s’afficher sous la forme « John Doe ».

Variables de traduction personnalisées

Les variables de traduction personnalisées sont des clés de localisation personnalisables que vous pouvez créer et utiliser sur votre plateforme pour afficher votre contenu dans différentes langues. Lorsqu'elles sont utilisées, en fonction de la langue que l'utilisateur a définie dans son profil, elles afficheront le contenu dans la langue de l'utilisateur si vous avez défini une traduction pour cette langue.

• Exemple : {{translate:custom.greeting}} affiche une version localisée de votre texte de salutation.

Fonctions

Les fonctions effectuent des actions comme la transformation de données ou la réalisation de calculs. Dans la liste, elles affichent la signature des arguments à leur passer, ainsi que leurs types de données attendus. Ensuite, elles présentent une description de ce que fait la fonction, ainsi qu'un exemple de la façon dont vous pouvez l'utiliser.

• Exemple : {{ UPPERCASE(sessionUser.name) }} convertit le nom d’un utilisateur en majuscules.

Opérateurs

Les opérateurs sont utilisés pour les calculs et les comparaisons.

• Arithmétiques : +, -, *, /
• Logiques : && (ET), || (OU)
• De comparaison : ==, !=, >, <
• Conditionnel : ?
• Exemple : {{ sessionUser.stats.likes > 10 ? "Top Contributor" : "Newbie" }} affiche « Top Contributor » si le nombre de mentions « J’aime » dépasse 10, sinon « Newbie ».

Littéraux

Les littéraux ou "valeurs brutes", tels que les nombres, le texte ou les booléens, peuvent également être utilisés librement dans les expressions dynamiques.

• Exemple : {{ 5 }} ou {{ "Hello, world!" }} ou {{ true }}

Gestion des erreurs

Parce que les expressions dynamiques sont très flexibles et vous offrent beaucoup de liberté, elles peuvent aussi facilement échouer, et parfois d'une manière que vous n'anticipez pas. Par exemple, vous pourriez :

• Diviser un nombre par zéro.
• Oublier une parenthèse fermante quelque part dans votre expression.
• Référencer une variable de traduction personnalisée inexistante (ou supprimée).
• Tenter par erreur de mettre en majuscules un non-texte, comme un nombre.

Heureusement, si vous vous retrouvez dans de telles situations, les expressions dynamiques qui n'ont pas pu être calculées correctement sont facilement reconnaissables et vous montreront exactement où et quel était le problème, lorsque vous les survolerez.

Voici quelques points à considérer lorsque vous écrivez des expressions dynamiques pour réduire la probabilité de rencontrer des erreurs :

• Assurez-vous de compter le nombre de parenthèses que vous utilisez, surtout lorsque vous combinez plusieurs fonctions.
• Lorsque vous effectuez une division, et en particulier lorsque le diviseur dépend d’une variable de données, veillez à prendre en compte les cas où le diviseur peut être égal à zéro. Vous pouvez utiliser la fonction MAX() pour vous assurer que la valeur ne descend jamais en dessous de 1. Par exemple, imposez une valeur minimale de 1 ainsi : {{ 2 / MAX(sessionUser.stats.likes, 1) }}.

Assurez-vous de vérifier à nouveau les types d'arguments attendus par les fonctions que vous utilisez, ainsi que l'ordre dans lequel elles les attendent.

Par exemple, {{ UPPERCASE(2) }} échouera, car UPPERCASE() attend du texte, mais a reçu un nombre.

Exemples simples d'expressions dynamiques

• Calcul simple : {{ 2 + 3 }} affiche 5.
• Message personnalisé : Bonjour {{sessionUser.name }} affiche une salutation personnalisée.
• Affichage conditionnel : {{ ideaCollection.stats.ideas.total > 50 ? "We've reached our goal!" : "Needs more ideas!" }} s’adapte en fonction de l’engagement suscité par l’idée.

En combinant ces éléments, vous pouvez créer des expériences puissantes et personnalisées pour les utilisateurs de votre espace de travail.