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.

Por default, um visualizador seleciona um campo de cada vez. Você também pode permitir que os visualizadores selecionem vários campos de uma só vez, para que uma única variável adicione várias séries, colunas ou linhas a uma visualização. Consulte Permitir que os visualizadores selecionem vários campos.

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 de dashboard

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. A transformação define como o campo é agregado ou agrupado (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 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.

Cada opção de campo em uma variável de dashboard mostra seu dataset de origem como um subtítulo, para que você possa distinguir campos que compartilham um nome entre datasets. Para mostrar aos visualizadores um rótulo diferente para uma opção, consulte Definir nomes de exibição para opções de campo.

As ações em variáveis de painel permitem desfazer e refazer.

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.

Definir nomes de exibição para opções de campo

Cada opção de campo em uma variável de dashboard tem um rótulo gerado que combina o nome do campo com sua transformação, como Soma de ventas ou Preço médio . Você pode substituir esse rótulo por um nome de exibição que os visualizadores veem em seu lugar, como Receita total . Um nome de exibição altera apenas o rótulo. O campo e a transformação da opção permanecem os mesmos.

Para definir um nome de exibição para uma opção de campo:

1. No rascunho do dashboard, selecione o widget de filtro que controla a variável.

2. No painel de configuração do widget, em Variáveis , clique na variável.

3. Em Opções de campo , clique na opção de campo que você deseja renomear.

4. Na caixa Nome de exibição , digite o nome. A caixa mostra o rótulo gerado como um espaço reservado.

   

O nome de exibição é salvo à medida que você digita. Para retornar ao rótulo gerado, limpe a caixa Display name .

O nome de exibição aparece sempre que o painel mostra a opção, tanto em painéis rascunhados quanto em publicados:

• A lista de opções do widget de filtro.
• A barra de filtro ativa e o indicador de filtro de widget.
• Títulos de eixos, legendas, nomes de séries e dicas de ferramentas em visualizações que usam a variável.

Se você definir um nome de exibição para um campo no editor de visualização, esse nome terá precedência sobre o nome de exibição da opção nessa visualização.

Você também pode pedir ao Genie Code para criação de dashboard para definir, renomear ou limpar nomes de exibição para as opções de campo de uma variável. Quando o Genie Code edita a variável, ele mantém os nomes de exibição que você definiu.

Os nomes de exibição têm as seguintes limitações:

• Um nome de exibição pode conter até 500 caracteres. Espaços no início e no final são removidos.
• Quando você exporta um dashboard para um arquivo .lvdash.json ou importa um, os nomes de exibição das opções de campo não são incluídos. As opções no dashboard exportado ou importado usam seus rótulos gerados.

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.

Permitir que os visualizadores selecionem vários campos

A seleção múltipla permite que os visualizadores de painéis exibam vários campos de uma variável de uma só vez, de modo que uma única variável adiciona uma série, coluna ou linha separada para cada campo selecionado. Por exemplo, um visualizador pode mostrar sales e Profit como séries separadas no mesmo gráfico. Por default, uma variável substitui um único campo.

Para habilitá-lo, ative Permitir seleção múltipla ao criar ou editar a variável. Em seguida, os visualizadores usam um controle de seleção múltipla para escolher qualquer combinação dos campos da variável, e cada visualização que usa a variável adiciona uma entrada por campo selecionado.

A seleção múltipla funciona apenas em codificações que podem exibir mais de um campo, como:

• O eixo y de um gráfico de barras ou de linhas de várias séries
• As colunas de uma tabela
• As linhas, colunas ou valores de uma tabela dinâmica

Se você adicionar uma variável de seleção múltipla a uma codificação que possa mostrar apenas um campo (por exemplo, um valor de contador ou o eixo x de um gráfico), a visualização usará apenas o primeiro campo selecionado e mostrará um aviso.