Variables de données

Les variables de données vous permettent de référencer et d'afficher dynamiquement des données spécifiques à l'espace de travail, rendant votre contenu plus pertinent et personnalisé pour les utilisateurs. Que vous affichiez des informations utilisateur, des détails d'idée ou des statistiques de collecte, les variables de données permettent des mises à jour en temps réel et un contenu adapté.

Utiliser les Variables de Données

Les variables de données peuvent être insérées dans les champs de texte de votre espace de travail, tels que les descriptions de formulaires, les détails de collecte d'idées et les messages d'automatisation. Ces variables extraient et affichent automatiquement les données pertinentes lorsque le contenu est rendu.

• Exemple : {{ sessionUser.name }} affiche le nom de l'utilisateur actuel.
• Exemple : {{ ideaCollection.stats.ideas.total }} affiche le nombre total d'idées soumises dans la collecte d'idées actuelle.

Variables de Données Couramment Utilisées

Les types de variables de données que vous pouvez utiliser dans vos formules et qui sont accessibles dans le contenu de votre espace de travail dépendent fortement du contexte. Par exemple, au sein des automatisations, elles dépendent à la fois du type de déclencheur et du type d'action avec lesquels vous travaillez.

C'est pourquoi nous vous suggérons de toujours commencer par appuyer sur la touche { de votre clavier dans l'un de vos champs de texte, puis d'inspecter la liste des suggestions fournies. Les variables que vous y verrez seront celles que vous pourrez utiliser de manière fiable dans ce contexte. Voici une ventilation des principales catégories de variables de données que vous pouvez utiliser.

En règle générale, si vous êtes en train d'écrire une idée, la plupart des liaisons de données disponibles commenceront par « idea », et vous pourrez ensuite généralement atteindre tout ce dont vous avez besoin à partir de là.

Cela dit, voici une petite sélection d'exemples de liaisons prises en charge pour les idées et les collectes d'idées, pour vous aider à mieux comprendre l'étendue.

Données Relatives à l'Utilisateur

• sessionUser.name : Affiche le nom complet de l'utilisateur actuel.
• sessionUser.rank : Affiche le rang de l'utilisateur sous forme de valeur numérique, où Invité = 1000, Membre = 2000, et Admin = 3000 et Propriétaire d'espace de travail = 5000. Les valeurs numériques facilitent la création d'opérations de comparaison, par exemple en disant {{IF(sessionUser.rank > 1000, "Bienvenue")}}
• sessionUser.stats.ideas : Renvoie le nombre total d'idées soumises par l'utilisateur.

Données d'Idée

• idea.friendlyId : Un identifiant court et unique pour l'idée.
• idea.url.full : L'URL complète de l'idée.
• idea.status.title : Le statut actuel de l'idée (par exemple, En Revue, Approuvée, Retardée).
• ‍idea.phase.name : Le nom de la phase actuelle de l'idée (par exemple, Discussion Ouverte).‍
• idea.stats.comments : Le nombre de commentaires qu'une idée a reçus.‍
• idea.owner.name : Le nom de l'utilisateur qui a soumis l'idée.‍
• idea.status.title : Le titre du statut actuel de l'idée‍
• idea.submittedAt : L'horodatage de la création de l'idée‍
• idea.stats.comments : Le nombre de commentaires de l'idée‍
• idea.stats.likes.total : Le nombre total de likes de l'idée‍
• idea.stats.totalAvgRating : La moyenne totale combinée des évaluations de l'idée‍
• idea.field.<UUID>.value : La valeur soumise par l'utilisateur pour le champ de formulaire avec l'UUID correspondant. Si vous avez un champ pour "Coût Estimé" avec l'UUID 123abc, vous pouvez utiliser {{ idea.field.123abc.value }} pour afficher la valeur soumise. Si vous avez des doutes sur l'UUID et que vous voulez être sûr, vous pouvez copier l'ID de n'importe quel champ d'idée lors de l'édition de son formulaire.

Données de Collecte d'Idées

• ideaCollection.title : Le titre de la collecte d'idées.
• ideaCollection.question : La question directrice ou l'énoncé du défi de la collecte.
• ideaCollection.stats.ideas.total : Le nombre total d'idées soumises au sein de la collecte.
• ideaCollection.status : Le statut actuel de la collecte (par exemple, ACTIVE, TERMINÉE).
• ideaCollection.url.full : L'URL complète de la collecte d'idées
• ideaCollection.friendlyId : Un ID court et simple pour la collecte d'idées, unique au sein de l'espace de travail
• ideaCollection.goal.title : Le titre de l'objectif de la collecte d'idées
• ideaCollection.owner.name : Le nom de l'utilisateur qui a créé la collecte d'idées.

Données de l'Espace de Travail

• workspace.name : Le titre de l'espace de travail.
• workspace.subdomain : Le sous-domaine de l'espace de travail.
• workspace.url.full : L'URL complète du site web que les utilisateurs peuvent utiliser pour accéder à votre espace de travail. Si un sous-domaine personnalisé est défini, il correspondra à cette URL.

Utiliser les Variables de Données en Contexte

Les variables de données peuvent s'adapter en fonction de leur utilisation. Par exemple :

• Dans les Descriptions de Collecte d'Idées : Utilisez par exemple {{ ideaCollection.goal.title }} pour afficher le titre de l'objectif de la collecte.
• Dans l'Étape d'Action d'une Automatisation : Utilisez par exemple {{ idea.owner.name }} pour le nom du créateur de l'idée ou {{ action.receiver.name }} pour le nom de la personne recevant le message.
• Dans les Champs d'Idée : Lorsque vous référencez une valeur de champ antérieure dans un formulaire d'idée ou un champ d'idée à partir d'un formulaire de saisie de formulaire, vous pouvez utiliser {{context.field.<UUID>.value}} pour référencer une autre valeur de champ.

Formatage et Personnalisation

Les variables de données peuvent être combinées avec des fonctions et des opérateurs pour formater et personnaliser la sortie :

• Mettre en Majuscules le Nom de l'Utilisateur : {{ CAPITALIZE(sessionUser.name) }}
• Afficher le Compte d'Idées avec un Repli : {{ ideaCollection.stats.ideas.total != 0 ? ideaCollection.stats.ideas.total : "Aucune idée pour l'instant" }}
• Arrondir le Score d'Engagement Moyen de l'Utilisateur : {{ ROUND(sessionUser.stats.engagementScore) }}

Exemple de Titre et de Description pour une Collecte d'Idées d'Économie de Coûts

Question : Comment pourrions-nous économiser des coûts dans {{ sessionUser.country }} ?

Description : Bonjour {{ sessionUser.name }}, et bienvenue à notre importante campagne annuelle d'économie de coûts de {{ workspace.name }} !

Nous sommes ravis d'entendre vos idées créatives pour réduire les dépenses. Jusqu'à présent, nous avons collectivement recueilli {{ ideaCollection.stats.ideas.total }} idées — faites-vous entendre aussi !

Vous pouvez toujours consulter le classement des idées de cette collecte en visitant :

‍{{ ideaCollection.url.full }}/leaderboard.

Meilleures Pratiques pour les Variables de Données

• Utilisez des Étiquettes Descriptives : Assurez-vous que les noms de variables sont clairement référencés dans votre documentation pour éviter toute confusion.
• Testez le Contenu Dynamique : Prévisualisez les pages pour vous assurer que les variables de données affichent les informations attendues.
• Combinez avec des Variables de Traduction Personnalisées : Utilisez des variables dans les traductions pour assurer la localisation tout en gardant le contenu dynamique.
• Évitez les Valeurs Vides : Lorsque vous utilisez des variables qui peuvent ne pas toujours contenir de données (par exemple, les champs de formulaire personnalisés), incluez un texte de repli pour garantir une expérience fluide, par exemple : {{ idea.stats.comments > 0 ? idea.stats.comments + " commentaires" : "Aucun commentaire pour l'instant" }}

En tirant parti efficacement des variables de données, vous pouvez créer un contenu personnalisé et axé sur les données qui s'adapte aux entrées des utilisateurs et améliore l'expérience globale de l'espace de travail.