Usar parâmetros em dashboards em tempo real

Os parâmetros são os elementos fundamentais dos filtros nos painéis em tempo real. Você os gerencia no nível do painel e os adiciona a consultas para filtrar os dados mostrados em um visual. Uma consulta pode usar um ou mais parâmetros.

Este artigo explica como criar e usar parâmetros, filtros cruzados e detalhamentos em dashboards. Você pode filtrar visuais de painel selecionando valores de parâmetro na barra de filtros ou usando filtros cruzados.

Os exemplos de consulta usados neste artigo são baseados na tabela StormEvents na amostra de dados de Análise meteorológica disponíveis na Galeria de amostras.

Pré-requisitos

• Um workspace com uma capacidade habilitada para Microsoft Fabric.
• Permissões de editor em um Dashboard em Tempo Real
• Um painel com elementos visuais

Exibir lista de parâmetros

Para exibir a lista de todos os parâmetros do dashboard, selecione Gerenciar>Parâmetros.

Criar um parâmetro

Para criar um parâmetro:

1. Selecione o botão Novo parâmetro no menu superior. O painel Parâmetros será aberto.
2. Selecione + Adicionar na parte superior do painel direito.
3. Preencha as propriedades relevantes do parâmetro.
4. Selecione Concluído para criar o parâmetro.

Propriedades

No painel Adicionar parâmetro, configure as propriedades a seguir.

Gerenciar parâmetros

Depois de selecionar Parâmetros na barra superior, você poderá exibir a lista de parâmetros existentes. Em cada cartão de parâmetro, selecione o ícone de edição para modificar o parâmetro ou selecione Mais [...] para duplicar, excluir ou movê-lo.

Você pode exibir os seguintes indicadores no cartão de parâmetro:

• Nome de exibição do parâmetro.
• Nome da variável.
• Número de consultas que usam o parâmetro.
• Páginas em que o parâmetro é exibido.

Você pode reordenar cartões de parâmetro arrastando e soltando ou usando Mover para >.

Usar parâmetros em sua consulta

Um parâmetro deve ser usado na consulta antes que o filtro afete esse visual. Depois de definir um parâmetro, você poderá vê-lo na barra de filtros na página Consulta e na consulta IntelliSense.

Tipos de parâmetro

O painel dá suporte aos seguintes tipos de parâmetro:

• Parâmetro de intervalo de tempo padrão
• Parâmetros de valores fixos de seleção única
• Parâmetros de valores fixos de seleção múltipla
• Parâmetros baseados em consulta de seleção única
• Parâmetros baseados em consulta de seleção múltipla
• Parâmetros de texto livre
• Parâmetros da fonte de dados

Os exemplos a seguir descrevem como usar diversos tipos de parâmetro em uma consulta.

Parâmetro de intervalo de tempo padrão

Cada painel inclui um parâmetro de intervalo de tempo por padrão. Ele aparece como um filtro somente quando você o usa em uma consulta. Use as palavras-chave _startTime e _endTime para aplicar o parâmetro de intervalo de tempo padrão, conforme mostrado no exemplo a seguir:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Quando você salva a consulta, o filtro de intervalo de tempo aparece no painel. Em seguida, você pode filtrar o visual selecionando uma predefinição no intervalo de tempo ou selecionando intervalo de tempo personalizado.

Parâmetros de valores fixos de seleção única

Os parâmetros de valor fixo são baseados em valores predefinidos que você especificar. O exemplo a seguir mostra como criar um parâmetro de valor fixo de seleção única.

Criar um parâmetro de seleção única com valores fixos

1. Selecione Parâmetros para abrir o painel Parâmetros e selecione Novo parâmetro.

2. Insira os seguintes detalhes:

   • Rótulo: tipo de evento

   • Tipo de parâmetro: seleção única

   • Nome da variável: _eventType

   • Tipo de dados: cadeia de caracteres

   • Fixar como filtro de painel: Selecionado

   • Fonte: valores fixos

     Neste exemplo, use os seguintes valores:

     Valor	Nome de exibição do parâmetro
     Ventos de tempestade	Vento de tempestade
     Granizo	Granizo
     Inundação Repentina	Inundação repentina
     Seca	Seca
     Clima de Inverno	Clima de inverno

   • Adicione um valor Selecionar tudo: desmarcado

   • Valor padrão: vento com trovoada

3. Selecione Concluído para criar o parâmetro.

O parâmetro aparece no painel Parâmetros , mas você ainda não o está usando em nenhum visual.

Usar um parâmetro de seleção única com valores fixos

1. Execute uma consulta de exemplo que usa o novo parâmetro tipo de evento usando o nome da _eventType variável:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   O novo parâmetro aparece na lista de parâmetros na parte superior do painel.

2. Selecione valores diferentes para atualizar os visuais.

   

Parâmetros de valores fixos de seleção múltipla

Os parâmetros de valor fixo são baseados em valores predefinidos que você especificar. O exemplo a seguir mostra como criar e usar um parâmetro de valor fixo de seleção múltipla.

Criar um parâmetro de valores fixos de seleção múltipla

1. Selecione Parâmetros para abrir o painel Parâmetros e selecione Novo parâmetro.

2. Preencha os detalhes conforme descrito em Criar um parâmetro de valores fixos de seleção única, com as seguintes alterações:

   • Rótulo: tipo de evento
   • Tipo de parâmetro: seleção múltipla
   • Nome da variável: _eventType

3. Selecione Concluído para criar o parâmetro.

O novo parâmetro aparece no painel Parâmetros , mas você ainda não o está usando em nenhum visual.

Usar um parâmetro de valores fixos de seleção múltipla

1. Execute uma consulta de exemplo que usa o novo parâmetro tipo de evento e a _eventType variável.

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   O novo parâmetro aparece na lista de parâmetros na parte superior do painel.

2. Selecione um ou mais valores diferentes para atualizar os visuais.

   

Parâmetros baseados em consulta de seleção única

Os valores de parâmetro baseados em consulta são recuperados durante o carregamento do painel executando a consulta de parâmetro. O exemplo a seguir mostra como criar e usar um parâmetro baseado em consulta de seleção única.

Criar um parâmetro baseado em consulta de seleção única

1. Selecione Parâmetros para abrir o painel Parâmetros e selecione Novo parâmetro.

2. Preencha os detalhes conforme descrito em Criar um parâmetro de valores fixos de seleção única, com as seguintes alterações:

   • Rótulo: Estado

   • Nome da variável: _state

   • Origem: Consulta

   • Fonte de dados: StormEventsSample

   • Selecione Editar consulta e insira a consulta a seguir. Selecione Concluído.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Valor: Estado

   • Nome de exibição: estado

   • Valor padrão: escolha um valor padrão

3. Selecione Concluído para criar o parâmetro.

Use um parâmetro de seleção única baseado em consulta

1. A seguinte amostra de consulta com o novo parâmetro Estado usa a variável _state:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   O novo parâmetro aparece na lista de parâmetros na parte superior do painel.

2. Selecione valores diferentes para atualizar os visuais.

Parâmetros baseados em consulta de seleção múltipla

Os valores dos parâmetros baseados em consulta são obtidos ao executar uma consulta especificada pelo usuário ao carregar o painel. O exemplo a seguir mostra como criar um parâmetro baseado em consulta de seleção múltipla.

Criar um parâmetro baseado em consulta de seleção múltipla

1. Selecione Parâmetros para abrir o painel Parâmetros e selecione + Novo parâmetro.

2. Insira os detalhes conforme descrito em Criar um parâmetro baseado em consulta de seleção única, com as seguintes alterações:

   • Rótulo: Estado
   • Tipo de parâmetro: seleção múltipla
   • Nome da variável: _state

3. Selecione Concluído para criar o parâmetro.

Use um parâmetro baseado em consulta de seleção múltipla

1. A amostra de consulta a seguir usa o novo parâmetro Estado por meio da variável _state.

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Observação

   Este exemplo usa a opção Selecionar Tudo verificando se há valores vazios com a função isempty().

   O novo parâmetro aparece na lista de parâmetros na parte superior do painel.

2. Selecione um ou mais valores diferentes para atualizar os visuais.

Parâmetros de texto livre

Os parâmetros de texto livre não contêm nenhum valor. Eles permitem que você introduza seu próprio valor.

Criar um parâmetro de texto livre

1. Selecione Parâmetros para abrir o painel Parâmetros e selecione + Novo parâmetro.
2. Insira os detalhes a seguir:
   • Rótulo: Estado
   • Tipo do parâmetro: texto livre
   • Nome da variável: _state
   • Tipo de dados: cadeia de caracteres
   • Valor padrão: nenhum valor padrão
3. Selecione Concluído para criar o parâmetro.

Usar um parâmetro de texto livre

1. Execute uma amostra de consulta com o novo parâmetro Estado usando o nome da variável _state:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

Parâmetros da fonte de dados

Depois de adicionar fontes de dados ao painel, você pode criar um parâmetro que seleciona uma ou mais das fontes de dados disponíveis. Use esse parâmetro em blocos e outros parâmetros.

Criar um parâmetro de fonte de dados

1. Selecione Parâmetros para abrir o painel Parâmetros e selecione + Novo parâmetro.

2. Insira os seguintes detalhes:

   • Rótulo: origem
   • Tipo de parâmetro: fonte de dados
   • Mostrar nas páginas: selecionar tudo
   • Valores: selecionar tudo
   • Valor padrão: StormEvents

   

3. Selecione Concluído.

A lista de parâmetros na parte superior do painel agora mostra o novo parâmetro.

Usar um parâmetro de fonte de dados

1. Vá para a consulta de um bloco novo ou existente.

2. Em Origem, selecione o nome do novo parâmetro em Parâmetros da fonte de dados, como o novo parâmetro de Origem.

   

3. Selecione Aplicar alterações.

4. Use o parâmetro de Origem para alterar a fonte de dados dessa consulta conectada.

Parâmetros de filtro cruzado

Um filtro cruzado é um recurso em um painel que você usa para selecionar um valor em um visual e filtrar os dados em outros visuais no mesmo painel. O uso de filtros cruzados alcança o mesmo resultado que selecionar o valor equivalente para o parâmetro na lista de parâmetros na parte superior do painel.

Definir filtros cruzados

Para criar um filtro cruzado, ative a opção no visual e especifique o parâmetro que filtra os dados.

1. Vá para a consulta do bloco em que você deseja adicionar filtros cruzados.

2. Selecione Visual.

3. No painel direito, selecione Interações e, em seguida, ative os filtros cruzados.

4. Opcionalmente, especifique o tipo de Interação. O padrão é Point onde você seleciona um valor no visual. Para selecionar um intervalo de valores, como em um gráfico de tempo, escolha Arrastar.

5. Especifique ambos: a coluna que fornece o valor e um parâmetro que filtra a consulta dos elementos visuais.

   Importante

   A coluna e o parâmetro precisam ser do mesmo tipo de dados.

Interagir com seus dados usando filtro cruzado

Depois de definir o filtro cruzado, use-o para interagir com seus dados. Em visuais em que você define filtros cruzados, selecione pontos de dados e use seus valores para filtrar a página do painel atual. Para visuais de tabela, clique com o botão direito do mouse na célula relevante e selecione Filtro cruzado.

Você pode redefinir o filtro cruzado selecionando Redefinir na parte superior do visual em que o selecionou.

Usar drillthroughs como parâmetros do painel

Os drillthroughs permitem selecionar um valor em um elemento visual e usá-lo para filtrar elementos visuais em uma página de destino no mesmo painel. Quando a página de destino é aberta, o valor é pré-selecionado nos filtros relevantes. Os elementos visuais na página, como gráficos de linha ou de dispersão, mostram apenas os dados relacionados. Esse recurso é útil quando você deseja fazer drill through de uma página de resumo para uma página de detalhes. Para obter informações sobre como criar páginas, consulte Add page.

Definir detalhamento

Para criar uma busca detalhada, ative a opção no elemento visual e, em seguida, especifique um ou mais parâmetros de busca detalhada que filtram os dados.

1. Na página principal, entre no modo de Edição.

2. Edite o visual no qual você deseja adicionar um drillthrough. Verifique se a guia Visual está selecionada.

   

3. No painel direito, selecione Interações e, em seguida, ative a opção de drillthrough.

   

4. Em Detalhamento, selecione Criar novo e especifique as informações a seguir. Opcionalmente, selecione Adicionar outro par para adicionar vários parâmetros para uma página de destino. Repita esta etapa para adicionar drillthroughs a outras páginas do dashboard atual usando parâmetros diferentes.

   Campo	Descrição
   Página de destino	Uma ou mais páginas de destino para detalhar usando os parâmetros definidos.
   Coluna	A coluna do resultado da consulta a ser usada como o valor de um parâmetro na página de destino.
   Parâmetro	O parâmetro usado para filtrar visuais na página de destino usando o valor da coluna.
   Observações	Descrição curta opcional.

   Importante

   A coluna e o parâmetro precisam ser do mesmo tipo de dados.

   

Interaja com seus dados por meio de detalhamentos

Depois de definir os drillthroughs, use-os para explorar seus dados. Em visuais ou tabelas em que você define um detalhamento, clique com o botão direito do mouse em um ponto de dados e, em seguida, selecione Detalhar até a>página de destino. Os valores do ponto de dados filtram os visuais na página de destino.

Use a pesquisa nos filtros para os filtros de seleção única e de seleção múltipla

Em filtros de seleção única e seleção múltipla, digite o valor desejado. O filtro é atualizado para mostrar apenas os valores que correspondem ao termo de pesquisa.

Conteúdo relacionado

• Visualizar dados com painéis de Real-Time
• Personalize os visuais do dashboard em tempo real