Paramètres des graphiques en boîte pour les tableaux de bord LookML

Cette page explique comment ajouter et personnaliser un élément de tableau de bord LookML type: looker_boxplot avec des paramètres de tableau de bord LookML dans un fichier dashboard.lkml.

Pour savoir comment créer un graphique en boîte à l'aide de l'interface utilisateur Looker, consultez la page de documentation Options du graphique en boîte.

Exemple d'utilisation

Un N indique qu'une valeur numérique est requise. Les guillemets simples indiquent un texte descriptif et ne doivent pas être inclus dans le code en direct.

## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_boxplot
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
  text: 'note text'
  state: collapsed | expanded
  display: above | below | hover

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
limit: N
filters:
  view_name.field_name: 'looker filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
hidden_fields: [view_name.field_name, view_name.field_name, …]

## SERIES PARAMETERS

color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## STYLE PARAMETERS

show_view_names: true | false

## X-AXIS PARAMETERS

show_x_axis_label: true | false
x_axis_label: 'desired x-axis label'
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_reversed: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS

show_y_axis_labels: true | false
y_axis_labels: ['desired y-axis label']
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_min: ['N']
y_axis_max: ['N']
y_axis_tick_density: default | custom
y_axis_tick_density_custom: 'N'
y_axis_reversed: true | false
y_axis_value_format: ['Excel-style formatting']
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

Définition des paramètres

Nom du paramètre	Description
Paramètres de base
name (pour les éléments)	Crée un élément.
title (pour les éléments)	Modifie la façon dont le nom d'un élément s'affiche pour les utilisateurs
type (pour les éléments)	Détermine le type de visualisation à utiliser dans l'élément.
height (pour les éléments)	Définit la hauteur d'un élément, en unités tile_size, pour les tableaux de bord layout: tile et layout: static
width (pour les éléments)	Définit la largeur d'un élément, en unités tile_size, pour les tableaux de bord layout: tile et layout: static
top	Définit la position de haut en bas d'un élément, en unités tile_size, pour les tableaux de bord layout: static.
left	Définit la position de gauche à droite d'un élément, en unités tile_size, pour les tableaux de bord layout: static
row	Définit la position de haut en bas d'un élément, en nombre de lignes, pour les tableaux de bord layout: newspaper
col	Définit la position de gauche à droite d'un élément, en unités de colonnes, pour les tableaux de bord layout: newspaper
refresh (pour les éléments)	Définit l'intervalle auquel l'élément est automatiquement actualisé
note	Marque le début d'une section de code LookML pour définir une note pour un élément. Ce paramètre comporte les sous-paramètres text, state et display.
Paramètres de requête
model	Définit le modèle à utiliser pour la requête de l'élément
explore (pour les éléments)	Définit l'exploration à utiliser pour la requête de l'élément.
fields	Définit les champs à utiliser pour la requête de l'élément. Vous pouvez l'utiliser à la place de dimensions et measures.
dimensions	Définit les dimensions à utiliser pour la requête de l'élément
measures	Définit les mesures à utiliser pour la requête de l'élément.
sorts	Définit les tris à utiliser pour la requête de l'élément
limit	Définit la limite de lignes à utiliser pour la requête de l'élément
filters (pour les éléments)	Définit les filtres qui ne peuvent pas être modifiés pour la requête de l'élément.
listen	Définit les filtres qui peuvent être modifiés pour la requête de l'élément, si des filters (pour le tableau de bord) ont été créés.
query_timezone	Définit le fuseau horaire à utiliser lors de l'exécution de la requête.
hidden_fields	Spécifie les champs à utiliser dans la requête, mais à masquer dans le graphique.
Paramètres de série
color_application	Applique une collection et une palette de couleurs au graphique.
Paramètres de style
show_view_names	Affiche ou masque les noms des vues dans les libellés des graphiques
Paramètres de l'axe X
show_x_axis_label	Affiche ou masque le libellé de l'axe X.
x_axis_label	Définit un libellé personnalisé pour l'axe X
show_x_axis_ticks	Affiche les valeurs sur l'axe X.
x_axis_gridlines	Étend les lignes de la grille à partir de l'axe X
x_axis_reversed	Inverse la direction de l'axe X.
x_axis_zoom	Indique s'il faut autoriser le zoom sur l'axe X.
Paramètres de l'axe Y
show_y_axis_labels	Affiche ou masque le libellé de l'axe Y.
y_axis_labels	Définit un libellé d'axe Y personnalisé
show_y_axis_ticks	Affiche les valeurs sur l'axe Y.
y_axis_gridlines	Étend les lignes de la grille à partir de l'axe Y
y_axis_min	Définit une valeur minimale pour l'axe Y.
y_axis_max	Définit une valeur maximale pour l'axe Y.
y_axis_tick_density	Permet de définir une densité de graduation personnalisée pour l'axe Y à l'aide du paramètre y_axis_tick_density_custom.
y_axis_tick_density_custom	Définit la densité des graduations de l'axe Y lorsque y_axis_tick_density est défini sur custom.
y_axis_reversed	Inverse la direction de l'axe Y
y_axis_value_format	Définit le format numérique des valeurs de l'axe Y.
y_axis_zoom	Indique s'il faut autoriser le zoom le long de l'axe Y. Désactivé si x_axis_zoom: false.
Paramètres de configuration de la visualisation avancée
advanced_viz_config	Accepte un extrait de code JSON HighCharts qui peut remplacer plusieurs paramètres de visualisation.

Paramètres de base

Lorsque vous définissez un élément de tableau de bord LookML, vous devez spécifier des valeurs pour au moins les paramètres de base name et type. D'autres paramètres de base, tels que title, height et width, affectent l'apparence et la position d'un élément sur un tableau de bord.

name

Cette section fait référence au paramètre name qui fait partie d'un élément de tableau de bord.

name peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Chaque déclaration name crée un élément de tableau de bord et lui attribue un nom. Les noms des éléments doivent être uniques. Les noms sont parfois référencés dans le paramètre elements lorsque vous utilisez des tableaux de bord layout: grid.

- name: orders_by_date

title

Cette section fait référence au paramètre title qui fait partie d'un élément de tableau de bord.

title peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

title peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre title vous permet de modifier la façon dont le nom d'un élément s'affiche pour les utilisateurs. Si aucun titre n'est spécifié, le titre par défaut est l'élément name.

Considérez l'exemple suivant :

- name: sales_overview
  title: '1) Sales Overview'

Si vous avez utilisé ce format, l'élément Aperçu des ventes s'affichera 1) Aperçu des ventes.

type

Cette section fait référence au paramètre type qui fait partie d'un élément de tableau de bord.

type peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

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

type peut également être utilisé dans une dimension, comme décrit sur la page de documentation Types de dimensions, de filtres et de paramètres.

type peut également être utilisé dans une mesure, comme décrit sur la page de documentation Types de mesures.

Le paramètre type détermine le type de visualisation à utiliser dans l'élément.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot

Pour obtenir une présentation des différents types d'éléments de tableau de bord LookML, consultez la page de documentation type (pour les tableaux de bord LookML).

height

Cette section fait référence au paramètre height qui fait partie d'un élément de tableau de bord.

height peut également être utilisé dans une ligne de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Pour les tableaux de bord avec des mises en page tile ou static

Le paramètre height définit la hauteur d'un élément, en unités tile_size (qui est définie en pixels), pour les tableaux de bord layout: tile et layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et height: 4, ce qui définit la hauteur de l'élément orders_by_date sur 400 pixels.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Pour les tableaux de bord avec une mise en page newspaper

Le paramètre height définit la hauteur d'un élément, en unités row, pour les tableaux de bord layout: newspaper.

Un tableau de bord avec une mise en page de type journal a une hauteur d'élément par défaut de six lignes, soit environ 300 pixels. La hauteur minimale est d'une ligne pour les tableaux de bord dont le paramètre preferred viewer est défini sur dashboards-next. La hauteur minimale est de deux lignes pour les tableaux de bord dont le paramètre preferred viewer est défini sur dashboards.

Par exemple, le code suivant définit un élément sur 12 lignes de hauteur, soit deux fois plus haut que les autres éléments définis sur la valeur par défaut :

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

Cette section fait référence au paramètre width qui fait partie d'un élément de tableau de bord.

width peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre width définit la largeur d'un élément, en unités tile_size, pour les tableaux de bord layout: tile et layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et width: 4, ce qui définit la largeur de l'élément orders_by_date sur 400 pixels.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

Le paramètre width définit la largeur d'un élément, en unités de colonnes, pour les tableaux de bord layout: newspaper.

Un tableau de bord avec une mise en page de type journal est défini par défaut sur une largeur de 24 colonnes.

Par exemple, le code suivant définit l'élément sur la moitié de la largeur du tableau de bord :

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

Le paramètre top définit la position de haut en bas d'un élément, en unités tile_size, pour les tableaux de bord layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et top: 4, ce qui positionne le bord supérieur de l'élément orders_by_date à 400 pixels du haut du tableau de bord.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

Le paramètre left définit la position de gauche à droite d'un élément, en unités tile_size, pour les tableaux de bord layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et left: 4, ce qui positionne le bord gauche de l'élément orders_by_date à 400 pixels du bord gauche du tableau de bord.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

Pour les tableaux de bord layout: newspaper, le paramètre row définit la ligne sur laquelle le bord supérieur d'un élément est placé.

Un tableau de bord commence par la ligne 0 en haut du tableau de bord. Un tableau de bord avec une mise en page de type journal a une hauteur d'élément par défaut de six lignes. Cela signifie que les éléments de tableau de bord en haut d'un tableau de bord (row: 0) occuperaient par défaut les lignes 0 à 5.

Chaque ligne mesure 50 pixels de haut, ce qui signifie que la hauteur par défaut d'un élément de six lignes est de 300 pixels.

Par exemple, le code suivant définit un élément à placer sur la deuxième ligne d'éléments du tableau de bord, en supposant que les éléments sont définis à la hauteur par défaut :

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Pour les tableaux de bord layout: newspaper, le paramètre col définit la colonne sur laquelle le bord gauche de l'élément est placé.

Les tableaux de bord sont divisés en 24 colonnes. Un tableau de bord commence par la colonne 0 à gauche. Un tableau de bord avec une mise en page de type journal a une largeur d'élément par défaut de huit colonnes. Cela signifie que les éléments de tableau de bord situés à gauche (col: 0) occuperaient par défaut les colonnes 0 à 7.

Par exemple, le code suivant définit un élément à définir dans la troisième colonne d'éléments du tableau de bord :

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

Cette section fait référence au paramètre refresh qui fait partie d'un élément de tableau de bord.

refresh peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre refresh permet à un élément de se recharger automatiquement à intervalles réguliers, ce qui permet de récupérer des données récentes. Cela est souvent utile dans les paramètres où un tableau de bord est constamment affiché, par exemple sur un téléviseur de bureau. Notez que le tableau de bord doit être ouvert dans une fenêtre de navigateur pour que ce paramètre ait un effet. Ce paramètre ne s'exécute pas en arrière-plan pour "pré-remplir" le cache du tableau de bord.

Le taux d'actualisation peut être n'importe quel nombre (sans décimales) de secondes, de minutes, d'heures ou de jours. Exemple :

- name: orders_by_date
  refresh: 2 hours

Soyez prudent lorsque vous définissez des intervalles d'actualisation courts. Si la requête à l'origine de l'élément est gourmande en ressources, certains éléments peuvent solliciter votre base de données plus que souhaité.

note

Vous pouvez ajouter des notes descriptives à des éléments comme celui-ci :

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note comporte les sous-paramètres text, state et display.

text

Le sous-paramètre text spécifie le texte affiché dans la note. Le texte peut être localisé.

state

Le sous-paramètre state détermine si la note sera collapsed ou expanded si elle est trop grande pour tenir sur une seule ligne dans la largeur de l'élément. Si vous sélectionnez collapsed et que la note est trop longue, elle se terminera par des points de suspension cliquables (...) qui permettent de lire la note complète.

display

Le sous-paramètre display détermine l'emplacement de la note sur un élément. above place la note en haut d'un élément, below la place en bas d'un élément et hover exige que l'utilisateur pointe sur l'élément pour voir la note.

Paramètres de requête

Lorsque vous définissez un élément de tableau de bord LookML, vous devez spécifier des valeurs pour au moins les paramètres de requête model et explore.

Les éléments de type: looker_boxplot nécessitent également au moins une dimension et deux, trois ou cinq des types de mesures suivants (qui doivent être listés dans cet ordre) :

• Minimum : mesure représentant la valeur de données minimale. Dans LookML, cela peut être défini comme une mesure de type: min.
• 25e centile : mesure représentant le 25e centile ou le premier quartile. Un quart de vos valeurs de données sont inférieures ou égales à cette valeur. Dans LookML, cela peut être défini comme une mesure type: percentile avec la valeur de percentile définie sur 25.
• Médiane : mesure représentant la médiane ou le point médian de l'ensemble de données, ou le deuxième quartile. La moitié de vos valeurs de données sont inférieures ou égales à cette valeur. Dans LookML, cela peut être défini comme une mesure de type: median.
• 75e centile : mesure représentant le 75e centile ou le troisième quartile. Trois quarts de vos valeurs de données sont inférieurs ou égaux à cette valeur. Dans LookML, cela peut être défini comme une mesure type: percentile avec la valeur de percentile définie sur 75.
• Maximum : mesure représentant la valeur maximale. Dans LookML, cela peut être défini comme une mesure de type: max.

Vous pouvez utiliser le paramètre fields, ou les deux paramètres dimensions et measures, pour spécifier les dimensions et les mesures sur lesquelles repose un élément du graphique en boîte. Pour savoir comment créer un graphique en boîte dans l'interface utilisateur Looker, consultez la section Créer un graphique en boîte de la page de documentation Options des graphiques en boîte.

Vous pouvez utiliser les autres paramètres de requête décrits dans cette section pour contrôler la façon dont les données sont affichées dans un élément de tableau de bord.

model

Le paramètre model définit le modèle à utiliser pour la requête d'élément. Si aucune valeur n'est spécifiée, la valeur par défaut est le modèle dans lequel réside le tableau de bord.

- name: orders_by_date
  model: ecommerce

Le paramètre model accepte les constantes LookML. Vous pouvez définir une constante dans le fichier manifeste de votre projet, puis utiliser la syntaxe "@{constant_name}" pour définir la constante comme valeur de model. L'utilisation d'une constante vous permet de définir le nom d'un modèle à un seul endroit, ce qui est particulièrement utile si vous mettez à jour le nom d'un modèle utilisé par plusieurs éléments de tableau de bord.

Pour en savoir plus et obtenir un exemple d'utilisation des constantes avec les tableaux de bord LookML, consultez la page de documentation sur le paramètre constant.

explore

Cette section fait référence au paramètre explore qui fait partie d'un élément de tableau de bord.

explore peut également être utilisé dans un modèle, comme décrit sur la page de documentation du paramètre explore.

explore peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre explore définit l'exploration à utiliser pour la requête d'élément.

- name: orders_by_date
  explore: order

Le paramètre explore accepte les constantes LookML. Vous pouvez définir une constante dans le fichier manifeste de votre projet, puis utiliser la syntaxe "@{constant_name}" pour définir la constante comme valeur de explore. L'utilisation d'une constante vous permet de définir le nom d'une exploration à un seul endroit, ce qui est particulièrement utile si vous mettez à jour le nom d'une exploration utilisée par plusieurs éléments de tableau de bord.

Pour en savoir plus et obtenir un exemple d'utilisation des constantes avec les tableaux de bord LookML, consultez la page de documentation sur le paramètre constant.

fields

Le paramètre fields définit les champs à utiliser pour la requête d'élément. Utilisez la syntaxe view_name.dimension_name pour spécifier les champs.

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

Si vous utilisez le paramètre fields, vous n'avez pas besoin d'utiliser les paramètres dimensions et measures.

dimensions

Le paramètre dimensions définit la ou les dimensions à utiliser pour la requête d'élément. Utilisez la syntaxe view_name.dimension_name pour spécifier la dimension. N'incluez pas dimensions si la requête n'en comporte pas.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

Le paramètre measures définit la ou les mesures à utiliser pour la requête d'élément. Utilisez la syntaxe view_name.measure_name pour spécifier la mesure. N'incluez pas measures si la requête n'en comporte pas.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

Le paramètre sorts définit les tris à utiliser pour la requête d'élément. Le tri principal est indiqué en premier, suivi du tri secondaire, et ainsi de suite. Utilisez la syntaxe view_name.field_name pour spécifier la dimension ou la mesure. N'incluez pas sorts si vous souhaitez utiliser l'ordre de tri par défaut de Looker. Les tris par ordre décroissant sont suivis du suffixe desc, tandis que les tris par ordre croissant n'en ont pas besoin.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

limit

Le paramètre limit définit la limite de lignes à utiliser pour la requête d'élément. Cette limite s'applique au nombre de lignes avant l'application des tableaux croisés dynamiques.

- name: orders_by_date
  limit: 100

filters

Cette section fait référence au paramètre filters qui fait partie d'un élément de tableau de bord.

filters peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

filters peut également être utilisé dans une mesure, comme décrit sur la page de documentation du paramètre filters.

Le paramètre filters définit les filtres non modifiables à utiliser pour la requête de l'élément. Si vous souhaitez que les utilisateurs puissent modifier les filtres dans le tableau de bord, vous devez les configurer à l'aide de filters pour les tableaux de bord, puis les appliquer aux éléments à l'aide de listen.

La syntaxe de filters est la suivante :

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

Chaque filtre peut accepter une expression de filtre Looker ou une constante de valeur. Vous pouvez également utiliser les variables Liquid _localization ou _user_attributes dans l'expression de filtre pour obtenir des valeurs de filtre flexibles.

listen

Les filtres de tableau de bord permettent aux lecteurs d'affiner de manière interactive les données affichées dans les éléments du tableau de bord. Définissez des filtres de tableau de bord avec le paramètre filters pour les tableaux de bord LookML. Ensuite, utilisez le paramètre listen pour associer les éléments du tableau de bord au filtre du tableau de bord.

Voici la syntaxe à utiliser pour listen :

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

Ajoutez le paramètre listen à un élément, puis indiquez le nom du filtre, suivi d'un deux-points et d'une référence au champ auquel le filtre doit s'appliquer, en utilisant la syntaxe view_name.field_name. Par exemple, vous pouvez créer un filtre appelé Date qui demande à l'utilisateur de saisir une date dans le champ de filtre de l'UI. Vous pouvez ensuite appliquer la valeur saisie par l'utilisateur à l'élément orders_by_date comme suit :

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

Pour obtenir d'autres exemples d'utilisation des paramètres filters et listen afin d'appliquer des filtres de tableau de bord à des éléments de tableau de bord individuels, consultez Créer des tableaux de bord LookML.

query_timezone

Le paramètre query_timezone spécifie le fuseau horaire dans lequel la requête sera exécutée. Les options de fuseau horaire sont indiquées sur la page de documentation Valeurs pour timezone. Si vous souhaitez que la requête s'exécute en utilisant le fuseau horaire du lecteur, vous pouvez attribuer la valeur user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

hidden_fields

Le paramètre hidden_fields indique les champs utilisés dans la requête, le cas échéant, mais masqués dans le graphique. Tous les champs masqués s'affichent dans la section "Table de données" d'une exploration.

hidden_fields: [inventory_items.count, distribution_centers.id]

Paramètres de série

color_application

Le paramètre color_application et ses sous-paramètres collection_id et palette_id peuvent être utilisés pour appliquer une collection et une palette de couleurs spécifiques à un élément de tableau de bord. Pour obtenir une présentation des collections de couleurs natives de Looker, consultez la page de documentation Collections de couleurs.

Si vous disposez de l'ID de la collection et de l'ID de la palette que vous souhaitez utiliser, vous pouvez les saisir dans les sous-paramètres collection_id et palette_id. Un ID de collection ou de palette peut être un code alphanumérique ou être basé sur le nom de la collection de couleurs. Des codes alphanumériques sont utilisés pour les collections natives de Looker. Elles sont spécifiques à l'instance et se présentent comme suit :

color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

Les collections de couleurs personnalisées utilisent des ID de collection et de palette basés sur le nom de la collection de couleurs. Elles sont portables d'une instance à l'autre et se présentent comme suit :

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

Vous pouvez également utiliser l'UI pour trouver les couleurs, les collections ou les palettes de votre choix, puis générer le code LookML pour les ajouter à votre tableau de bord. Accédez à un contenu défini par l'utilisateur (comme une présentation, un tableau de bord ou une exploration), puis appliquez les couleurs, la collection ou la palette de votre choix à la visualisation de ce contenu à l'aide de l'UI. Une fois que vous avez fait cela, vous pouvez suivre la procédure pour obtenir le LookML du tableau de bord, copier le LookML produit et le coller dans la section color_application.

Par défaut, la première couleur de la palette désignée est appliquée à l'ensemble de l'élément "boxplot". Le sous-paramètre facultatif reverse permet de passer à la dernière couleur de la palette.

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0
  options:
    reverse: true

Paramètres de style

show_view_names

Le paramètre show_view_names détermine si les noms de vues sont affichés dans les libellés des graphiques, tels que les noms d'axes et de colonnes.

show_view_names: true | false

## default value: true

Paramètres de l'axe X

show_x_axis_label

Ce paramètre détermine si le libellé de l'axe X est affiché.

show_x_axis_label: true | false

## default value: true

x_axis_label

Ce paramètre spécifie un libellé pour l'axe X. Vous pouvez utiliser ce paramètre lorsque show_x_axis_label est défini sur true.

x_axis_label: Order Date

show_x_axis_ticks

Ce paramètre détermine si les libellés de valeurs sont affichés sur l'axe X.

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

Ce paramètre détermine si les lignes de la grille sont étendues à partir de l'axe X.

x_axis_gridlines: true | false

## default value: false

x_axis_reversed

Ce paramètre définit la direction de l'axe X. Lorsque x_axis_reversed est défini sur false, les valeurs augmentent de gauche à droite. Lorsque ce paramètre est défini sur true, les valeurs diminuent de gauche à droite.

x_axis_reversed: true | false

x_axis_zoom

Ce paramètre indique si les utilisateurs peuvent zoomer sur l'axe X de la visualisation. Lorsque x_axis_zoom est défini sur true, le zoom est disponible. Lorsque x_axis_zoom est défini sur false, le zoom n'est pas disponible.

Si x_axis_zoom est défini sur false, y_axis_zoom est désactivé.

x_axis_zoom: true | false

# default value: true

Paramètres de l'axe Y

show_y_axis_labels

Ce paramètre détermine si les libellés sont affichés sur l'axe y.

show_y_axis_labels: true | false

## default value: true

y_axis_labels

Ce paramètre spécifie un libellé pour l'axe Y. Vous pouvez utiliser ce paramètre lorsque show_y_axis_labels est défini sur true.

y_axis_labels: ['label']

show_y_axis_ticks

Ce paramètre détermine si les valeurs sont affichées sur l'axe Y.

show_y_axis_ticks: true | false

## default value: true

y_axis_gridlines

Ce paramètre détermine si les lignes de la grille sont étendues à partir de l'axe Y.

y_axis_gridlines: true | false

## default value: true

y_axis_min

Ce paramètre définit la valeur minimale de l'axe Y.

y_axis_min: ['10']

## default value: true

y_axis_max

Ce paramètre définit la valeur maximale de l'axe Y.

y_axis_max: ['100']

## default value: true

y_axis_tick_density

Ce paramètre permet de définir une densité de graduation de l'axe Y. Définissez y_axis_tick_density sur custom pour activer cette fonctionnalité, puis utilisez le paramètre y_axis_tick_density_custom pour définir la densité.

y_axis_tick_density: default | custom

## default value: default

y_axis_tick_density_custom

Ce paramètre vous permet de définir la densité des graduations de l'axe Y si y_axis_tick_density est défini sur custom. Elle accepte un entier représentant le nombre de graduations que vous souhaitez afficher.

y_axis_tick_density_custom: 10

## default value: 5

y_axis_reversed

Ce paramètre définit la direction de l'axe Y. Lorsque y_axis_reversed est défini sur false, les valeurs augmentent en montant sur l'axe. Lorsqu'il est défini sur true, les valeurs diminuent en descendant l'axe.

## y_axis_reversed: true | false

# default value: false

y_axis_value_format

Ce paramètre spécifie le format numérique des valeurs de l'axe Y, indépendamment de la dimension ou de la mesure sous-jacente. Le paramètre accepte la mise en forme de type Excel. Si aucun format n'est spécifié, la valeur s'affiche dans le format de la dimension ou de la mesure sous-jacente.

La valeur que vous spécifiez pour le paramètre y_axis_value_format doit être placée entre guillemets doubles :

y_axis_value_format: "*00#.00"

Pour savoir comment spécifier ces formats, consultez le guide complet d'Excel dans sa documentation. Néanmoins, la mise en forme des dates et des couleurs ne sont pas prises en charge dans Looker pour le moment.

Voici quelques-unes des options de mise en forme les plus courantes :

Format de valeur	Signification
#	Entier (123)
*00#	Entier complété par des zéros dans 3 emplacements (001)
0.##	Nombre jusqu'à 2 décimales (1, ou 1,2 ou 1,23)
0.00	Nombre avec exactement 2 décimales (1,23)
*00#.00	Nombre complété par des zéros dans 3 emplacements et exactement 2 décimales (01,23)
#,###	Nombre dont les milliers sont séparés par une virgule (1,234)
#,##0.00	Nombre dont les milliers sont séparés par une virgule et 2 décimales (1,234.00)
0.000,," M"	Nombre exprimé en millions avec 3 décimales (1.234 M). La division par 1 million s'effectue automatiquement.
$#	Dollars avec 0 décimale (123 $)
$0.00	Dollars avec 2 décimales (123,00 $)
$#,##0.00	Dollars dont les milliers sont séparés par une virgule et 2 décimales (1,234.00 $)
#%	Pourcentage avec 0 décimale (1 %). La multiplication par 100 s'effectue automatiquement.
0.00%	Pourcentage avec deux décimales (1,00 %). La multiplication par 100 s'effectue automatiquement.
0.00\%	Pourcentage avec deux décimales (1,00 %). La multiplication par 100 ne s'effectue PAS automatiquement.

y_axis_zoom

Ce paramètre indique si les utilisateurs peuvent zoomer sur l'axe Y de la visualisation. Lorsque y_axis_zoom est défini sur true, le zoom est disponible.

Lorsque y_axis_zoom est défini sur false, les utilisateurs ne peuvent pas faire de zoom avant sur de plus petites portions de l'axe Y. Toutefois, les utilisateurs peuvent toujours faire un zoom avant sur des portions plus petites de l'axe X si le paramètre x_axis_zoom est défini sur true.

Si x_axis_zoom est défini sur false, y_axis_zoom est désactivé.

y_axis_zoom: true | false

# default value: true

Configuration avancée de la visualisation

Les paramètres décrits dans cette section correspondent aux remplacements de configuration de graphique facultatifs, que vous pouvez appliquer à un graphique en cliquant sur le bouton Modifier la configuration du graphique dans la section Tracer de l'éditeur de visualisations.

advanced_vis_config

Ce paramètre accepte un extrait de code JSON HighCharts qui remplace plusieurs paramètres de visualisation et ouvre de nouvelles possibilités. Consultez la page de documentation Personnaliser les visualisations à l'aide de l'éditeur de configuration des graphiques pour obtenir des exemples d'utilisation de HighCharts JSON dans des cas d'utilisation courants.

advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null