Mettre en forme des valeurs de données avec LookML

Cette page présente les paramètres LookML permettant de modifier l'apparence et le comportement des valeurs de données affichées dans les tables et les visualisations de données. Par exemple, vous pouvez spécifier la mise en forme des devises afin qu'une valeur de données telle que 1234 apparaisse sous la forme $1,234.00 dans les tableaux de données et les visualisations. Vous pouvez également spécifier des comportements cliquables pour les champs afin que les utilisateurs puissent cliquer dessus pour déclencher des actions ou suivre des liens.

Modifier la mise en forme des valeurs de données

Cette section décrit les paramètres LookML qui modifient la manière dont les valeurs de données apparaissent aux utilisateurs.

Paramètres Description Exemple
value_format Utilisez value_format pour mettre en forme la sortie d'un champ type: number à l'aide d'options de style Excel.

Notez que value_format n'a aucun effet sur les champs qui ne sont pas type: number.

measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format: "$#,##0.00"
 }
value_format_name Utilisez value_format pour mettre en forme la sortie d'un champ type: number à l'aide d'une named_value_format intégrée ou personnalisée.

Notez que value_format et value_format_name n'ont aucun effet sur les champs autres que type: number.

measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format_name: usd
}
style Utilisez le paramètre style pour modifier la mise en forme des champs de type: tier.

Notez que style est le seul paramètre LookML qui affecte la mise en forme des champs type: tier.

dimension: age_tier {
  type: tier
  tiers: [0, 10, 20, 30, 40, 50, 60, 70, 80]
  style: classic
  sql: ${age} ;;
}
  
html Utilisez le paramètre html pour appliquer une mise en forme HTML à votre champ.

Par exemple, vous pouvez modifier la police, sa taille, son épaisseur ou sa couleur. L'exemple de ce tableau montre comment ajouter des emoji à un champ en fonction de sa valeur.

dimension: status {
  sql: ${TABLE}.status ;;
  html: {% dynamic if value == 'Shipped' or value == 'Complete' %}
      <p>✅ {{value}}</p>
    {% elsif value == 'Processing' %}
      <p>⏳ {{value}}</p>
    {% dynamic else %}
      <p>❌ {{value}}</p>
    {% dynamic endif %}
   ;;
}
sql Utilisez le paramètre sql pour modifier les valeurs de données à l'aide de SQL.

Utilisez les transformations SQL autorisées par votre base de données. L'exemple de ce tableau montre comment ajouter des emoji à un champ en fonction de sa valeur.

dimension: status {
  sql: CASE WHEN (${TABLE}.status = 'Shipped' OR ${TABLE}.status = 'Complete') ;;
     THEN CONCAT('✅ ', ${TABLE}.status)
   WHEN ${TABLE}.status = 'Processing'
     THEN CONCAT('⏳ ', ${TABLE}.status)
   ELSE
     CONCAT('❌ ', ${TABLE}.status)
   END ;;
}

Modifier les actions cliquables pour les valeurs de données

Cette section décrit les paramètres LookML qui déterminent le comportement d'un champ lorsque vous cliquez sur des valeurs de données dans la table ou la visualisation de données.

Paramètres Description Exemple
drill_fields Utilisez drill_fields pour spécifier les champs à afficher lorsque l'utilisateur détaille les données. Notez que les dimensions et les mesures ont un comportement d'exploration détaillé.

Pour connaître les options avancées de création d'un chemin d'exploration personnalisé, consultez Exploration de données plus puissante.

dimension: country {
  sql: ${TABLE}.country ;;
  drill_fields: [state, city]
}
action Utilisez action pour créer une action de données sur un champ, ce qui permet aux utilisateurs d'effectuer des tâches dans d'autres outils directement depuis Looker.

Lorsqu'une ou plusieurs actions sont définies pour un champ, des points de suspension (...) s'affichent à côté de celui-ci dans les tableaux de données. En cliquant sur le champ ou les points de suspension, un menu s'affiche pour que les utilisateurs puissent sélectionner une action ou afficher le détail des données.

dimension: action_example {
  action: {
    label: "Send a Thing"
    url:
      "https://example.com/ping/{{value}}"
    form_url:
      "https://example.com/ping/{{value}}/form.json"
  }
}
link Utilisez link pour créer un lien sur un champ.

Lorsqu'un ou plusieurs liens sont définis dans un champ, des points de suspension (...) s'affichent à côté du champ dans les tableaux de données. En cliquant sur le champ ou sur les points de suspension, un menu s'affiche à partir duquel les utilisateurs peuvent sélectionner un lien ou explorer les données en détail.

dimension: artist_name {
  link: {
    label: "Google"
    url: "http://www.google.com/search?q={{value}}"
    icon_url: "http://google.com/favicon.ico"
   }
}
html Utilisez html pour écrire une mise en forme HTML personnalisée pour un champ. Avec les balises HTML comme <a>, vous pouvez spécifier un ou plusieurs liens hypertexte dans votre champ.

Si une ou plusieurs actions ou liens sont définis pour un champ, des points de suspension (...) s'affichent à côté du champ dans les tableaux de données, quelle que soit la définition html. En cliquant sur le champ ou sur les points de suspension, un menu s'affiche à partir duquel les utilisateurs peuvent sélectionner les liens ou les actions disponibles.

dimension: artist_name {
  html: <p>{{value}}
    <a href="#drillmenu">Drill menu</a>,
    <a href="http://www.google.com/search?q={{value}}">
      Google search
    </a></p>;;
    sql: ${TABLE}.artist_name ;;
    type: string
}