Parâmetros de diagrama de caixa para dashboards do LookML

Nesta página, mostramos como adicionar e personalizar um elemento de dashboard do LookML de type: looker_boxplot com parâmetros de dashboard do LookML em um arquivo dashboard.lkml.

Para saber como criar um gráfico de caixa na interface do Looker, consulte a página de documentação Opções de gráfico de caixa.

Exemplo de uso

Um N indica que um valor numérico é obrigatório. As aspas simples indicam texto descritivo e não devem ser incluídas no código ativo.


## 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'

Definições de parâmetro

Nome do parâmetro Descrição
Parâmetros básicos
name (para elementos) Cria um elemento
title (para elementos) Muda como o nome de um elemento aparece para os usuários.
type (para elementos) Determina o tipo de visualização a ser usado no elemento.
height (para elementos) Define a altura de um elemento, em unidades de tile_size, para dashboards layout: tile e layout: static.
width (para elementos) Define a largura de um elemento, em unidades de tile_size, para dashboards layout: tile e layout: static.
top Define a posição de cima para baixo de um elemento, em unidades de tile_size, para dashboards layout: static.
left Define a posição da esquerda para a direita de um elemento, em unidades de tile_size, para dashboards layout: static.
row Define a posição de cima para baixo de um elemento, em unidades de linhas, para dashboards layout: newspaper.
col Define a posição da esquerda para a direita de um elemento, em unidades de colunas, para dashboards layout: newspaper.
refresh (para elementos) Define o intervalo de atualização automática do elemento.
note Inicia uma seção do LookML para definir uma observação para um elemento. Esse parâmetro tem os subparâmetros text, state e display.
Parâmetros de consulta
model Define o modelo a ser usado para a consulta do elemento
explore (para elementos) Define a Análise que será usada para a consulta do elemento
fields Define os campos que serão usados para a consulta do elemento. Isso pode ser usado no lugar de dimensions e measures.
dimensions Define as dimensões a serem usadas para a consulta do elemento
measures Define as medidas a serem usadas para a consulta do elemento
sorts Define as classificações a serem usadas para a consulta do elemento
limit Define o limite de linhas a ser usado na consulta do elemento
filters (para elementos) Define os filtros que não podem ser alterados para a consulta do elemento.
listen Define os filtros que podem ser alterados para a consulta do elemento, se filters (para o painel) tiverem sido criados
query_timezone Define o fuso horário que será usado quando a consulta for executada.
hidden_fields Especifica os campos que serão usados na consulta, mas ocultados no gráfico.
Parâmetros de série
color_application Aplica uma coleção de cores e uma paleta ao gráfico.
Parâmetros de estilo
show_view_names Mostra ou oculta os nomes das visualizações nos rótulos do gráfico.
Parâmetros do eixo X
show_x_axis_label Mostra ou oculta o rótulo do eixo X.
x_axis_label Define um rótulo personalizado para o eixo X
show_x_axis_ticks Mostra valores no eixo x
x_axis_gridlines Estende as linhas de grade do eixo X
x_axis_reversed Inverte a direção do eixo x.
x_axis_zoom Especifica se é permitido aplicar zoom ao longo do eixo x
Parâmetros do eixo Y
show_y_axis_labels Mostra ou oculta o rótulo do eixo Y.
y_axis_labels Define um rótulo personalizado para o eixo Y.
show_y_axis_ticks Mostra valores no eixo y
y_axis_gridlines Estende as linhas de grade do eixo Y
y_axis_min Define um valor mínimo para o eixo Y.
y_axis_max Define um valor máximo para o eixo Y.
y_axis_tick_density Ativa a opção de definir uma densidade personalizada de marcações do eixo Y com o parâmetro y_axis_tick_density_custom
y_axis_tick_density_custom Define a densidade das marcas do eixo Y quando y_axis_tick_density está definido como custom.
y_axis_reversed Inverte a direção do eixo Y.
y_axis_value_format Define o formato numérico dos valores do eixo Y
y_axis_zoom Especifica se é permitido aplicar zoom ao longo do eixo y. Desativado se x_axis_zoom: false.
Parâmetros de configuração de visualização avançada
advanced_viz_config Aceita um snippet JSON do HighCharts que pode substituir várias configurações de visualização.

Parâmetros básicos

Ao definir um elemento de dashboard do LookML, é preciso especificar valores para pelo menos os parâmetros básicos name e type. Outros parâmetros básicos, como title, height e width, afetam a aparência e a posição de um elemento em um painel.

name

Esta seção se refere ao parâmetro name que faz parte de um elemento do dashboard.

name também pode ser usado como parte de um filtro de painel, descrito na página de documentação Parâmetros do painel.

Cada declaração name cria um novo elemento do dashboard e atribui um nome a ele. Os nomes dos elementos precisam ser exclusivos. Às vezes, os nomes são referenciados no parâmetro elements quando você usa painéis layout: grid ou no parâmetro group de elementos filhos ao organizar elementos em um grupo de blocos (type: group).

- name: orders_by_date

title

Esta seção se refere ao parâmetro title que faz parte de um elemento do dashboard.

title também pode ser usado como parte de um painel, descrito na página de documentação Parâmetros do painel.

title também pode ser usado como parte de um filtro de painel, descrito na página de documentação Parâmetros do painel.

O parâmetro title permite mudar como o nome de um elemento aparece para os usuários. Se não for especificado, o título padrão será o elemento name.

Por exemplo,

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

Se você usasse esse formato, em vez de o elemento aparecer como Visão geral de vendas, ele apareceria como 1) Visão geral de vendas.

type

Esta seção se refere ao parâmetro type que faz parte de um elemento do dashboard.

type também pode ser usado como parte de um filtro de painel, descrito na página de documentação Parâmetros do painel.

type também pode ser usado como parte de uma mesclagem, descrita na página de documentação do parâmetro type (para mesclagens).

type também pode ser usado como parte de uma dimensão, descrita na página de documentação Tipos de dimensão, filtro e parâmetro.

type também pode ser usado como parte de uma medida, descrita na página de documentação Tipos de medida.

O parâmetro type determina o tipo de visualização que será usado no elemento.

- 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 | button | group

Consulte a página de documentação type (para dashboards do LookML) para uma visão geral dos diferentes tipos de elementos de dashboard do LookML.

height

Esta seção se refere ao parâmetro height que faz parte de um elemento do dashboard.

height também pode ser usado como parte de uma linha do painel, descrita na página de documentação Parâmetros do painel.

Para painéis com layouts tile ou static

O parâmetro height define a altura de um elemento, em unidades de tile_size (definido em pixels), para dashboards layout: tile e layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e height: 4, fazendo com que o elemento orders_by_date tenha 400 pixels de altura.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Para painéis com layout newspaper

O parâmetro height define a altura de um elemento, em unidades de linha, para dashboards layout: newspaper.

Um painel com layout de jornal tem como padrão uma altura de elemento de 6 linhas, ou cerca de 300 pixels. A altura mínima é de 1 linha para painéis com um parâmetro preferred viewer definido como dashboards-next. A altura mínima é de duas linhas para dashboards com um parâmetro preferred viewer definido como dashboards.

Por exemplo, o código a seguir define um elemento com 12 linhas de altura, ou o dobro da altura de outros elementos definidos como padrão:

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

Esta seção se refere ao parâmetro width que faz parte de um elemento do dashboard.

width também pode ser usado como parte de um painel, descrito na página de documentação Parâmetros do painel.

O parâmetro width define a largura de um elemento, em unidades de tile_size, para dashboards layout: tile e layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e width: 4, fazendo com que o elemento orders_by_date tenha 400 pixels de largura.

- dashboard: sales_overview
  tile_size: 100
  ...

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

O parâmetro width define a largura de um elemento, em unidades de colunas, para dashboards layout: newspaper.

Um painel com layout de jornal tem uma largura padrão de 24 colunas.

Por exemplo, o código a seguir define o elemento como metade da largura do painel:

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

O parâmetro top define a posição de cima para baixo de um elemento, em unidades de tile_size, para painéis layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e top: 4, posicionando a borda superior do elemento orders_by_date a 400 pixels da parte de cima do painel.

- dashboard: sales_overview
  tile_size: 100
  ...

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

left

O parâmetro left define a posição da esquerda para a direita de um elemento, em unidades de tile_size, para painéis layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e left: 4, posicionando a borda esquerda do elemento orders_by_date a 400 pixels do lado esquerdo do painel.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Para painéis layout: newspaper, o parâmetro row define a linha em que a borda superior de um elemento é colocada. Se o elemento for colocado dentro de um grupo de blocos usando o parâmetro group, row vai definir a posição da linha do elemento em relação à parte de cima do contêiner do grupo (row: 0).

Um painel começa com a linha 0 na parte de cima. Um dashboard com layout de jornal tem como padrão uma altura de elemento de 6 linhas, o que significa que os elementos do dashboard na parte de cima de um dashboard (row: 0) ocupam as linhas de 0 a 5 por padrão.

Cada linha tem 50 pixels de altura, o que significa que a altura padrão do elemento de 6 linhas é de 300 pixels.

Por exemplo, o código a seguir define um elemento na segunda linha de elementos do painel, supondo que os elementos estejam definidos com a altura padrão:

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Para dashboards layout: newspaper, o parâmetro col define a coluna em que a borda esquerda do elemento é colocada. Se o elemento for colocado dentro de um grupo de blocos usando o parâmetro group, col vai definir a posição da coluna do elemento em relação à borda esquerda do contêiner do grupo (col: 0).

Os painéis são divididos em 24 colunas. Um painel começa com a coluna 0 à esquerda. Um dashboard com layout de jornal tem como padrão uma largura de elemento de 8 colunas, o que significa que os elementos do dashboard à esquerda de um dashboard (col: 0) ocupam as colunas de 0 a 7.

Por exemplo, o código a seguir define um elemento para ser colocado na terceira coluna de elementos no painel:

- dashboard: sales_overview
  layout: newspaper
  ...

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

refresh

Esta seção se refere ao parâmetro refresh que faz parte de um elemento do dashboard.

refresh também pode ser usado como parte de um painel, descrito na página de documentação Parâmetros do painel.

O parâmetro refresh permite que um elemento seja recarregado automaticamente de forma periódica, recuperando dados atualizados. Isso costuma ser útil em configurações em que um painel é exibido constantemente, como em uma TV de escritório. O painel precisa estar aberto em uma janela do navegador para que esse parâmetro tenha efeito. Essa configuração não é executada em segundo plano para "pré-aquecer" o cache do painel.

A taxa de atualização pode ser qualquer número (sem decimais) de segundos, minutos, horas ou dias. Exemplo:

- name: orders_by_date
  refresh: 2 hours

Tenha cuidado ao definir intervalos de atualização curtos. Se a consulta por trás do elemento exigir muitos recursos, alguns elementos poderão sobrecarregar o banco de dados mais do que o desejado.

note

Você pode adicionar notas descritivas a elementos como este:

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

note tem os subparâmetros text, state e display.

text

O subparâmetro text especifica o texto exibido na observação. O texto pode ser localizado.

state

O subparâmetro state determina se a nota será collapsed ou expanded se for muito grande para caber em uma única linha dentro da largura do elemento. Se você escolher collapsed e a nota for muito longa, ela vai terminar com reticências clicáveis (...) que podem ser usadas para ler a nota completa.

display

O subparâmetro display determina onde a nota é exibida em um elemento. above coloca a nota na parte de cima de um elemento, below coloca na parte de baixo e hover exige que o usuário passe o mouse sobre o elemento para ver a nota.

Parâmetros de consulta

Ao definir um elemento do dashboard do LookML, é preciso especificar valores para pelo menos os parâmetros de consulta model e explore.

Os elementos de type: looker_boxplot também exigem pelo menos uma dimensão e dois, três ou cinco dos seguintes tipos de medições (que precisam ser listados nesta ordem):

  • Mínimo: uma medida que representa o valor mínimo dos dados. Isso pode ser definido no LookML como uma medida de type: min.
  • 25º percentil: uma medida que representa o 25º percentil ou o primeiro quartil. Um quarto dos valores de dados é menor ou igual a esse valor. Isso pode ser definido no LookML como uma medida de type: percentile com o valor de percentile definido como 25.
  • Mediana: uma medida que representa a mediana ou o ponto médio do conjunto de dados, ou o segundo quartil. Metade dos valores de dados é menor ou igual a esse valor. Isso pode ser definido no LookML como uma medida de type: median.
  • 75º percentil: uma medida que representa o 75º percentil ou o terceiro quartil. Três quartos dos valores de dados são menores ou iguais a esse valor. Isso pode ser definido no LookML como uma medida de type: percentile com o valor de percentile definido como 75.
  • Máximo: uma medida que representa o valor máximo. Isso pode ser definido no LookML como uma medida de type: max.

É possível usar o parâmetro fields ou os parâmetros dimensions e measures para especificar as dimensões e medidas em que um elemento de diagrama de caixa se baseia. Consulte a seção Como criar um gráfico de caixa da página de documentação Opções de gráfico de caixa para mais informações sobre como criar um gráfico de caixa na interface do Looker.

É possível usar os outros parâmetros de consulta descritos nesta seção para controlar como os dados são exibidos em um elemento do dashboard.

model

O parâmetro model define o modelo a ser usado para a consulta de elementos. Se não for especificado, o padrão será o modelo em que o painel está.

- name: orders_by_date
  model: ecommerce

O parâmetro model aceita constantes do LookML. É possível definir uma constante no arquivo de manifesto do projeto e usar a sintaxe "@{constant_name}" para definir a constante como o valor de model. Com uma constante, você pode definir o nome de um modelo em um só lugar, o que é muito útil se você estiver atualizando o nome de um modelo usado por vários elementos do dashboard.

Para mais informações e um exemplo de uso de constantes com dashboards do LookML, consulte a página de documentação do parâmetro constant.

explore

Esta seção se refere ao parâmetro explore que faz parte de um elemento do dashboard.

explore também pode ser usado como parte de um modelo, descrito na página de documentação do parâmetro explore.

explore também pode ser usado como parte de um filtro de painel, descrito na página de documentação Parâmetros do painel.

O parâmetro explore define a Análise que será usada para a consulta do elemento.

- name: orders_by_date
  explore: order

O parâmetro explore aceita constantes do LookML. É possível definir uma constante no arquivo de manifesto do projeto e usar a sintaxe "@{constant_name}" para definir a constante como o valor de explore. Com uma constante, você pode definir o nome de uma Análise em um só lugar, o que é muito útil se você estiver atualizando o nome de uma Análise usada por vários elementos do dashboard.

Para mais informações e um exemplo de uso de constantes com dashboards do LookML, consulte a página de documentação do parâmetro constant.

fields

O parâmetro fields define os campos a serem usados na consulta de elementos. Use a sintaxe view_name.dimension_name para especificar os campos.

## 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]

Se você usar o parâmetro fields, não será necessário usar os parâmetros dimensions e measures.

dimensions

O parâmetro dimensions define as dimensões que serão usadas na consulta de elementos. Use a sintaxe view_name.dimension_name para especificar a dimensão. Não inclua dimensions se a consulta não tiver nenhum.

## 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

O parâmetro measures define as medidas que serão usadas na consulta de elemento. Use a sintaxe view_name.measure_name para especificar a métrica. Não inclua measures se a consulta não tiver nenhum.

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

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

sorts

O parâmetro sorts define o comportamento de classificação para a consulta do elemento. Liste primeiro o campo de classificação principal, seguido pelos campos secundários. Use a sintaxe view_name.field_name para especificar a dimensão ou medida pela qual classificar.

Se você omitir o parâmetro sorts, o elemento vai usar a ordem de classificação padrão do Looker. As classificações crescentes não exigem um sufixo, enquanto as decrescentes exigem o sufixo desc.

O exemplo a seguir define uma única classificação:

- name: orders_by_date
  sorts: order.order_date desc

O exemplo a seguir define várias classificações:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

Se você dinamizar as dimensões, poderá classificar os resultados da consulta especificando o nome da medida, a direção da classificação e o número do índice baseado em 0 da coluna de destino na tabela de dados. Por exemplo, o elemento a seguir classifica pela primeira coluna dinâmica usando o índice 0:

- name: orders_by_category
  sorts: [orders.count desc 0]

Para classificar pelo total da linha, especifique o índice da coluna de totais. Por exemplo, o elemento a seguir classifica pelo total da linha usando o índice 2, que representa a coluna de totais de uma consulta com duas colunas dinâmicas:

- name: orders_by_cohort
  sorts: [users.count desc 2]

limit

O parâmetro limit define o limite de linhas que deve ser usado para a consulta de elementos. O limite se aplica ao número de linhas antes da aplicação de qualquer tabela dinâmica.

- name: orders_by_date
  limit: 100

filters

Esta seção se refere ao parâmetro filters que faz parte de um elemento do dashboard.

filters também pode ser usado como parte de um painel, descrito na página de documentação Parâmetros do painel.

filters também pode ser usado como parte de uma medição, descrita na página de documentação do parâmetro filters.

O parâmetro filters define os filtros não alteráveis que devem ser usados para a consulta do elemento. Se você quiser filtros que um usuário possa alterar no painel, configure-os usando filters para painéis e aplique-os aos elementos usando listen.

A sintaxe de filters é:

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

Cada filtro pode aceitar uma expressão de filtro do Looker ou uma constante de valor. Também é possível usar as variáveis líquidas _localization ou _user_attributes na expressão de filtro para valores de filtro flexíveis.

listen

Com os filtros de dashboard, os leitores podem refinar de forma interativa os dados mostrados nos elementos do dashboard. Defina filtros de dashboard com o parâmetro filters para dashboards do LookML. Em seguida, use o parâmetro listen para vincular elementos do dashboard ao filtro.

A sintaxe de listen é a seguinte:

- 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

Adicione o parâmetro listen a um elemento e, em seguida, forneça o nome do filtro seguido por dois-pontos e uma referência ao campo ao qual o filtro deve ser aplicado, usando a sintaxe view_name.field_name. Por exemplo, você pode criar um filtro chamado Data que exige que o usuário insira uma data no campo de filtro na UI. Em seguida, você pode aplicar o valor inserido pelo usuário ao elemento orders_by_date desta forma:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

Se o filtro que está sendo ouvido estiver configurado com o parâmetro vis_filter: true, o controle de filtro vai aparecer em uma barra de filtro diretamente na parte de cima do bloco de visualização, em vez de na barra de filtro do painel na parte de cima.

Para mais exemplos de como usar os parâmetros filters e listen para aplicar filtros de dashboard a elementos individuais, consulte Como criar dashboards do LookML.

query_timezone

O parâmetro query_timezone especifica o fuso horário em que a consulta será executada. As opções de fuso horário são mostradas na página de documentação Valores para timezone. Se você quiser que a consulta seja executada usando o fuso horário do espectador, atribua o valor como user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

hidden_fields

O parâmetro hidden_fields indica quais campos, se houver, são usados na consulta, mas ocultos no gráfico. Todos os campos ocultos vão aparecer na seção da tabela de dados de uma Análise.

hidden_fields: [inventory_items.count, distribution_centers.id]

Parâmetros de série

color_application

O parâmetro color_application e os subparâmetros collection_id e palette_id podem ser usados para aplicar uma coleção e uma paleta de cores específicas a um elemento do dashboard. Para uma visão geral das coleções de cores nativas do Looker, consulte a página de documentação Coleções de cores.

Se você tiver o ID da coleção e o ID da paleta que quer usar, insira esses IDs nos subparâmetros collection_id e palette_id. O ID de uma coleção ou paleta pode ser um código alfanumérico ou se basear no nome da coleção de cores. Os códigos alfanuméricos são usados para as coleções nativas do Looker. Eles são específicos da instância e têm esta aparência:


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

As coleções de cores personalizadas usam IDs de coleção e paleta com base no nome da coleção de cores, que são portáteis entre instâncias e têm esta aparência:


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

Você também pode usar a UI para encontrar as cores, coleções ou paletas que quiser e gerar o LookML para adicioná-las ao painel. Acesse um conteúdo definido pelo usuário (como um Look, um dashboard ou uma Análise) e aplique as cores, a coleção ou a paleta que você quer à visualização desse conteúdo usando a UI. Depois, siga as etapas para acessar o LookML do dashboard, copie o LookML produzido e cole-o na seção color_application.

Por padrão, a primeira cor da paleta designada é aplicada a todo o elemento do boxplot. O subparâmetro opcional reverse muda o aplicativo para a última cor da paleta.

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

Parâmetros de estilo

show_view_names

O parâmetro show_view_names determina se os nomes das visualizações são mostrados nos rótulos do gráfico, como nomes de eixos e de colunas.

show_view_names: true | false

## default value: true

Parâmetros do eixo X

show_x_axis_label

Esse parâmetro determina se o rótulo do eixo x é mostrado.

show_x_axis_label: true | false

## default value: true

x_axis_label

Esse parâmetro especifica um rótulo para o eixo x. É possível usar esse parâmetro quando show_x_axis_label está definido como true.

x_axis_label: Order Date

show_x_axis_ticks

Esse parâmetro determina se os rótulos de valor são mostrados no eixo X.

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

Esse parâmetro determina se as linhas de grade são estendidas do eixo x.

x_axis_gridlines: true | false

## default value: false

x_axis_reversed

Esse parâmetro define a direção do eixo x. Quando x_axis_reversed é definido como false, os valores aumentam da esquerda para a direita. Quando definido como true, os valores diminuem da esquerda para a direita.


x_axis_reversed: true | false

x_axis_zoom

Esse parâmetro especifica se os usuários podem ampliar o eixo x da visualização. Quando x_axis_zoom está definido como true, o zoom está disponível. Quando x_axis_zoom é definido como false, o zoom não fica disponível.

Se x_axis_zoom estiver definido como false, y_axis_zoom será desativado.

x_axis_zoom: true | false

# default value: true

Parâmetros do eixo Y

show_y_axis_labels

Esse parâmetro determina se os rótulos são mostrados no eixo Y.

show_y_axis_labels: true | false

## default value: true

y_axis_labels

Esse parâmetro especifica um rótulo para o eixo y. É possível usar esse parâmetro quando show_y_axis_labels está definido como true.

y_axis_labels: ['label']

show_y_axis_ticks

Esse parâmetro determina se os valores são mostrados no eixo y.

show_y_axis_ticks: true | false

## default value: true

y_axis_gridlines

Esse parâmetro determina se as linhas de grade são estendidas do eixo y.

y_axis_gridlines: true | false

## default value: true

y_axis_min

Esse parâmetro define o valor mínimo para o eixo y.

y_axis_min: ['10']

## default value: true

y_axis_max

Esse parâmetro define o valor máximo para o eixo y.

y_axis_max: ['100']

## default value: true

y_axis_tick_density

Esse parâmetro permite definir uma densidade de marcações do eixo Y. Defina y_axis_tick_density como custom para ativar esse recurso e use o parâmetro y_axis_tick_density_custom para definir a densidade.

y_axis_tick_density: default | custom

## default value: default

y_axis_tick_density_custom

Esse parâmetro permite definir a densidade das marcações do eixo y, se y_axis_tick_density estiver definido como custom. Ele aceita um número inteiro que representa o número de marcações que você quer que apareçam.

y_axis_tick_density_custom: 10

## default value: 5

y_axis_reversed

Esse parâmetro define a direção do eixo y. Quando y_axis_reversed é definido como false, os valores aumentam ao subir no eixo. Quando definido como true, os valores diminuem ao longo do eixo.


## y_axis_reversed: true | false

# default value: false

y_axis_value_format

Esse parâmetro especifica o formato numérico dos valores do eixo Y, independentemente da dimensão ou métrica subjacente. O parâmetro aceita formatação no estilo do Excel. Se nenhuma formatação for especificada, o valor será exibido no formato da dimensão ou medida subjacente.

O valor especificado para o parâmetro y_axis_value_format precisa estar entre aspas duplas:


y_axis_value_format: "*00#.00"

Leia o guia completo do Excel sobre como especificar esses formatos na documentação. No entanto, no momento, a formatação de data e de cor não é compatível com o Looker.

Confira algumas das opções de formatação mais comuns:

Formato do valor Significado
# Número inteiro (123)
*00# Número inteiro preenchido com zeros até três casas (001)
0.## Número com até duas casas decimais (1., 1.2 ou 1.23)
0.00 Número com exatamente duas casas decimais (1,23)
*00#.00 Número preenchido com zeros até três casas e exatamente duas casas decimais (01,23)
#,### Número com vírgula entre milhares (1,234)
#,##0.00 Número com vírgula entre milhares e duas casas decimais (1.234,00)
0.000,," M" Número em milhões com três casas decimais (1,234 M). A divisão por 1 milhão acontece automaticamente.
$# Dólares sem casas decimais ($123)
$0.00 Dólares com duas casas decimais (US$ 123,00)
$#,##0.00 Dólares com vírgula entre milhares e duas casas decimais ($1,234.00)
#% Porcentagem com zero casas decimais (1%). A multiplicação por 100 acontece automaticamente.
0.00% Porcentagem com duas casas decimais (1,00%). A multiplicação por 100 acontece automaticamente.
0.00\% Porcentagem com duas casas decimais (1,00%). A multiplicação por 100 NÃO acontece automaticamente.

y_axis_zoom

Esse parâmetro especifica se os usuários podem ampliar o eixo y da visualização. Quando y_axis_zoom está definido como true, o zoom está disponível.

Quando y_axis_zoom é definido como false, os usuários não podem ampliar partes menores do eixo y. No entanto, os usuários ainda poderão ampliar partes menores do eixo x se o parâmetro x_axis_zoom estiver definido como true.

Se x_axis_zoom estiver definido como false, y_axis_zoom será desativado.

y_axis_zoom: true | false

# default value: true

Configuração de visualização avançada

Os parâmetros descritos nesta seção correspondem às substituições opcionais de configuração do gráfico, que podem ser aplicadas a um gráfico clicando no botão Editar configuração do gráfico na seção Gráfico do editor de visualização.

advanced_vis_config

Esse parâmetro aceita um snippet JSON do HighCharts que substitui várias configurações de visualização e abre novos recursos. Consulte a página de documentação Como personalizar visualizações usando o editor de configuração de gráficos para ver exemplos de como usar o JSON do HighCharts para casos de uso comuns.


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