Usar parâmetros em painéis em tempo real

Os parâmetros são os blocos de construção dos filtros em Real-Time Dashboards. Gere-as ao nível do dashboard e adiciona-as às consultas para filtrar os dados mostrados visualmente. Uma consulta pode usar um ou mais parâmetros.

Este artigo explica como criar e usar parâmetros, filtros cruzados e perfurações em dashboards. Pode filtrar os visuais do painel selecionando valores de parâmetros na barra de filtro ou usando filtros cruzados.

Os exemplos de consulta utilizados neste artigo baseiam-se na tabela StormEvents dos dados de exemplo Weather analytics disponíveis na galeria samples.

Pré-requisitos

• Um espaço de trabalho com uma capacidade ativada por Microsoft Fabric.
• Permissões de editor em um painel em tempo real
• Um painel com elementos visuais

Ver lista de parâmetros

Para exibir a lista de todos os parâmetros do painel, 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 é aberto.
2. Selecionar + Adicionar no topo do painel direito.
3. Preencha as propriedades relevantes para o seu parâmetro.
4. Selecione Concluído para criar o parâmetro.

Propriedades

No painel Adicionar parâmetro, configure as seguintes propriedades.

Gerenciar parâmetros

Depois de selecionar Parâmetros na barra superior, pode ver 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, eliminar ou mover.

Pode ver os seguintes indicadores no cartão de parâmetros:

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

Pode reordenar os cartões de parâmetros arrastando-e-largando ou usando Mover para >.

Utilizar parâmetros na sua consulta

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

Tipos de parâmetros

O painel suporta os seguintes tipos de parâmetros:

• 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 consultas de seleção múltipla
• Parâmetros de texto livre
• Parâmetros da fonte de dados

Os exemplos a seguir descrevem como usar parâmetros em uma consulta para vários tipos de parâmetros.

Parâmetro de intervalo de tempo padrão

Cada painel inclui por defeito um parâmetro de intervalo temporal . Só aparece como filtro quando o usas numa consulta. Utilize as palavras-chave _startTime e _endTime para aplicar o parâmetro predefinido do intervalo de tempo, conforme mostrado no exemplo seguinte:

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

Quando guardas a consulta, o filtro de intervalo de tempo aparece no painel. Pode então filtrar o visual selecionando um predefinido 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 baseiam-se em valores pré-definidos que especifica. O exemplo seguinte mostra como criar um parâmetro de valor fixo de seleção única.

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

1. Selecione Parâmetros para abrir o painel de Parâmetros, e depois 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: String

   • Fixar como filtro de dashboard: Selecionado

   • Fonte: Valores fixos

     Neste exemplo, use os seguintes valores:

     Valor	Nome de exibição do parâmetro
     Ventos Violentos	Vento de trovoada
     Granizo	Granizo
     Inundação repentina	Inundação repentina
     Seca	Seca
     Tempo de Inverno	Tempo de inverno

   • Adicionar o valor Selecionar tudo: Desmarcado

   • Valor padrão: Thunderstorm Wind

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

O parâmetro aparece no painel de Parâmetros , mas ainda não o estás a usar em nenhum visual.

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

1. Execute uma consulta de exemplo que utilize o novo parâmetro Event Type utilizando o nome da variável _eventType:

   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 no topo do painel.

2. Selecione valores diferentes para atualizar os elementos visuais.

   

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

Os parâmetros de valor fixo baseiam-se em valores pré-definidos que especifica. O exemplo seguinte mostra como criar e usar um parâmetro de valor fixo de múltipla seleção.

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

1. Selecione Parâmetros para abrir o painel de Parâmetros, e depois 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 de Parâmetros , mas ainda não o estás a usar em nenhum visual.

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

1. Execute uma consulta de exemplo que use o novo parâmetro de 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 no topo do painel.

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

   

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

Os valores de parâmetros 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 de Parâmetros, e depois 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

   • Fonte: Consulta

   • Fonte de dados: StormEventsSample

   • Selecione Editar consulta e insira a seguinte consulta. Selecionar 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 para exibição: Estado

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

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

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

1. A consulta de exemplo a seguir com o novo parâmetro State usa a _state variável:

   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 no topo do painel.

2. Selecione valores diferentes para atualizar os elementos visuais.

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

Os valores de parâmetros baseados em consulta resultam da execução de uma consulta especificada pelo utilizador quando o painel carrega. O exemplo seguinte mostra como criar um parâmetro baseado em consulta de múltipla seleção.

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

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

2. Introduza 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.

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

1. A consulta de exemplo a seguir usa o novo parâmetro State usando a _state variável.

   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
   

   Nota

   Este exemplo usa a opção Selecionar tudo verificando valores vazios com a isempty() função.

   O novo parâmetro aparece na lista de parâmetros no topo do painel.

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

Parâmetros de texto livre

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

Criar um parâmetro de texto livre

1. Selecione Parâmetros para abrir o painel de Parâmetros, e depois selecione + Novo parâmetro.
2. Introduza os detalhes seguintes:
   • Rótulo: Estado
   • Tipo de parâmetro: Texto livre
   • Nome da variável: _state
   • Tipo de dados: String
   • 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 consulta de exemplo usando o novo parâmetro State usando o nome da _state variável:

   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 seu painel, pode criar um parâmetro que selecione uma ou mais das fontes de dados disponíveis. Utilize este parâmetro em mosaicos e noutros parâmetros.

Criar um parâmetro de fonte de dados

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

2. Insira os seguintes detalhes:

   • Rótulo: Fonte
   • Tipo de parâmetro: Fonte de dados
   • Mostrar nas páginas: Selecione tudo
   • Valores: Selecione todos
   • Valor padrão: StormEvents

   

3. Selecionar Concluído.

A lista de parâmetros no topo do painel mostra agora o novo parâmetro.

Usar um parâmetro de fonte de dados

1. Vá à pergunta de um azulejo novo ou existente.

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

   

3. Selecione Aplicar alterações.

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

Parâmetros de filtro cruzado

Um filtro cruzado é uma funcionalidade num painel de controlo que se utiliza para selecionar um valor num visual e filtrar os dados noutros visuais do mesmo dashboard. O uso de filtros cruzados alcança o mesmo resultado que a seleção do valor equivalente para o parâmetro na lista de parâmetros na parte superior do painel.

Definir filtros cruzados

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

1. Vai à consulta do tile onde queres adicionar filtros cruzados.

2. Selecione Visual.

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

4. Opcionalmente, especifique o tipo de interação . O padrão é Point , onde selecionas um valor no visual. Para selecionar um intervalo de valores, como em um gráfico de tempo, selecione Arrastar.

5. Especifique tanto a coluna que fornece o valor como um parâmetro que filtra a consulta dos elementos visuais.

   Importante

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

Interaja com os seus dados usando filtro cruzado

Depois de definires o filtro cruzado, usa-o para interagir com os teus dados. Nos visuais onde defines filtros cruzados, seleciona pontos de dados e usa os seus valores para filtrar a página atual do dashboard. Para imagens de tabelas, clique com o botão direito na célula relevante e depois selecione Filtro Cruzado.

Pode reiniciar o filtro cruzado selecionando Reiniciar no topo do visual onde o selecionou.

Usar a navegação detalhada como parâmetros do painel

As análises aprofundadas permitem-lhe selecionar um valor num elemento visual e utilizá-lo para filtrar elementos visuais numa 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 linhas ou de dispersão, mostram apenas dados relacionados. Esta funcionalidade é útil quando quiser avançar de uma página de resumo para uma página de detalhes. Para obter informações sobre como criar páginas, consulte Adicionar página.

Definir um drillthrough

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

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

2. Edite o elemento visual onde pretende adicionar um drillthrough. Certifique-se de que o separador Visual está selecionado.

   

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

   

4. Em Detalhamento, selecione Criar novo e especifique as seguintes informações. Opcionalmente, selecione Adicionar outro par para adicionar vários parâmetros para uma página de destino. Repita este passo para adicionar drillthroughs a outras páginas no painel atual usando parâmetros diferentes.

   Campo	Descrição
   Página de destino	Uma ou mais páginas-alvo para explorar 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 utilizado para filtrar os visuais na página de destino com base no valor da coluna.
   Notas	Breve descrição opcional.

   Importante

   Os pares de colunas e parâmetros devem ser do mesmo tipo de dados.

   

Interaja com os seus dados através de drillthroughs

Depois de definires os drillthroughs, usa-os para interagir com os teus dados. Em visuais ou tabelas onde define um drillthrough, clique com o botão direito do rato num ponto de dados e, em seguida, selecione Drillthrough para>página de destino. Os valores do ponto de dados filtram os elementos visuais na página de destino.

Use a pesquisa por filtro para filtros de seleção única e múltipla seleção

Nos filtros de seleção única e múltipla, escreva o valor que pretende. O filtro atualiza para mostrar apenas valores que correspondem ao termo de pesquisa.

Conteúdos relacionados

• Visualize dados com painéis em tempo real
• Personalizar visuais do Painel em Tempo Real