Utiliser les variables du tableau de bord

Une variable de tableau de bord regroupe un ensemble de champs afin que les utilisateurs puissent changer le champ qu'une visualisation affiche. Un auteur ajoute la variable à l'encodage d'une visualisation, telle que l'axe X d'un diagramme à barres, et la lie à un widget de contrôle. Lorsqu'un utilisateur sélectionne un champ différent dans le contrôle, chaque visualisation qui utilise la variable se met à jour pour afficher le champ sélectionné.

Les variables de tableau de bord permettent aux utilisateurs de répondre à leurs propres questions grâce à des interactions familières par pointer-cliquer, sans modifier le tableau de bord ni attendre qu'une query soit régénérée. Par exemple, un observateur peut basculer un graphique linéaire entre les **ventes** et les **transactions**, et le formatage se met à jour en conséquence.

L'ajout ou la suppression de plusieurs champs en une seule fois n'est pas encore pris en charge.

Choisissez entre une variable de tableau de bord et un paramètre

Les variables et les paramètres du tableau de bord rendent tous deux un tableau de bord interactif, mais ils fonctionnent à des couches différentes. Une variable de tableau de bord modifie le champ qu'une visualisation affiche au niveau du tableau de bord. Un paramètre substitue une valeur dans une query de dataset à l'exécution. Pour en savoir plus sur les parameters, consultez Travailler avec les parameters du tableau de bord.

Les variables de tableau de bord remplacent l'approche précédente consistant à utiliser la clause IDENTIFIER avec un parameter pour échanger des champs. Contrairement à IDENTIFIER, les variables de tableau de bord fonctionnent avec les vues de métriques et préservent le formatage sémantique attaché à chaque champ.

Créer une variable de tableau de bord

Vous devez disposer d'au moins l'autorisation CAN EDIT sur le tableau de bord brouillon. Vous créez une variable à partir d'un widget de filtre (contrôle) :

1. Sur le canevas du tableau de bord brouillon, cliquez sur Ajouter un filtre (champ/paramètre) et placez le widget de filtre sur la page.
2. Dans le panneau de configuration du widget, créez une variable et ajoutez les champs que vous souhaitez que les utilisateurs choisissent.
3. Pour chaque champ, spécifiez un transform et un nom d’affichage :
   • La transformation définit la manière dont le champ est agrégé ou compartimenté (par exemple, SUM pour une mesure ou DAILY pour une date). La transformation est définie dans le cadre de la variable et ne peut pas être remplacée là où la variable est utilisée.
   • Le nom d'affichage est l'étiquette affichée aux utilisateurs dans le contrôle.

Le premier champ dans la variable est la sélection default. Le widget de filtre que vous avez utilisé pour créer la variable devient un contrôle que les spectateurs utilisent pour changer de champ.

Types de champs et types d'échelle

Une variable peut contenir des champs de différents types. Le type d'échelle utilisé par une visualisation dépend des options de champ de la variable :

• Si toutes les options de champ sont numériques, le type d'échelle par default est quantitatif. Vous pouvez faire passer le type d'échelle de l'encodage à catégorique dans l'éditeur de visualisation.
• Si toutes les options de champ sont des champs de date ou de datetime, le type d'échelle par default est temporel. Vous pouvez faire passer le type d'échelle de l'encodage à catégorique dans l'éditeur de visualisation.
• Sinon (par exemple, les champs de chaînes, ou un mélange de chaînes et de dates), le type d'échelle est uniquement catégoriel.

Le type d'échelle est fixé pour la variable. Il ne change pas dynamiquement en fonction du champ sélectionné par un visionneur.

Une variable peut être ajoutée à une visualisation uniquement lorsque le niveau d'agrégation de ses champs correspond aux niveaux d'agrégation acceptés par la visualisation. Par exemple, les encodages de l’axe des x et de l’axe des y d’une carte thermique acceptent uniquement les champs désagrégés, de sorte qu’ils ne peuvent encoder que des variables désagrégées.

Ajouter une variable à une visualisation

Après avoir créé une variable, ajoutez-la à l'encodage d'une visualisation, tel qu'un axe ou une colonne. Vous pouvez ajouter la même variable à plusieurs visualisations. Lorsqu'un utilisateur modifie le champ sélectionné de la variable, chaque encodage qui utilise la variable est mis à jour pour afficher le nouveau champ.