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 : indique le rang de l’utilisateur sous forme de valeur numérique : 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 indiquant {{IF(sessionUser.rank > 1000, "Welcome")}}
• 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 cours d’examen, 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 reçus par une idée.‍
• 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 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 mentions J’aime de l’idée‍
• idea.stats.totalAvgRating : La note moyenne globale de l’idée‍
• idea.field.<UUID>.value : La valeur saisie par l’utilisateur pour le champ du formulaire correspondant à l’UUID. Si vous avez un champ intitulé « Coût estimé » avec l’UUID 123abc, vous pouvez utiliser {{ idea.field.123abc.value }} pour afficher la valeur saisie. Si vous avez un doute sur l’UUID et souhaitez vous en assurer, vous pouvez copier l’ID de n’importe quel champ d’idée lors de la modification 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 dans la collecte.
• ideaCollection.status : Le statut actuel de la collecte (par exemple : ACTIVE, ENDED.
• ideaCollection.url.full : L’URL complète de la collecte d’idées
• ideaCollection.friendlyId : Un identifiant court et simple, unique dans l’espace de travail, pour la collecte d’idées
• 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 la collecte d’idées.
• workspace.subdomain : La question directrice ou l’énoncé du défi de la collecte.
• workspace.url.full : L’URL complète du site Web permettant aux personnes d’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 des collectes 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 utiliser le nom de la personne à l’origine de l’idée, ou {{ action.receiver.name }} pour indiquer le nom de la personne qui reçoit 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 le nom de l’utilisateur en majuscules initiales : {{ CAPITALIZE(sessionUser.name) }}
• Afficher le nombre d’idées avec une valeur de remplacement : {{ ideaCollection.stats.ideas.total != 0 ? ideaCollection.stats.ideas.total : "No ideas yet" }}
• 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 réduire les coûts dans {{ sessionUser.country }} ?

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

Nous sommes impatients de découvrir vos idées créatives pour réduire les dépenses. À ce jour, nous avons recueilli ensemble {{ ideaCollection.stats.ideas.total }} idées — faites-vous aussi entendre !

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

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

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 ne contiennent pas toujours de données (par exemple, des champs de formulaire personnalisés), ajoutez un texte de remplacement afin de garantir une expérience fluide, par exemple : {{ idea.stats.comments > 0 ? idea.stats.comments + " comments" : "No comments yet" }}

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.