Introduction aux Expressions Dynamiques

Les Expressions Dynamiques vous permettent de créer du contenu personnalisé et basé 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 :

"Bienvenue de nouveau, {{ sessionUser.name }} !"

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

Pour permettre à notre système de remplir les données et pour les différencier visuellement des autres contenus, les Expressions Dynamiques sont toujours entre doubles accolades : {{ ... }}.

É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 de variables et de fonctions disponibles.
3. Sélectionnez une suggestion ou écrivez votre propre expression.
4. Ajoutez des opérateurs et des fonctions au besoin.
5. Cliquez en dehors 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, après qu'ils perdent 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 composants qui fonctionnent 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'utilisateurs, le nombre d'idées ou les valeurs de formulaire.

• Exemple : {{sessionUser.name}} pourrait s'afficher comme "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 visiteur 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 montreront une signature des arguments à leur passer, ainsi que leurs types de données attendus. Par exemple, la fonction UPPERCASE() s'attend à recevoir du texte. Ensuite, elles afficheront 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 contributeur" si les j'aime dépassent 10, sinon "Débutant."

Littéraux

Les Littéraux ou "valeurs brutes", tels que les nombres, le texte ou les booléens, peuvent également être librement utilisés à l'intérieur d'une Expression Dynamique.

• 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 de manières inattendues. Par exemple, vous pourriez vous retrouver à :

• 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 (non existante 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 éléments à prendre en compte 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 particulièrement lorsque le diviseur est basé sur une variable de données, assurez-vous de prendre en compte les cas où le diviseur peut être zéro. Vous pouvez utiliser la fonction MAX() pour vous assurer que la valeur ne descend jamais en dessous de 1. Par exemple, assurez un minimum de 1 comme suit : {{ 2 / MAX(sessionUser.stats.likes, 1) }}.

Assurez-vous de vérifier attentivement 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, puisque UPPERCASE() attendait 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 un message d'accueil personnalisé.
• Affichage Conditionnel : {{ ideaCollection.stats.ideas.total > 50 ? "We've reached our goal!" : "Needs more ideas!" }} s'adapte en fonction de l'engagement des idées.

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