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 Explorer de Looker et de l'outil de sélection de champs.
| Dans Looker, vos utilisateurs peuvent voir les explorations dans le menu Explorer. |
Dans une exploration, vos utilisateurs peuvent utiliser le sélecteur 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 sur la création d'une exploration conviviale, consultez la page Bonnes pratiques: créer une expérience positive pour les utilisateurs de Looker.
Noms d'explorations et menu Exploration
Cette section décrit le comportement par défaut du nom et de l'apparence d'une exploration 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é par noms de modèles, qui sont déterminés 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 une majuscule tout en mots. 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 dans le 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, l'exploration order_items 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'exploration order_items s'affiche sous la forme d'éléments de la 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 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 le paramètre 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 apparaît comme É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, 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 label d'une exploration renomme une exploration dans le menu Explorer et sur la page "Explorer" sans modifier sa référence 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)
Le paramètre group_label d'une exploration 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 lister une ou plusieurs explorations.
Dans cet exemple, les options Explorations 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 description d'une exploration vous permet d'ajouter une description d'une exploration à l'interface utilisateur. Les utilisateurs peuvent ainsi 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)
Le paramètre hidden d'une exploration masque la section "Explorer" dans le menu Explorer. Par défaut, hidden est désactivé, et l'exploration s'affiche. hidden ne masque pas LookML et n'empêche pas l'accès à une exploration via l'URL. hidden n'est pas conçu comme une fonctionnalité de sécurité, mais comme une fonctionnalité de présentation.
Par exemple, en ajoutant le code LookML hidden: yes au LookML pour l'exploration inventory, vous pouvez masquer l'exploration Inventaire dans le 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é par en-têtes correspondant aux vues spécifiées par le paramètre view de LookML. Les champs de chaque vue sont regroupés dans le sélecteur 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 de champ LookML, où les traits de soulignement sont remplacés par des espaces et tous les mots en majuscules.
Dans l'exemple suivant, Looker affiche la vue accounts en tant que Accounts dans le sélecteur de champ, qui est le 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, l'outil de sélection de champs 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, le sélecteur de champ s'adapte au nouveau nom. Toutefois, 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 être utile si vous modifiez les noms des champs d'un modèle, mais que certaines personnes ont des liens partagés vers des données et souhaitez que ces URL préexistantes fonctionnent.
view_label (Explorer)
Le paramètre view_label d'une exploration modifie la façon dont le groupe de champs d'une vue de base d'une exploration est étiqueté 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 l'outil de sélection de champs:
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 Commandes et autres dans l'outil de sélection de champ de la section Commandes.
view_label (participation)
Le paramètre view_label d'une jointure vous permet de regrouper les champs d'une vue sous le nom d'une autre vue dans l'outil de sélection de champ. Si vous n'ajoutez pas explicitement un 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 l'exploration product_facts:
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, indépendamment de la vue Facts:
Vous pouvez utiliser le paramètre view_label pour ajouter un libellé à 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 alors regroupés sous le libellé de vue des produits dans l'outil de sélection de champs:
label (vue)
Le paramètre label d'une vue modifie son étiquette dans l'outil de sélection de champs 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 (Explorer) et view_label (jointure), ce paramètre affecte toutes les explorations qui utilisent la vue.
Par exemple, vous pouvez utiliser le paramètre label pour 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, l'outil de sélection de champs affiche le libellé Éléments de l'inventaire pour la vue inventory_items au lieu du libellé par défaut Éléments de l'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 renseignera automatiquement les descriptions des champs à partir des métadonnées de vos colonnes 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 du champ dans le sélecteur de champ.
De plus, Looker affiche également la description lorsque l'utilisateur pointe sur le nom de la colonne dans un tableau ou une visualisation de graphique dans un tableau, un tableau de bord ou un aperçu.
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 des champs.
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 hidden comme un outil visant à assurer la clarté du sélecteur de champ et non comme une fonctionnalité de sécurité.
Par exemple, en ajoutant le code LookML hidden: yes au LookML pour la dimension product_id dans l'exemple suivant, la dimension ID produit est masquée dans l'outil de sélection 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 d'Explore qui sont exposés dans l'outil de sélection de champ. 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 des champs ou des ensembles à exclure séparés par une virgule, avec un trait d'union (-) devant chacun.
Par exemple, vous pouvez utiliser le code LookML suivant pour n'afficher qu'une sélection de champs de l'outil aircraft Explorer dans le sélecteur de champ:
explore: aircraft {
fields: [
aircraft.aircraft_model_code,
aircraft.aircraft_engine_code,
aircraft.count,
aircraft.city,
aircraft.country,
aircraft.zip,
]
}
Dans cet exemple, la commande Avion explore uniquement les dimensions Code du modèle d'avion, Code du moteur d'avion, Ville, Pays et Code postal, et mesure Nombre dans l'outil de sélection de champ.
label (champ)
Le paramètre label d'un champ 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 pour 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 porte le libellé prix dans l'outil de sélection de champ.
view_label (champ)
Le paramètre view_label d'un champ vous permet de modifier le nom de la vue sous laquelle le champ est répertorié 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 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 les coûts dans l'outil de sélection de champ.
group_label (champ)
Le paramètre group_label vous permet de combiner des champs dans une liste déroulante commune 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 regroupés pour modifier leur apparence sous le libellé de groupe.
Dans cet exemple, le groupe Informations sur la livraison comprend les champs Ville, Pays et État:
