label (pour les champs)

Cette section fait référence au paramètre label qui fait partie d'un champ.

label peut également être utilisé dans le cadre d'un modèle, décrit sur la page de documentation du paramètre label (pour les modèles).

label peut également être utilisé dans le cadre d'une exploration, décrite sur la page de documentation du paramètre label (pour les explorations).

label peut également être utilisé dans une vue, comme décrit sur la page de documentation du paramètre label (pour les vues).

label peut également être utilisé dans une ligne de référence, décrite sur la page de documentation des paramètres de ligne de référence du tableau de bord.

Utilisation

view_name {
dimension: field_name {
label: "nom du libellé souhaité"
}
}
Hiérarchie
view
Type de champ
label
Types de champs possibles
Dimension, Groupe de dimensions, Mesurer, Filtrer, Paramètre

Acceptation
Chaîne

Définition

label facilite l'exploration des explorations en vous permettant de choisir la façon dont les noms de champs apparaissent dans l'outil de sélection des champs et dans le tableau de données d'une exploration. Par défaut, si ce paramètre n'est pas défini, le libellé affiché est le nom du champ.

Le libellé n'affecte que le nom affiché du champ dans une exploration et n'affecte pas la façon dont vous référencez le champ dans LookML. Les champs avec des libellés sont toujours référencés avec la syntaxe ${view_name.field_name} normale dans vos fichiers LookML.

Variables liquides avec label

Vous pouvez utiliser des variables Liquid avec le paramètre label. Les variables Liquid vous permettent d'accéder à des données telles que des informations sur un modèle ou une exploration, les filtres appliqués à un champ et les valeurs des attributs utilisateur. Vous pouvez utiliser des variables Liquid pour modifier la valeur label de manière dynamique, et ainsi modifier l'apparence du champ dans le sélecteur de champ et les visualisations de données.

Les variables liquides qui renvoient une valeur basée sur un filtre, par exemple _filters, ou qui nécessitent l'exécution préalable d'une requête (telle que in_query) ne modifient pas le nom du champ dans l'outil de sélection de champs. Dans ce cas, le nom du champ ne sera modifié que dans la visualisation obtenue.

Par exemple, la variable Liquid {{ _user_attributes['name_of_attribute'] }} remplace la variable Liquid par la valeur de l'attribut utilisateur spécifié. Si un utilisateur possède un attribut utilisateur appelé name avec la valeur "John Smith", la syntaxe label suivante modifiera le nom du champ dans l'outil de sélection de champ en John Smith :

label: "{{ _user_attributes['name'] }}"

Dans l'exemple suivant, la dimension name utilise la structure Liquid {% dynamic if %} {% dynamic else %} {% dynamic endif %} avec la variable Liquid _user_attributes['name_of_attribute'] pour modifier sa valeur label en fonction d'un attribut utilisateur de l'entreprise:

dimension: name {
  label: "{% dynamic if _user_attributes['company'] == 'Looker' %} Employee Name {% dynamic else %} Customer Name {% dynamic endif %}"
  sql: ${TABLE}.name ;;
}

Pour voir d'autres exemples d'utilisation de label avec des variables Liquid pour définir des étiquettes dynamiques, consultez cet article du Centre d'aide.

Exemple

Dans le sélecteur de champ, cette mesure apparaît comme Nombre de clients au lieu de Valeurs distinctes.

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

Éléments à prendre en compte

L'IDE signale les libellés en double dans une vue

Pour éviter les libellés de champ en double dans la même vue, l'IDE Looker affiche une icône d'information à côté du numéro de ligne de tous les libellés de champ en double dans un fichier de vue LookML. Si vous pointez sur l'icône d'informations à côté du numéro de ligne, l'info-bulle indique qu'il existe déjà un champ avec le libellé dans la vue.

L'IDE Looker affiche ces mêmes informations dans l'aide rapide si vous cliquez sur le texte de l'instruction label dans l'IDE: