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 sur l'utilisateur, des détails d'idée ou des statistiques de collection, les variables de données permettent des mises à jour en temps réel et un contenu sur mesure.

Utilisation des 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 des collectes 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 tout le contenu de votre espace de travail dépendent grandement du contexte. Par exemple, dans les 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'examiner 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 un aperçu 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 généralement accéder à tout le reste dont vous avez besoin à partir de là.

Ceci 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 la portée.

Données liées à 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, Administrateur = 3000 et Propriétaire de l'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 révision, 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 « j'aime » de l'idée‍
• idea.stats.totalAvgRating: La note moyenne totale combinée 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 collection.
• ideaCollection.stats.ideas.total: Le nombre total d'idées soumises dans la collection.
• ideaCollection.status: Le statut actuel de la collection (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 nom 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 naviguer vers votre espace de travail. Si un sous-domaine personnalisé est défini, il correspondra à cette URL.

Utilisation des 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 collection.
• Dans l'étape d'action d'une automatisation : Utilisez par exemple {{ idea.owner.name }} pour utiliser le nom du créateur de l'idée ou {{ action.receiver.name }} pour écrire 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 nombre d'idées avec une solution de repli : {{ ideaCollection.stats.ideas.total != 0 ? ideaCollection.stats.ideas.total : "Aucune idée pour le moment" }}
• 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 visant à réduire les coûts

Question : Comment pourrions-nous réduire les coûts dans {{ sessionUser.country }} ?

Description : Bonjour {{ sessionUser.name }}, et bienvenue à notre importante campagne annuelle de réduction des coûts {{ workspace.name }} !

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

Vous pouvez toujours consulter le classement des idées de cette collection 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 maintenant le contenu dynamique.
• Évitez les valeurs vides : Lorsque vous utilisez des variables qui ne contiennent pas toujours de données (par exemple, des champs de formulaire personnalisés), incluez un texte de remplacement pour garantir une expérience fluide, par exemple : {{ idea.stats.comments > 0 ? idea.stats.comments + " commentaires" : "Aucun commentaire pour le moment" }}

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