Parâmetros do dashboard do LookML

Os painéis podem ser criados de duas maneiras. Os painéis definidos pelo usuário são criados com a interface do Looker e descritos na página de documentação Como criar painéis definidos pelo usuário. Os painéis também podem ser criados usando o LookML e ter as configurações gerais modificadas, conforme discutido nesta página.

Esta página descreve os parâmetros do painel do LookML que afetam todo o painel.

Um painel do LookML também contém elementos, que são as visualizações de dados, os blocos de texto e os botões no painel. Consulte a página Parâmetros de elementos do painel para ver links para as páginas de referência de cada tipo de elemento.

Exemplo de uso

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  extends: name_of_dashboard_being_extended
  extension: required
  layout: tile | static | grid | newspaper
  rows:
    - elements: [element_name, element_name, ...]
      height: N
  tile_size: N
  width: N
  refresh: N (seconds | minutes | hours | days)
  auto_run: true | false

  # DASHBOARD FILTER PARAMETERS
  crossfilter_enabled: true | false
  filters_bar_collapsed: true | false
  filters_location_top: true | false
  filters:
  - name: filter_name
    title: "chosen filter title"
    type: field_filter | number_filter | date_filter | string_filter
    model: model_name
    explore: explore_name
    field: view_name.field_name
    default_value: Looker filter expression
    allow_multiple_values: true | false
    required: true | false
    ui_config:
      type: button_group | checkboxes | range_slider | tag_list | radio_buttons |
            button_toggles | dropdown_menu | slider | day_picker | day_range_picker |
            relative_timeframes | advanced
      display: inline | popover | overflow
      options:
        min: N
        max: N
      - value options
    listens_to_filters:
    - filter_name
      field: view_name.field_name

  # EMBEDDED DASHBOARD PARAMETERS
  embed_style:
    background_color: "css_color"
    show_title: true | false
    title_color: "css_color"
    show_filters_bar: true | false
    tile_background_color: "css_color"
    tile_text_color: "css_color"

  # ELEMENTS PARAMETERS
  elements:
  # One or more element declarations

Definições de parâmetro

Nome do parâmetro	Descrição
dashboard	Crie um painel.
preferred_viewer	Esse parâmetro é ignorado.
title (para painel)	Mudar a forma como o nome de um painel aparece para os usuários.
description (para painel)	Adicione uma descrição que pode ser visualizada no painel Detalhes do painel ou em uma pasta definida como visualização em lista.
enable_viz_full_screen	Defina se os leitores do painel podem ver os blocos em tela cheia e visualizações expandidas.
extends	Basear o dashboard do LookML em outro dashboard do LookML.
extension	Exige a extensão do dashboard com outro dashboard.
layout	Defina a maneira como o painel vai posicionar os elementos.
rows	Inicie uma seção do LookML para definir os elementos que devem entrar em cada linha de um dashboard layout: grid.
elements (para linhas)	Defina os elementos que devem entrar em uma linha de um painel layout: grid.
height (para linhas)	Defina a altura de uma linha para um dashboard layout: grid.
tile_size	Defina o tamanho de um bloco para um dashboard layout: tile.
width (para painel)	Defina a largura do dashboard para um dashboard layout: static.
refresh (para painel)	Defina o intervalo em que os elementos do painel serão atualizados automaticamente.
auto_run	Determina se os dashboards são executados de modo automático quando são abertos ou recarregados.
Parâmetros de filtro
crossfilter_enabled	Ative ou desative o cruzamento de filtros em um painel.
filters_bar_collapsed	Adicionado na versão 21.16 Defina a barra de filtros do painel como recolhida ou expandida por padrão.
filters_location_top	Adicionado em 22.8 Defina a localização da barra de filtros do painel como acima ou à direita.
filters (para painel)	Inicie uma seção do LookML para definir filtros de painel.
name (para filtros)	Criar um filtro.
title (para filtros)	Mude a forma como um nome de filtro aparece para os usuários.
type (para filtros)	Determine o tipo de filtro a ser usado.
default_value	Defina um valor padrão para um filtro.
allow_multiple_values	Limitar os usuários a um único valor de filtro.
required	Exigir que os usuários insiram um valor de filtro para executar o painel.
ui_config	Configure os controles de filtro disponíveis quando os usuários visualizam um painel do LookML. Tem subparâmetros type, display e options.
model (para filtros)	Especifique o modelo que contém o campo subjacente de um filtro type: field_filter.
explore (para filtros)	Especifique a análise detalhada que contém o campo subjacente de um filtro type: field_filter.
field	Especifica o campo subjacente de um filtro type: field_filter.
listens_to_filters	Restringe as sugestões de filtros do painel de field_filter com base no que o usuário insere para outros filtros do painel de type: field_filter.
Parâmetros do painel incorporado
embed_style	Inicie uma seção do LookML para definir personalizações de painéis incorporados.
background_color	Definir a cor de plano de fundo de um painel incorporado.
show_title	Especifique se o título do painel está visível em um painel incorporado.
title_color	Defina a cor do título de um painel incorporado.
show_filters_bar	Especifique se a barra de filtros está visível em um painel incorporado.
tile_background_color	Defina a cor do plano de fundo do bloco de um painel incorporado.
tile_text_color	Defina a cor do texto do bloco de um painel incorporado.
Parâmetros de elemento
elements (para painel)	Inicie uma seção do LookML para definir elementos do painel.

dashboard

O parâmetro dashboard declara um novo painel e especifica um nome para ele. O número máximo de caracteres é 255, e os caracteres permitidos são letras (A-Z), números (0-9), traços (-) e sublinhados (_). Normalmente, a prática recomendada é colocar cada painel do LookML em um arquivo próprio, mas é possível declarar vários painéis em um único arquivo.

- dashboard: sales_overview

Para mostrar algo, um painel precisa ter pelo menos um elemento adicionado usando o parâmetro elements.

Observação: se você mudar o valor do parâmetro dashboard de um painel do LookML que foi movido para fora da pasta Painéis do LookML, ele será movido de volta para essa pasta automaticamente.

preferred_viewer

Importante: esse parâmetro é ignorado.

Antes da descontinuação do painel legado no Looker 23.6, o parâmetro preferred_viewer permitia escolher o formato para visualizar e baixar um painel como a experiência de painel padrão do Looker ou como um painel legado.

title (para o painel)

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

title também pode ser usado como parte de um filtro de painel, descrito na seção title (para filtros) desta página.

title também pode ser usado como parte de qualquer elemento do painel. Um exemplo representativo do uso é fornecido na página de documentação Elementos do gráfico de colunas.

O parâmetro title permite mudar a forma como o nome de um painel aparece para os usuários em pastas e na parte de cima do painel. Se não for especificado, o padrão será o nome do painel. O texto do título pode ser localizado.

Por exemplo,

- dashboard: sales_overview
  title: "1) Sales Overview"

Se você fizesse isso, em vez de aparecer como Visão geral de vendas, o painel apareceria como 1) Visão geral de vendas.

description (para o painel)

Esta seção se refere ao parâmetro description que faz parte de um painel.

description também pode ser usado como parte de uma análise detalhada, conforme descrito na página de documentação do parâmetro description (para análises detalhadas).

description também pode ser usado como parte de um campo, conforme descrito na página de documentação do parâmetro description (para campos).

O parâmetro description permite adicionar uma descrição a um painel do LookML.

O conteúdo do parâmetro description vai aparecer no campo Descrição do painel Detalhes do painel de um painel do LookML.

A descrição aparece abaixo do título do painel nas listas de painéis quando visualizada em uma pasta definida como visualização em lista. Se uma descrição não for especificada, a lista vai mostrar apenas o título do painel.

O texto da descrição pode ser localizado.

enable_viz_full_screen

Esse parâmetro só entra em vigor quando a configuração Visualizações em tela cheia é ativada por um administrador do Looker. A configuração Visualização em tela cheia está ativada por padrão.

O parâmetro enable_viz_full_screen permite definir se os leitores do painel podem ver os blocos em tela cheia e visualizações expandidas. É equivalente à configuração do painel Permitir o modo de tela cheia nas visualizações.

Esse parâmetro aceita os valores true (visualizações em tela cheia e expandidas disponíveis) e false (visualizações em tela cheia e expandidas não disponíveis). O valor padrão é true.

extends

Conforme descrito na página de documentação Reutilizar códigos com extensões, o parâmetro extends permite basear um dashboard do LookML em outro, possivelmente adicionando ou substituindo algumas configurações. O parâmetro extends aceita o nome de outro painel do LookML.

Ao estender um objeto, saiba que as regras de localização também se aplicam às suas extensões. Se você estiver estendendo um objeto e definindo novos rótulos ou descrições, forneça definições de localização nos arquivos de strings de localidade do projeto. Consulte a página de documentação Localizar seu modelo do LookML para mais informações.

extension

Conforme descrito na página de documentação Reutilizar código com extensões, o parâmetro extension indica que o painel precisa ser estendido por outro painel. Esse painel nunca fica visível para outros usuários, mas pode ser usado como modelo para criar outros painéis que ficam visíveis para eles. O parâmetro extension aceita apenas o valor required. Se o parâmetro extension não for incluído, a extensão não será necessária para o painel.

layout

O parâmetro layout define o método de layout que o Looker vai usar ao posicionar os elementos do painel. Ele aceita os seguintes valores:

• newspaper: os elementos do painel vão aparecer em uma grade de 24 colunas. O tamanho padrão de um elemento é uma largura de 8 colunas e uma altura de 6 linhas. Os elementos são configuráveis ao longo dessa grade, especificados pelos parâmetros de elemento width, height, row e col. Essa opção de layout é usada quando um painel definido pelo usuário é convertido em um painel do LookML, além de ser o layout padrão quando um novo painel do LookML é criado no ambiente de desenvolvimento integrado do Looker. Além disso, newspaper e grid são os únicos layouts que oferecem suporte à conversão de um painel do LookML para um painel definido pelo usuário.

• grid: os elementos do painel aparecem com larguras dinâmicas, que são baseadas em um conjunto de linhas definido com o parâmetro rows e os subparâmetros elements e height. newspaper e grid são os únicos layouts que oferecem suporte à conversão de um painel do LookML para um painel definido pelo usuário.

• static: os elementos do painel aparecem na ordem em que estão listados no arquivo LookML. Cada elemento do painel precisa ser posicionado manualmente usando os parâmetros top e left. Esses parâmetros se aplicam a todos os tipos de elementos, e os detalhes sobre o uso deles aparecem nas páginas de documentação de cada tipo de visualização. Para exemplos representativos de como top e left funcionam, consulte a página de documentação Parâmetros de gráfico de colunas para painéis do LookML. O static não oferece suporte à conversão de um painel do LookML para um painel definido pelo usuário.

• tile: os elementos do painel aparecem na ordem em que estão listados no arquivo LookML. A largura do painel é dinâmica e baseada na largura do navegador. Os elementos do painel se posicionam dinamicamente no navegador para preencher o espaço disponível. O tile não oferece suporte à conversão de um painel do LookML para um painel definido pelo usuário.

rows

Para dashboards layout: grid, o parâmetro rows inicia a seção do LookML em que você define quais elementos devem ir para quais linhas, bem como a altura de cada linha. Em cada linha, todos os elementos têm a mesma largura. Se você não listar um elemento nesta seção, ele não vai aparecer no painel.

- dashboard: sales_overview
  layout: grid
  rows:
    - elements: [element_name, element_name, ...]
      height: 200
    - elements: [element_name, element_name, ...]
      height: 300

elements

O parâmetro elements usa uma lista de nomes de elementos do painel separados por vírgulas. Cada declaração elements cria uma nova linha no painel. Todos os elementos colocados em uma linha terão a mesma largura. Portanto, se você colocar dois elementos em uma linha, cada um vai ocupar 50% do espaço disponível. Se você colocar quatro elementos em uma linha, cada um vai ocupar 25% do espaço disponível.

height

O parâmetro height define a altura de uma linha em pixels. O valor padrão é 300.

tile_size

Para os painéis layout: tile e layout: static, a unidade usada para dimensionar e posicionar elementos é o tamanho do bloco. Você define tile_size em pixels, e o valor padrão é 160. Exemplo:

- dashboard: sales_overview
  layout: tile
  tile_size: 100

Nessa situação, um elemento do painel com height: 5 e width: 3 terá 500 pixels de altura e 300 pixels de largura. Os parâmetros height e width se aplicam a todos os tipos de elementos, e os detalhes sobre o uso deles aparecem nas páginas de documentação de cada tipo de visualização. Para um exemplo representativo de como height e width funcionam, consulte a página de documentação Parâmetros de gráfico de colunas para painéis do LookML.

width

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

width também pode ser usado como parte de um elemento do painel. Um exemplo representativo do uso está disponível na página de documentação dos elementos do gráfico de colunas.

Para painéis layout: static, o parâmetro width define a largura total do painel que você planeja usar em pixels. O parâmetro width não restringe o painel a um determinado tamanho se você definir um elemento muito grande ou muitos elementos seguidos. Em vez disso, a configuração width ajuda a manter o painel centralizado na tela. Se você não definir uma largura, o padrão será 1200.

- dashboard: sales_overview
  layout: static
  width: 800

refresh

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

refresh também pode ser usado como parte de um elemento do painel. Um exemplo representativo do uso é fornecido na página de documentação dos elementos do gráfico de colunas.

O parâmetro refresh permite que um painel seja recarregado automaticamente em intervalos periódicos, 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:

- dashboard: sales_overview
  refresh: 2 hours

Tenha cuidado ao definir intervalos de atualização curtos. Como os painéis podem conter muitas consultas, algumas delas com uso intensivo de recursos, certos painéis podem sobrecarregar seu banco de dados.

auto_run

O parâmetro auto_run determina se um dashboard será executado quando for aberto ou recarregado inicialmente. O valor padrão é true. Quando esse parâmetro é definido como false, os usuários precisam pressionar um botão Executar para carregar o painel. Por exemplo, um painel como este será executado automaticamente quando aberto:

- dashboard: sales_overview
  auto_run: true

Independente da configuração auto_run, os usuários sempre precisam clicar em um botão Executar depois de mudar os valores do filtro. Isso ajuda a evitar recarregamentos indesejados quando um usuário pausa durante uma mudança de filtro ou quer alterar vários filtros ao mesmo tempo.

crossfilter_enabled

O parâmetro crossfilter_enabled permite ativar ou desativar os filtros cruzados em um painel. Quando esse parâmetro é definido como true, os leitores de painéis podem criar filtros cruzados no painel clicando em determinados pontos de dados.

- dashboard: sales_data
  crossfilter_enabled: true

filters_bar_collapsed

O parâmetro filters_bar_collapsed permite definir a barra de filtros do painel como recolhida ou expandida por padrão. Quando esse parâmetro é definido como true, a barra de filtros fica recolhida por padrão. Os leitores de painéis podem expandir a barra de filtros clicando no ícone de filtros. A configuração padrão é false.

- dashboard: sales_data
  filters_bar_collapsed: true

filters_location_top

Com o parâmetro filters_location_top, é possível colocar a barra de filtros do painel na parte superior ou direita. Quando esse parâmetro é definido como true, a barra de filtro aparece na parte de cima do painel. Quando é definido como false, a barra de filtro aparece à direita do painel. A configuração padrão é true.

- dashboard: sales_data
  filters_location_top: false

filters

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

filters também pode ser usado como parte de um elemento do painel. Um exemplo representativo do uso é fornecido na página de documentação dos elementos do gráfico de colunas.

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

O parâmetro filters inicia a seção do LookML em que você define os filtros do painel. Os filtros aparecem na parte de cima do painel e permitem que os usuários mudem os dados por trás dos elementos do painel.

Para que um filtro afete um elemento, ele precisa ser configurado para "ouvir" esse filtro usando o parâmetro listen. Esse parâmetro se aplica a todos os tipos de elementos, exceto type: text e type: button. Para um exemplo representativo de como o listen funciona, consulte a página de documentação Parâmetros de gráfico de colunas para painéis do LookML.

Observação: para elementos do painel que usam o parâmetro merged_queries, cada consulta de origem pode detectar um ou mais filtros do painel. Em uma definição de consulta mesclada, é possível usar o parâmetro listen para definir a lógica de filtro de cada consulta de origem de forma independente, sem importar o número de consultas de origem no elemento de resultados mesclados. Se uma consulta não tiver um parâmetro listen, ela não será afetada por nenhum filtro do painel.

Quando os filtros são aplicados a um elemento dessa maneira, é importante que o tipo de filtro corresponda à dimensão ou ao tipo de medida que está detectando o filtro. Consulte Como criar painéis do LookML para mais detalhes. Os filtros têm o seguinte formato:

filters:
- name: filter_name
  title: "chosen filter title"
  type: field_filter | number_filter | date_filter | string_filter
  model: model_name
  explore: explore_name
  field: view_name.field_name
  default_value: Looker filter expression
  allow_multiple_values: true | false
  required: true | false
  listens_to_filters:
  - filter_name
    field: view_name.field_name

name

Esta seção se refere ao parâmetro name, que faz parte de um filtro de painel.

name também pode ser usado como parte de um elemento do painel. Um exemplo representativo do uso é fornecido na página de documentação dos elementos do gráfico de colunas.

Cada declaração name cria um novo filtro de painel e atribui um nome a ele. O nome será referenciado no parâmetro listen dos elementos que serão afetados pelo filtro. O parâmetro listen se aplica a todos os tipos de elementos, exceto type: text. Os detalhes sobre o uso dele aparecem nas páginas de documentação de cada tipo de visualização. Para um exemplo representativo de como o listen funciona, consulte a página de documentação Parâmetros de gráfico de colunas para painéis do LookML.

filters:
- name: order_date

title (para filtros)

Esta seção se refere ao parâmetro title, que faz parte de um filtro de painel.

title também pode ser usado como parte de um painel, conforme descrito na seção title (para painel) desta página.

title também pode ser usado como parte de um elemento do painel. Um exemplo representativo do uso está disponível na página de documentação Parâmetros de gráfico de colunas para painéis do LookML.

O parâmetro title permite mudar a forma como um nome de filtro aparece para os usuários na parte de cima de um painel. Se não for especificado, o título vai usar o nome do filtro.

Por exemplo,

filters:
- name: order_date
  title: "Order Date(s)"

Se você fez isso, em vez de aparecer como Data do pedido, o filtro vai aparecer como Datas do pedido.

type

Esta seção se refere ao parâmetro type, que faz parte de um filtro de painel.

type também pode ser usado como parte de um elemento do painel, descrito na página de documentação do parâmetro type (para painéis do LookML).

type também pode ser usado como parte de uma junção, conforme descrito na página de documentação do parâmetro type.

type também pode ser usado como parte de uma dimensão, conforme descrito na página de documentação Tipos de dimensões, filtros e parâmetros.

type também pode ser usado como parte de uma métrica, conforme descrito na página de documentação Tipos de métricas.

O parâmetro type especifica o tipo de entrada que será colocada no filtro. Embora qualquer tipo de entrada (como uma data) possa ser gravado no filtro type: string_filter, ser mais específico oferece um widget de filtro mais personalizado ao usuário. Os quatro tipos de filtro são:

• field_filter: geralmente é a opção padrão quando você pode especificar uma dimensão ou medida subjacente. Usar type: field_filter e associar o filtro a um campo type:string faz com que o filtro sugira valores possíveis.
• number_filter: permite que o usuário insira um número/valor inteiro ou uma expressão.
• date_filter: permite que o usuário insira um valor ou uma expressão de data.
• string_filter: permite que o usuário insira texto livre.

field_filter

Sugere opções para escolher e muda a apresentação para os usuários com base no campo especificado.

Esse é o tipo de filtro ideal para situações em que você quer fazer sugestões aos usuários enquanto eles interagem com o filtro. A dimensão de que as sugestões serão extraídas é definida usando os parâmetros explore e field e precisa ser um campo de type: string para gerar sugestões de filtro.

As sugestões podem não funcionar se o campo vier de uma tabela derivada, se sql_always_where for usado na análise detalhada ou se o campo for uma métrica.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date  # must be of the form view_name.dimension_name

number_filter

Não faz sugestões, permite que o usuário insira um valor ou uma expressão de número inteiro/número.

filters:
- name: order_value
  type: number_filter

date_filter

Não faz sugestões, permite que o usuário insira um valor ou uma expressão de data.

filters:
- name: order_date
  type: date_filter

string_filter

Não faz sugestões, permite que o usuário insira texto livre.

filters:
- name: customer_name
  type: string_filter

default_value

O parâmetro default_value permite especificar um valor padrão a ser usado em um filtro. Esse valor pode ser útil para os usuários, sugerindo um ponto de partida razoável.

Verifique se o valor padrão corresponde ao tipo de filtro usado. Exemplo:

filters:
- name: order_value
  type: number_filter
  default_value: "50 to 100"

- name: order_date
  type: date_filter
  default_value: "last 30 days"

- name: customer_name
  type: string_filter
  default_value: "John Doe"

Você pode usar expressões de filtro para criar valores padrão. A página de documentação Expressões de filtro do Looker descreve isso com mais detalhes.

Ao usar os parâmetros default_value e ui_config, as expressões de filtro precisam ser compatíveis com o valor atribuído ao subparâmetro type de ui_config e os tipos de dados que oferecem suporte ao valor type.

Você também pode usar as variáveis Liquid _localization e _user_attributes para valores de filtro padrão flexíveis.

allow_multiple_values

O parâmetro allow_multiple_values permite controlar se os usuários podem selecionar um ou vários valores de filtro. Quando esse parâmetro é definido como true (o padrão), os usuários podem selecionar vários valores para o filtro. Quando esse parâmetro é definido como false, os usuários só podem selecionar um valor de filtro.

Exemplo:

filters:
- name: Order ID
  title: Order ID
  type: field_filter
  allow_multiple_values: true
  required: false
  model: thelookstore
  explore: orders
  field: orders.id

required

O parâmetro required permite exigir que os usuários forneçam um valor para o filtro para executar o painel. Por padrão, os filtros não exigem valores. Se um filtro que não exige um valor for deixado em branco, os dados não serão restritos pelo campo de filtro. Se um filtro que exige um valor for deixado em branco, o painel não será executado.

filters:
  - name: State
    title: State
    type: field_filter
    required: true

ui_config

O subparâmetro ui_config de filters permite configurar as definições de filtro de um painel do LookML. Essas configurações incluem os tipos de controles de filtro usados, o posicionamento dos controles de filtro e os valores de filtro possíveis.

Exemplo:

  filters:
  - name: City
    title: City
    type: field_filter
    default_value: San Francisco
    allow_multiple_values: true
    required: false
    ui_config:
      type: button_group
      display: inline
      options:
      - San Francisco
      - New York
      - Tokyo
    model: thelook
    explore: order_items
    field: users.city

Consulte a página de documentação Adicionar e editar filtros de painel definidos pelo usuário para mais informações sobre como configurar filtros com a UI.

type

O subparâmetro type de ui_config permite especificar os tipos de controles de filtro que são mostrados.

Dependendo do valor inserido em type, os controles de filtro podem ser de seleção única ou múltipla.

Os valores compatíveis com type dependem dos dados da LookML type atribuídos ao campo em que você está filtrando.

STR = compatível com o tipo de dados string	DIST = compatível com o tipo de dados distance
NUM = compatível com o tipo de dados number e medidas numéricas	DUR = compatível com o tipo de dados duration
TIER = compatível com o tipo de dados tier	D&T = compatível com a maioria dos tipos de dados de data e hora
ZIP = compatível com o tipo de dados zipcode	LOC = compatível com o tipo de dados location
S/N = Compatível com o tipo de dados yesno	PAR = compatível com o parâmetro parameter

Valor	Descrição	Tipos de dados compatíveis
Seleção múltipla
button_group	O filtro mostra um grupo de botões, um para cada valor especificado com o parâmetro options.	STR NUM TIER ZIP Y/N DIST DUR
checkboxes	O filtro mostra caixas de seleção, uma para cada valor especificado com o parâmetro options.	STR NUM TIER ZIP Y/N DIST DUR
tag_list	O filtro mostra um menu suspenso com cada valor possível especificado usando o parâmetro options.	STR NUM TIER ZIP DIST DUR
range_slider	Para campos numéricos, o filtro mostra um controle deslizante que permite aos usuários definir um intervalo de números como o valor do filtro. Os subparâmetros min e max de options são usados para especificar os valores mínimo e máximo possíveis para o filtro, e o intervalo padrão pode ser especificado usando o parâmetro default_value.	NUM DIST DUR
Seleção única
button_toggles	O filtro mostra um grupo de botões, um para cada valor especificado com o parâmetro options.	STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons	O filtro mostra botões de opção, um para qualquer valor e um para cada valor especificado com o parâmetro options.	STR NUM TIER ZIP Y/N DIST DUR PAR
dropdown_menu	O filtro mostra um menu suspenso com cada valor possível especificado usando o parâmetro options. O menu suspenso também oferece aos usuários a opção de selecionar Qualquer valor.	STR NUM TIER ZIP Y/N DIST DUR PAR
slider	Para campos numéricos, o filtro mostra um controle deslizante que permite aos usuários escolher um filtro deslizando entre os valores mínimo e máximo possíveis, especificados usando o parâmetro options.	NUM DIST DUR
Datas e horários
day_picker	Com ele, os usuários podem escolher uma data específica para filtrar.	D&T: o controle de dia único pode ser usado com a maioria dos períodos e tipos baseados em tempo, mas os leitores só podem selecionar datas únicas com esse tipo de controle.
day_range_picker	Com ele, os usuários podem selecionar uma data de início e uma data de término para filtrar um período.	D&T: o controle de período pode ser usado com a maioria dos períodos e tipos baseados em tempo, mas os leitores só podem selecionar períodos com esse tipo de controle.
date_time_range_input	Com ele, o usuário pode filtrar por um intervalo de datas e horários.	D&T: o controle de período de data e hora pode ser usado com a maioria dos tipos baseados em tempo, e os leitores precisam selecionar as opções de data e hora com esse tipo de controle.
relative_timeframes	Com ele, é possível filtrar por um período personalizado ou escolher entre opções predefinidas, como Hoje, Últimos 7 dias ou Últimos 90 dias.	D&T: o controle de período pode ser usado com a maioria dos períodos e tipos baseados em tempo, mas os leitores não podem selecionar opções de tempo com esse tipo de controle.
Outro
advanced	O filtro apresenta opções para aplicar um ou mais filtros ou correspondências avançadas. Consulte a seção Usar controles avançados nesta página para saber mais sobre eles.	STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

Observação: alguns períodos e tipos baseados em tempo são interpretados como tipos de dados diferentes quando o Looker cria opções de controle para eles. Dois exemplos são o período yesno, que é interpretado como um tipo de dados yesno e, portanto, aceita os valores compatíveis com o tipo yesno, e o período hour_of_day, que é interpretado como um tipo de dados number e, portanto, aceita os valores compatíveis com o tipo number.

display

Você pode usar o subparâmetro display de ui_config para definir a posição de um filtro do painel. Para posicionar um filtro, atribua um dos seguintes valores a display:

• inline: o filtro é exibido diretamente na barra de cima do painel.
• popover: um valor de resumo aparece na barra superior do painel. Clique nele para ver o filtro completo.
• overflow: um botão Mais aparece na barra superior do painel com um indicador numérico de quantos filtros de estouro há. Os usuários podem clicar no botão para ver os filtros de estouro e os valores deles.

Alguns tipos de filtros só podem ser mostrados de determinadas maneiras. Por exemplo, filtros de type: day_picker só podem ser mostrados como inline ou overflow. Se você atribuir a um filtro um valor de display que não é válido para esse type, o filtro vai aparecer como inline ou popover, o que for válido. Para saber mais, consulte a página de documentação Adicionar e editar filtros de painel definidos pelo usuário.

Para informações sobre como posicionar filtros de painel usando a UI, consulte a página de documentação Adicionar e editar filtros definidos pelo usuário.

options

O subparâmetro opcional options de ui_config permite especificar os valores que um usuário pode escolher para atualizar temporariamente os valores de filtro do painel quando os usuários visualizam um painel do LookML. Se você não especificar nenhum valor para options, o Looker vai extrair os primeiros valores do banco de dados.

Por exemplo, é possível definir San Francisco, New York e Tokyo como os valores possíveis para um filtro no campo users.city da seguinte maneira:

ui_config:
  type: button_group
  display: inline
  options:
  - San Francisco
  - New York
  - Tokyo

Se o subparâmetro type de ui_config estiver definido como range_slider ou slider, use os subparâmetros min e max de options:

• min: define o valor mínimo possível para um filtro.
• max: define o valor máximo possível para um filtro.

Exemplo:

ui_config:
  type: range_slider
  display: inline
  options:
    min: 0
    max: 500

model

Para filtros de painel de type: field_filter, é necessário definir um modelo de onde o filtro vai extrair sugestões. O parâmetro model especifica qual modelo contém o campo que você quer usar.

filters:
- name: State
  title: State
  type: field_filter
  default_value: California
  model: thelookstore
  explore: users
  field: users.state

explore

Esta seção se refere ao parâmetro explore, que faz parte de um filtro de painel.

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 elemento do painel. Um exemplo representativo do uso é fornecido na página de documentação dos elementos do gráfico de colunas.

Para filtros de painel do tipo type: field_filter, é necessário definir um campo de onde o filtro vai extrair sugestões. O parâmetro explore especifica qual Análise contém o campo que você quer usar.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

field

Para filtros de painel do tipo type: field_filter, é necessário definir um campo de onde o filtro vai extrair sugestões. O parâmetro field especifica qual campo você quer usar. É importante usar o nome do campo totalmente qualificado. Em outras palavras, use view_name.field_name, não apenas field_name.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

listens_to_filters

Para filtros de painel de type: field_filter, é possível restringir as sugestões com base no que o usuário insere em outro filtro de type: field_filter.

No exemplo a seguir, as sugestões fornecidas para o filtro State serão baseadas nos valores do filtro Order ID. Os valores selecionados para o filtro Order ID terão valores users.state associados, que serão sugeridos para o filtro State. Consulte a página de documentação Adicionar e editar filtros de painel definidos pelo usuário para mais informações.

filters:
- name: State
  title: State
  type: field_filter
  model: thelookstore
  explore: users
  listens_to_filters:
  - Order ID
  field: users.state

embed_style

O parâmetro embed_style inicia a seção do LookML em que você personaliza a aparência de um dashboard incorporado. embed_style e os parâmetros associados são compatíveis apenas com dashboards incorporados e são ignorados se o dashboard não estiver incorporado.

Depois de fazer mudanças em embed_style, implante a LookML na produção para que as configurações de embed_style sejam refletidas no painel incorporado da LookML.

Para os seguintes atributos de painel incorporado que especificam uma cor, o valor pode ser uma string hexadecimal, como #2ca6cd, ou uma string de cor nomeada em CSS, como mediumblue.

As personalizações de painéis incorporados têm o seguinte formato:

embed_style:
  background_color: "css_color"
  show_title: true | false
  title_color: "css_color"
  show_filters_bar: true | false
  tile_background_color: "css_color"
  tile_text_color: "css_color"

background_color

Define a cor do plano de fundo de um painel incorporado.

embed_style:
  background_color: "#ffffff"

show_title

Especifica se o título do dashboard incorporado está visível para os usuários.

embed_style:
  show_title: false

title_color

Define a cor do título de um painel incorporado.

embed_style:
  title_color: "#008000"

show_filters_bar

Especifica se os filtros do painel incorporado estão visíveis para os usuários.

Esse parâmetro afeta apenas a aparência do painel, não a capacidade de um usuário acessar os dados. Ocultar a barra de filtros NÃO impede que os usuários mudem os filtros por outros meios. Para informações sobre como configurar políticas de controle de acesso a dados seguros, consulte a página de documentação Controle de acesso e gerenciamento de permissões.

embed_style:
  show_filters_bar: true

tile_background_color

Define a cor do plano de fundo de todos os blocos em um painel incorporado.

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

Define a cor do texto em todos os blocos de um painel incorporado.

embed_style:
  tile_text_color: "crimson"

elements

Esta seção se refere ao parâmetro elements, que faz parte de um dashboard.

elements também pode ser usado como parte de uma linha do painel, conforme descrito na seção elements para linhas nesta página.

O parâmetro elements inicia a seção do LookML em que você define os elementos que vão compor um painel. Há muitos parâmetros que podem definir a aparência de um elemento do painel. Elas são descritas em mais detalhes na página Parâmetros de elementos do painel.

- dashboard: sales_overview
  layout: tile
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]

Pense no número e na complexidade dos elementos que você adiciona a um dashboard do LookML. Mais elementos exigem mais recursos do navegador, o que aumenta o tempo de renderização do painel. Da mesma forma, elementos que renderizam grandes quantidades de dados podem afetar o desempenho do painel. Se a renderização se tornar um problema, reduza a complexidade das consultas de elementos do painel ou crie vários painéis com menos elementos.