Usar variáveis do painel

Uma variável de painel agrupa um conjunto de campos para que os usuários possam alternar qual campo uma visualização exibe. Um autor adiciona a variável à codificação de uma visualização, como o eixo X de um gráfico de barras, e a vincula a um widget de controle. Quando um visualizador escolhe um campo diferente no controle, toda visualização que usa a variável é atualizada para mostrar o campo selecionado.

Variáveis do dashboard permitem que os visualizadores respondam às suas próprias perguntas através de interações familiares de apontar e clicar, sem editar o dashboard ou esperar que uma consulta seja regenerada. Por exemplo, um visualizador pode alternar um gráfico de linhas entre Vendas e Transações , e a formatação é atualizada de acordo.

Adicionar ou remover vários campos de uma vez ainda não é compatível.

Escolha entre uma variável de painel e um parâmetro

Variáveis do painel e parâmetros tornam um painel interativo, mas operam em camadas diferentes. Uma variável de painel altera qual campo uma visualização exibe na camada do painel. Um parâmetro substitui um valor em uma query de dataset em tempo de execução. Para saber mais sobre parâmetros, consulte Como trabalhar com parâmetros do painel.

As variáveis do dashboard substituem a abordagem anterior de usar a cláusula IDENTIFIER com um parâmetro para swap campos. Ao contrário de IDENTIFIER, as variáveis do dashboard funcionam com views de métricas e preservam a formatação semântica anexada a cada campo.

Criar uma variável do painel

Você deve ter pelo menos as permissões CAN EDIT no rascunho do dashboard. Cria-se uma variável a partir de um widget de filtro (controle):

1. No rascunho do painel, na tela, clique em Adicionar um filtro (campo/parâmetro) e posicione o widget de filtro na página.
2. No painel de configuração do widget, crie uma variável e adicione os campos que os visualizadores possam escolher.
3. Para cada campo, especifique uma transformação e um nome de exibição :
   • A transformação define como o campo é agregado ou agrupado em buckets (por exemplo, SUM para uma medida ou DAILY para uma data). A transformação é definida como parte da variável e não pode ser substituída onde a variável é usada.
   • O nome de exibição é o rótulo exibido aos espectadores no controle.

O primeiro campo na variável é a seleção default. O widget de filtro usado para criar a variável se torna um controle que permite aos visualizadores alternar campos.

Tipos de campo e tipos de escala

Uma variável pode conter campos de tipos diferentes. O tipo de escala que uma visualização utiliza depende das opções de campo na variável:

• Se todas as opções de campo forem numéricas, o tipo de escala default é quantitativo. É possível alternar o tipo de escala da codificação para categórico no editor de visualização.
• Se todas as opções de campo forem campos de data ou de data e hora, o tipo de escala default é temporal. É possível alternar o tipo de escala da codificação para categórico no editor de visualização.
• Caso contrário (por exemplo, campos de strings ou uma mistura de strings e datas), o tipo de escala é apenas categórico.

O tipo de escala é fixo para a variável. Não se altera dinamicamente com base no campo que um visualizador seleciona.

Uma variável pode ser adicionada a uma visualização somente quando o nível de agregação de seus campos corresponde aos níveis de agregação que a visualização aceita. Por exemplo, as codificações dos eixos X e Y de um mapa de calor aceitam apenas campos desagregados, portanto, podem codificar apenas variáveis desagregadas.

Adicionar uma variável a uma visualização

Após criar uma variável, adicione-a à codificação de uma visualização, como um eixo ou uma coluna. Você pode adicionar a mesma variável a múltiplas visualizações. Quando um visualizador altera o campo selecionado da variável, toda codificação que utiliza a variável é atualizada para exibir o novo campo.