Plusieurs paramètres LookML permettent de rendre les explorations plus attrayantes en modifiant l'aspect des champs affichés dans l'interface utilisateur sans changer le code LookML sous-jacent. Cette page présente les paramètres LookML qui modifient l'apparence du menu d'exploration Looker et du sélecteur de champ.
| Dans Looker, vos utilisateurs peuvent voir les explorations dans le menu Explorer (Explorer). |
Dans Explorer, vos utilisateurs peuvent utiliser l'outil de sélection de champs pour sélectionner les champs (dimensions et mesures) à utiliser pour interroger leurs données. |
|
|
Cette page présente les paramètres les plus courants, accompagnés d'un lien vers une page de référence complète, d'une courte description de leur fonction et d'une image en illustrant les effets.
Pour obtenir des conseils et des suggestions pour créer une expérience utilisateur conviviale, consultez l'article Bonnes pratiques: créer une expérience positive pour les utilisateurs de Looker du centre d'aide.
Noms d'explorations et menu Exploration
Cette section décrit le comportement par défaut d'un nom et d'une apparence Explorer dans le menu Explorer, puis décrit les paramètres LookML qui vous permettent de modifier ce comportement:
Comportement par défaut du menu Exploration
Noms de modèles
Par défaut, le menu Explorer est organisé en fonction du nom du modèle, qui est déterminé par le nom de chaque fichier de modèle. Le menu Explorer affiche une version mise en forme du nom du modèle, avec des traits de soulignement remplacés par des espaces et chaque mot en majuscule. Sous chaque nom de modèle figure la liste des explorations définies dans le fichier de ce modèle.
Noms d'explorations
Le nom de chaque exploration dans le menu est basé sur le paramètre explore correspondant du fichier de modèle. À l'instar des noms de modèles, les noms d'explorations affichés dans le menu sont mis en forme. Les traits de soulignement sont ainsi remplacés par des espaces et chaque mot commence par une majuscule. Les noms d'explorations sont également utilisés comme intitulés au-dessus du sélecteur de champs.
Dans l'exemple suivant, la fonction order_items Explorer est définie dans le fichier de modèle e_commerce_model.model :
explore: order_items {
join: orders {
type: left_outer
sql_on: ${order_items.order_id} = ${orders.id} ;;
relationship: many_to_one
}
}
L'onglet "Explorer" de order_items s'affiche sous la forme d'éléments de campagne dans le menu "Explorer" et l'outil de sélection de champs.
| Menu Exploration : | Sélecteur de champ : |
 |
 |
Pour en savoir plus sur les fichiers de modèle, consultez la page de documentation Comprendre les fichiers de modèle et d'affichage. Pour en savoir plus sur la définition des explorations, consultez la page de documentation sur les paramètres explore.
label (modèle)
Le paramètre label d'un modèle renomme un modèle dans le menu Explorer sans modifier la façon dont il est référencé dans LookML. Les URL d'explorations, l'environnement IDE de Looker et SQL Runner font toujours référence au nom réel du modèle ; la façon dont le modèle doit être indiqué dans les paramètres LookML et Admin reste inchangée.
Par défaut, le modèle market_research.model s'affiche avec l'intitulé Étude de marché dans le menu "Explorer" :
Vous pouvez utiliser le paramètre label pour renommer le modèle dans le menu"Explorer". Par exemple, vous ajoutez le code label: "Marketing R&D" au fichier de modèle market_research.model:
label: "Marketing R&D"
Dans cet exemple, Looker affiche le nom de modèle comme suit dans le menu Exploration :
label (Explorer)
Le paramètre Explorer label renomme une exploration dans le menu Explorer et sur la page "Explorer" sans modifier la façon dont elle est référencée dans LookML.
Si le paramètre label n'est pas utilisé, le nom de l'exploration s'affiche en fonction de son comportement par défaut.
group_label (Explorer)
Un paramètre Explorer group_label modifie l'organisation par défaut du menu Explorer. Au lieu de lister chaque exploration sous le nom de son modèle, group_label vous permet de définir un titre personnalisé sous lequel répertorier un ou plusieurs explorations.
Dans cet exemple, les options Explorer Clients, Inventaire, Articles de commande et Données utilisateur sont listées sous le libellé de groupe Requêtes de boutique en ligne :
description (Explorer)
Le paramètre Explorer description vous permet d'ajouter une description d'une exploration à l'interface utilisateur, afin que les utilisateurs puissent obtenir des informations supplémentaires lorsqu'ils créent des rapports.
Les utilisateurs peuvent voir cette description en passant le curseur sur l'icône d'information, en regard du nom de l'exploration affiché en haut du sélecteur de champs. Cette icône d'information figure également dans la liste déroulante des explorations. Si vous n'ajoutez pas explicitement de description à une exploration, aucune description ne s'affiche.
hidden (Explorer)
Un paramètre hidden de l'onglet "Explorer" masque le menu "Explorer" dans le menu Explorer. Par défaut, hidden est désactivé, et la fonctionnalité Explorer s'affiche. hidden ne masque pas LookML et empêche l'accès à une exploration via l'URL. hidden n'est pas une fonctionnalité de sécurité, mais une présentation.
Par exemple, en ajoutant le code LookML hidden: yes au LookML pour la fonction inventory de l'exemple suivant, vous masquez la colonne Inventory Explorer du menu Explorer:
explore: inventory {
hidden: yes
join: order_facts {
view_label: "Orders"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
Sélecteur de champs
Cette section décrit le comportement par défaut du sélecteur de champ, puis décrit les paramètres LookML qui vous permettent de modifier ce comportement.
Les paramètres suivants permettent de modifier la présentation des noms de vues dans le sélecteur de champs :
Les paramètres suivants permettent de modifier la présentation des noms de champs dans le sélecteur de champs :
Les paramètres suivants permettent de modifier l'organisation des champs dans le sélecteur de champs :
Comportement par défaut du sélecteur de champs
Par défaut, le sélecteur de champ est organisé selon des en-têtes qui correspondent aux vues spécifiées par le paramètre LookML view. Les champs de chaque vue sont regroupés dans l'outil de sélection de champ. Le type du champ (dimension, groupe de dimensions, mesure, champ de filtrage ou champ de paramètre) détermine son emplacement au sein de la vue. À moins que le paramètre label ne soit utilisé pour modifier le nom à afficher, le sélecteur de champ affiche une version mise en forme de la vue ou du nom du champ LookML. Les traits de soulignement sont remplacés par des espaces et chaque mot est en majuscule.
Dans l'exemple suivant, Looker affiche la vue accounts en tant que Accounts dans le sélecteur de champ, ce qui correspond au comportement par défaut:
view: accounts {
sql_table_name: accounts ;;
}
L'exemple suivant montre comment s'affichent par défaut les noms d'une dimension, d'un groupe de dimensions et d'une mesure. La même mise en forme est appliquée aux noms des champs de filtrage et de paramètre.
dimension: account_number {
primary_key: yes
type: number
sql: ${TABLE}.account_number ;;
}
dimension: name {
type: string
sql: ${TABLE}.name ;;
}
dimension_group: created {
type: time
timeframes: [raw, time, date, week, month, quarter, year]
sql: ${TABLE}.created_date ;;
}
measure: average_annual_revenue {
type: average
sql: ${annual_revenue} ;;
value_format_name: custom_amount_value_format
}
Dans cet exemple, le sélecteur de champ affiche les noms de champ par défaut Numéro de compte, Nom, Date de création et Revenu annuel moyen pour les dimensions account_number et name, le groupe de dimensions created et la mesure average_annual_revenue, respectivement:
Si vous modifiez le nom d'un champ, l'outil de sélection de champ s'adapte au nouveau nom, mais vous pouvez ajouter un paramètre alias avec l'ancien nom du champ. Ce paramètre permet de définir d'autres noms pour un champ, susceptibles de figurer dans l'URL d'une requête. Cela peut s'avérer utile lorsque les noms des champs d'un modèle changent, mais que certaines personnes ont partagé des liens vers des données et que vous souhaitez maintenir le fonctionnement de ces URL préexistantes.
view_label (Explorer)
Un paramètre view_label de l'onglet "Explorer" modifie la façon dont le groupe de champs d'une vue de base de l'onglet "Explorer" est libellé dans l'outil de sélection de champs, sans modifier la façon dont l'exploration et ses champs sont référencés dans LookML.
Par exemple, si vous associez une vue order_facts à une exploration appelée order_items, vous pouvez utiliser le paramètre view_label pour définir le libellé que Looker affiche pour la vue order_facts dans le sélecteur de champ comme suit:
explore: order_items {
label: "Order Items"
join: order_facts {
view_label: "Orders and more"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
Dans cet exemple, la vue order_facts apparaît sous la forme Orders and more (Commandes et autres) dans le sélecteur de champ de la commande Order Items (Articles) :
view_label (rejoindre)
Un paramètre de jointure view_label vous permet de regrouper les champs d'une vue sous un autre nom de vue dans l'outil de sélection de champ. Si vous n'ajoutez pas explicitement de view_label à une jointure, view_label est défini par défaut sur le nom de la jointure.
Par exemple, vous rejoignez la vue products pour la product_facts Explorer:
explore: product_facts {
join: products {
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
Dans cet exemple, comme aucun libellé de vue n'est spécifié, les champs de la vue products sont regroupés sous le libellé de vue Produits dans l'outil de sélection de champs, séparé de la vue Product Facts:
Vous pouvez utiliser le paramètre view_label pour ajouter un libellé de vue à la vue products jointe, comme dans l'exemple suivant:
explore: product_facts {
join: products {
view_label: "Product Facts"
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
Les champs de la vue products sont regroupés sous le libellé de vue Product Facts (Données produit) dans l'outil de sélection de champs:
label (vue)
Un paramètre de vue label modifie la façon dont la vue est libellée dans le sélecteur de champ sans modifier la façon dont elle est référencée dans LookML. Par défaut, le libellé affiché est le nom de la vue. Contrairement à view_label (Exploration) et view_label (Joindre), ce paramètre affecte toutes les explorations qui utilisent la vue.
Par exemple, vous pouvez utiliser le paramètre label afin de spécifier un libellé pour la vue inventory_items comme suit:
view: inventory_items {
label: "Items in Inventory"
sql_table_name: inventory_items ;;
}
Dans cet exemple, le sélecteur de champ affiche le libellé Éléments de l'inventaire pour la vue inventory_items au lieu du libellé par défaut Éléments d'inventaire:
description (champ)
Vous pouvez ajouter un description à n'importe quel champ. Pour les connexions BigQuery, si vous générez un projet LookML à partir de votre base de données, Looker remplit automatiquement les descriptions de champ avec les descriptions de vos métadonnées de colonne BigQuery, le cas échéant.
Cette description est visible par l'utilisateur à plusieurs endroits. Looker affiche la description lorsque l'utilisateur sélectionne l'icône d'informations à droite du nom de champ dans le sélecteur de champs.
Par ailleurs, Looker affiche la description lorsque l'utilisateur passe le curseur sur le nom de la colonne d'une table ou d'une visualisation sous forme de tableau affichée dans une exploration, un tableau de bord ou une présentation.
hidden (champ)
Par défaut, les champs spécifiés dans une vue s'affichent dans le sélecteur de champs. Le paramètre hidden masque un champ dans l'outil de sélection de champ.
Les champs masqués restent accessibles dans l'interface utilisateur à condition d'être ajoutés manuellement à l'URL, et apparaissent dans certaines fenêtres Looker. Considérez donc hidden comme un moyen de garder le sélecteur de champ propre et non comme une fonctionnalité de sécurité.
Par exemple, en ajoutant le code LookML hidden: yes à LookML pour la dimension product_id dans l'exemple suivant, vous masquez la dimension Product ID (ID du produit) dans le sélecteur de champ:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields (champ)
Le paramètre fields vous permet de spécifier les champs de la vue de base et des jointures de l'outil Explorer dans l'outil de sélection de champs. Si vous n'utilisez pas le paramètre fields, Looker expose tous les champs.
Pour spécifier les champs que vous souhaitez afficher dans le sélecteur de champs, utilisez une liste ou des ensembles de champs séparés par des virgules. Pour spécifier les champs que vous souhaitez masquer dans le sélecteur de champs, utilisez l'ensemble ALL_FIELDS* avec une liste d'éléments ou de champs séparés par une virgule, en les séparant par un trait d'union (-).
Par exemple, vous pouvez utiliser le code LookML suivant pour afficher uniquement une sélection de champs de l'onglet aircraft Explorer dans l'outil de sélection de champs:
explore: aircraft {
fields: [
aircraft.aircraft_model_code,
aircraft.aircraft_engine_code,
aircraft.count,
aircraft.city,
aircraft.country,
aircraft.zip,
]
}
Dans cet exemple, l'exploration Avion n'affiche que les dimensions Code du modèle d'avion, Code du moteur d'avion, Ville, Pays et Code postal, et la mesure Nombre dans l'outil de sélection de champs:
label (champ)
Un paramètre de champ label vous permet de modifier la façon dont un nom de champ apparaît dans l'outil de sélection de champs sans modifier la façon dont il est référencé dans LookML. Par défaut, si ce paramètre n'est pas défini, le libellé affiché est le nom du champ.
Par exemple, vous pouvez utiliser le paramètre label afin de définir un libellé pour la dimension cost comme suit:
dimension: cost {
label: "price"
type: number
sql: ${TABLE}.cost ;;
}
Dans cet exemple, la dimension Coût est associée au libellé prix dans l'outil de sélection de champs:
view_label (champ)
Un paramètre de champ view_label vous permet de modifier le nom de la vue sous laquelle le champ est répertorié dans l'outil de sélection de champ sans modifier la façon dont il est référencé dans LookML. Par défaut, si ce paramètre n'est pas utilisé, le champ apparaît sous le libellé de la vue dans laquelle il est défini.
Par exemple, vous pouvez utiliser le paramètre view_label comme suit pour spécifier un libellé de vue pour la dimension cost:
dimension: cost {
view_label: "Cost Information"
type: number
sql: ${TABLE}.cost ;;
}
Dans cet exemple, Looker affiche la dimension Coût sous le libellé de la vue Informations sur le coût dans le sélecteur de champ:
group_label (champ)
Le paramètre group_label vous permet de combiner des champs dans une liste déroulante courante dans une vue de l'outil de sélection de champ.
Dans cet exemple, le groupe Informations de livraison comprend les champs Ville de livraison, Pays de livraison et État de la livraison:
group_item_label (champ)
Lorsque des champs sont affichés sous un libellé de groupe, il n'est pas nécessaire d'afficher leur nom ou leur libellé complet dans le sélecteur de champs. Dans l'exemple précédent pour group_label (champ), le libellé de groupe indique déjà que les champs concernent la livraison. Dans ce cas, vous pouvez ajouter le paramètre group_item_label à chacun de ces champs groupés afin de modifier leur apparence sous le libellé de groupe.
Dans cet exemple, le groupe Shipping Info (Informations de livraison) comprend les champs City (Ville), Country (Pays) et State (État) :
