view_label (pour les explorations)

Cette page fait référence au paramètre view_label qui fait partie d'une exploration.

view_label peut également être utilisé dans une jointure, décrite sur la page de documentation du paramètre view_label (pour les jointures).

view_label peut également être utilisé dans une dimension, une mesure ou un filtre, comme décrit sur la page de documentation du paramètre view_label (pour les champs).

Utilisation

explore: explore_name {
  view_label: "desired label for the view"
}
Hiérarchie
explore
view_label
Valeur par défaut
Nom de l'exploration

Acceptation
Chaîne

Définition

view_label modifie le libellé d'un groupe de champs issu de la vue de base d'une exploration dans le sélecteur de champs.

Parfois, view_label est utilisé pour ajouter un trait de soulignement devant le nom de la vue afin qu'en cas de tri alphabétique, elle apparaisse en tête de liste dans le sélecteur de champs. Vous pouvez aussi vous en servir si vous avez besoin de plusieurs vues pour la modélisation, mais que ces vues représentent la même entité aux yeux des utilisateurs métier. Par exemple, supposons que vous ayez une vue définie dans votre LookML comme customer et une autre comme customer_facts, et que vous souhaitiez conserver ces noms à des fins de modélisation. Il est toutefois préférable que l'une et l'autre soient présentées aux utilisateurs métier sous le libellé Client.

Si vous souhaitez modifier les noms des champs eux-mêmes, vous pouvez utiliser le paramètre label.

Exemples

Faites en sorte que l'exploration customer_facts apparaisse aux utilisateurs professionnels comme faisant partie de la vue Clients :

explore: customer_facts {
  view_label: "Customers"
}

Faites en sorte que l'exploration product_facts apparaisse aux utilisateurs comme faisant partie de la vue Informations sur le produit :

explore: product_facts {
  view_label: "Product Info"
}

Éléments à prendre en compte

view_label n'a aucun effet autre que la modification de l'apparence du sélecteur de champs

Lorsque vous modifiez le view_label d'une exploration, seul le sélecteur de champs est affecté. La présentation de l'exploration dans le menu Explorer et la manière dont les champs doivent être référencés dans le code LookML restent inchangées.

Utilisez les majuscules à bon escient lorsque vous combinez plusieurs vues avec view_label.

Si vous souhaitez que les champs de la vue de base de l'exploration soient fusionnés avec l'une des vues jointes de l'exploration dans le sélecteur de champ, vous devez vous assurer que la casse utilisée dans view_label est correcte. La casse que vous utilisez doit correspondre à celle du nom de la vue dans le sélecteur de champs. Prenons un exemple :

explore: product {
  view_label: "Product Info"
  join: product_info {
    sql_on: ${product.product_id} = ${product_info.product_id} ;;
  }
}

product_info s'affichera sous la forme Product Info dans le sélecteur de champ. Chaque mot commence par une majuscule et les traits de soulignement sont remplacés par des espaces. C'est pourquoi nous avons utilisé view_label: 'Product Info' au lieu de view_label: 'product_info'.

Le view_label d'un champ est prioritaire sur le view_label d'une exploration.

Si un champ d'une exploration comporte un view_label, il s'affiche sous son view_label, et non sous le view_label de l'exploration. Prenons l'exemple suivant, où une exploration et une dimension ont toutes deux des valeurs view_label.

Dans le fichier de modèle, l'exploration est définie avec view_label: "View Label on Explore" :

explore: us_births {
  label: "US births"
  view_label: "View Label on Explore"
}

Dans le fichier us_births.view, la dimension state est définie avec view_label: "View Label on Field" :


view: us_births {
  label: "US births"

  dimension: state {
    view_label: "View Label on Field"
    type: string
    sql: ${TABLE}.state ;;
  }

Dans ce cas, le view_label de la dimension state remplacera le view_label de l'exploration. La dimension state apparaîtra donc dans l'exploration sous le view_label "Afficher le libellé dans le champ".

view_label affecte la vue de base de l'onglet "Explorer".

Ce paramètre est similaire à view_label (pour les jointures), mais s'applique à la vue de base de l'exploration, et non aux vues jointes. Contrairement à label (pour les vues), ce paramètre ne concerne que la vue de base de l'exploration.