Aller au contenu principal

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.

Par default, un utilisateur sélectionne un champ à la fois. Vous pouvez également permettre aux utilisateurs de sélectionner plusieurs champs à la fois, de sorte qu’une seule variable ajoute plusieurs séries, colonnes ou lignes à une visualisation. Consultez Permettre aux utilisateurs de sélectionner plusieurs champs.

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 une transformation. La transformation définit la manière dont le champ est agrégé ou classé par compartiments (par exemple, SUM pour une mesure ou DAILY pour une date). La transformation est définie dans la variable et ne peut pas être remplacée là où la variable est utilisée.

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.

Chaque option de champ dans une variable de tableau de bord affiche son dataset source comme sous-titre, afin que vous puissiez distinguer les champs qui partagent un nom dans les datasets. Pour afficher aux utilisateurs une étiquette différente pour une option, consultez Définir des noms d'affichage pour les options de champ.

Les actions sur les variables de dashboard prennent en charge l’annulation et le rétablissement.

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.

Définir les noms d’affichage pour les options de champ​

Chaque option de champ dans une variable de tableau de bord possède une étiquette générée qui combine le nom du champ avec sa transformation, comme Somme des ventes ou Prix moyen . Vous pouvez remplacer cette étiquette par un nom d’affichage que les spectateurs verront à la place, comme Revenu total . Un nom d’affichage modifie uniquement l’étiquette. Le champ et la transformation de l’option restent les mêmes.

Pour définir un nom d'affichage pour une option de champ :

  1. Sur le tableau de bord du brouillon, sélectionnez le widget de filtre qui contrôle la variable.

  2. Dans le panneau de configuration du widget, sous Variables , cliquez sur la variable.

  3. Sous Options de champ , cliquez sur l’option de champ que vous souhaitez renommer.

  4. Dans la zone Nom d'affichage , saisissez le nom. La zone affiche l'étiquette générée comme espace réservé.

    Paramètres d’option de champ pour une variable de tableau de bord, avec la zone Nom d’affichage définie sur Revenu.

Le nom d'affichage s'enregistre au fur et à mesure que vous tapez. Pour revenir au label généré, effacez la zone Nom d'affichage .

Le nom d’affichage apparaît partout où le tableau de bord affiche l’option, sur les tableaux de bord brouillons et publiés :

Si vous définissez un nom d'affichage pour un champ dans l'éditeur de visualisation, ce nom prévaut sur le nom d'affichage de l'option dans cette visualisation.

Vous pouvez également demander à Genie Code de créer des tableaux de bord pour définir, renommer ou effacer des noms d'affichage pour les options de champ d'une variable. Lorsque Genie Code modifie la variable, il conserve les noms d'affichage que vous avez définis.

Les noms d'affichage ont les limitations suivantes :

  • Un nom d’affichage peut comporter jusqu’à 500 caractères. Les espaces de début et de fin sont supprimés.
  • Lorsque vous exportez un tableau de bord vers un fichier .lvdash.json ou en importez un, les noms d'affichage des options de champ ne sont pas inclus. Les options du tableau de bord exporté ou importé utilisent leurs libellés générés.

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.

Permettre aux utilisateurs de sélectionner plusieurs champs​

La sélection multiple permet aux utilisateurs du tableau de bord d’afficher plusieurs champs d’une variable à la fois, de sorte qu’une seule variable ajoute une série, une colonne ou une ligne distincte pour chaque champ sélectionné. Par exemple, un utilisateur peut afficher à la fois Ventes et Profit sous forme de séries distinctes sur le même graphique. By default, une variable se substitue à un champ unique.

Pour l’activer, activez Allow multi-select lorsque vous créez ou modifiez la variable. Les spectateurs utilisent ensuite un contrôle à sélection multiple pour choisir n'importe quelle combinaison des champs de la variable, et chaque visualisation qui utilise la variable ajoute une entrée par champ sélectionné.

La sélection multiple ne fonctionne que sur les encodages qui peuvent afficher plusieurs champs, tels que :

  • L'axe des y d'un graphique à barres ou en courbes à séries multiples
  • Les colonnes d’une table
  • Lignes, colonnes ou valeurs d'une table croisée dynamique

Si vous ajoutez une variable à sélections multiples à un encodage ne pouvant afficher qu’un seul champ (par exemple, une valeur de compteur ou l’axe des x d’un graphique), la visualisation utilise uniquement le premier champ sélectionné et affiche un avertissement.