L'info-bulle de visualisation affiche la valeur des dimensions et mesures sélectionnées par défaut, et peut aider les utilisateurs à comprendre l'importance d'un point de données unique.
Par exemple, une info-bulle pour une visualisation cartographique basée sur la marge brute totale, regroupée par État affiche les valeurs des deux champs lorsqu'un utilisateur pointe sur l'État de Californie.
Cependant, que se passe-t-il si vous souhaitez inclure des champs autres que ceux par défaut dans l'info-bulle afin que les utilisateurs puissent obtenir plus d'informations ou de contexte sur un point de données sans avoir à chercher ailleurs ?
Vous pouvez personnaliser l'info-bulle pour afficher les valeurs de plusieurs champs spécifiés, y compris des champs qui ne figurent pas dans la requête d'exploration.
Composants
- Variables Liquid : les variables Liquid affichent les valeurs d'autres champs en conjonction avec la requête d'exploration existante.
- Paramètre
html
: les champs définis dans le paramètrehtml
d'une mesure s'affichent dans l'info-bulle lorsqu'un utilisateur pointe sur une visualisation. - Visualisation : l'info-bulle apparaît lorsqu'un utilisateur pointe son curseur sur un point de données dans certains types de visualisation.
Prérequis
La personnalisation de l'info-bulle nécessite les éléments suivants:
- Ce rôle permet de créer des explorations et de développer LookML.
- Connaissance du développement SQL et LookML
- Connaissances de base de l'utilisation de Liquid dans Looker et du codage HTML. Pour obtenir des informations générales, consultez la section Utilisation des variables Liquid dans le paramètre
html
de la page de documentation dehtml
. - Autorisations d'enregistrer du contenu (si vous souhaitez enregistrer la visualisation en tant que Look ou tableau de bord)
Remarques concernant la personnalisation des info-bulles
Il est important de tenir compte des points suivants lorsque vous personnalisez une info-bulle:
- Les valeurs du paramètre
html
deviennent l'axe des y d'une visualisation. - La valeur que vous souhaitez afficher sur l'axe des ordonnées doit correspondre à la valeur du paramètre
sql
de la mesure. - Lorsque vous utilisez une mesure mise en forme (une mesure de
type: percent_of_total
ou une mesure avec un paramètrevalue_format_name
ouvalue_format
), veillez à utiliser la syntaxe Liquid pour la valeur affichée{{ field_name._rendered_value }}
(oùfield_name
correspond au nom réel de la mesure ou de la dimension).
Exemple
Par défaut, l'info-bulle des points de données de visualisation inclura les valeurs de Marge brute totale et État. Cependant, que se passe-t-il si vous souhaitez fournir aux utilisateurs des informations supplémentaires qui ne sont pas indiquées sur la carte ou incluses dans la requête d'exploration ? Comment procéder si vous souhaitez inclure la valeur d'un champ appelé Pourcentage de la marge brute totale au lieu de État ? Inclure le Pourcentage de la marge brute totale aidera les utilisateurs à comparer la valeur de la Marge brute totale d'un point de données individuel à la marge brute totale de l'ensemble de données.
Pour personnaliser l'info-bulle, procédez comme suit:
measure: total_gross_margin {
type: sum
value_format_name: decimal_2
sql: ${gross_margin} ;;
html: {{ rendered_value }} | {{percent_of_gross_margin._rendered_value }} of total ;;
}
En mode Développement, accédez à la définition LookML du champ que vous souhaitez personnaliser.
Vous pouvez accéder directement à la définition LookML d'un champ à partir d'une exploration.
Déterminez les champs et les valeurs que vous souhaitez inclure dans l'info-bulle en plus du champ d'origine. Par exemple, Pourcentage de la marge brute totale.
Ajoutez un paramètre
html
à la mesure d'origine référencée dans la requête d'exploration et affichée dans l'info-bulle. Dans ce cas, la mesure qui se trouve actuellement dans la requête d'exploration et qui est affichée dans l'info-bulle est Marge brute totale.Dans le paramètre
html
, créez une expression avec des variables Liquid qui ajoute les champs supplémentaires à la valeur de la mesure existante.- Cet exemple utilise la variable Liquid
_rendered_value
pour afficher les valeurs au format Looker. Par exemple,total_gross_margin
utilise la mise en forme Looker pour deux décimales etpercent_of_total_gross_margin
utilise la mise en forme Looker pour les pourcentages avec deux décimales. - Vous pouvez utiliser une barre verticale
|
pour séparer les valeurs de différents champs. - Vous pouvez également ajouter d'autres mots pour clarifier la signification des autres valeurs affichées dans l'info-bulle. Dans ce cas,
of total
est ajouté pour clarifier la signification de la valeur en pourcentage.
- Cet exemple utilise la variable Liquid
Enregistrez, validez et transférez votre code en production après avoir vérifié qu'il fonctionne comme prévu.
L'info-bulle affiche désormais deux valeurs lorsqu'un utilisateur pointe sur un point de données avec l'info-bulle: la valeur total_gross_margin
du point de données et la valeur percent_of_total_gross_margin
correspondante.
Étapes suivantes
Une fois que vous avez créé votre visualisation avec une info-bulle personnalisée, vous pouvez la partager avec d'autres personnes:
- Enregistrer une exploration en tant que Look
- Ajouter l'exploration à un tableau de bord
- Partager l'exploration avec une URL