Partilhar via

Usar parâmetros em painéis em tempo real (visualização)

  • Artigo

Os parâmetros são usados como blocos de construção para filtros em painéis em tempo real. Eles são gerenciados no escopo do painel e podem ser adicionados a consultas para filtrar os dados apresentados pelo visual subjacente. Uma consulta pode usar um ou mais parâmetros.

Importante

Este recurso está em pré-visualização.

Este documento descreve a criação e o uso de parâmetros e filtros vinculados em painéis. Os parâmetros podem ser usados para filtrar visuais do painel selecionando valores de parâmetros na barra de filtros ou usando filtros cruzados.

Os exemplos de consulta usados neste artigo baseiam-se na tabela StormEvents nos dados de exemplo de análise meteorológica disponíveis na galeria de exemplos.

Nota

O gerenciamento de parâmetros está disponível no modo de edição para editores de painel.

Pré-requisitos

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 Novos parâmetros no menu superior. O painel Parâmetros é aberto.
  2. Selecione o botão + Adicionar na parte superior 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.

Campo Descrição
Etiqueta O nome do parâmetro mostrado no painel ou no cartão de edição.
Tipo de parâmetro Um dos seguintes parâmetros:
- Seleção única: Apenas um valor pode ser selecionado no filtro como entrada para o parâmetro.
- Seleção múltipla: Um ou mais valores podem ser selecionados no filtro como entradas para o parâmetro.
- Intervalo de tempo: Permite criar parâmetros adicionais para filtrar as consultas e painéis com base no tempo. Cada painel tem um seletor de intervalo de tempo por padrão.
- Texto livre: não tem valores preenchidos no filtro. O usuário pode digitar um valor ou copiar/colar um valor no campo de texto. O filtro mantém os valores recentes usados.
Descrição Descrição opcional do parâmetro.
Nome da variável O nome do parâmetro a ser usado na consulta.
Tipo de dados O tipo de dados dos valores dos parâmetros.
Mostrar nas páginas Selecione as páginas onde esse parâmetro é exibido. A opção Selecionar tudo mostra o parâmetro em todas as páginas.
Source A origem dos valores dos parâmetros:
- Valores fixos: Introduzidos manualmente valores de filtro estático.
- Consulta: Valores introduzidos dinamicamente usando uma consulta KQL.
Adicionar valor "Selecionar tudo" Aplicável apenas a tipos de parâmetros de seleção única e múltipla. Usado para recuperar dados para todos os valores de parâmetro. Esse valor deve ser incorporado à consulta para fornecer a funcionalidade. Consulte Usar o parâmetro baseado em consulta de seleção múltipla para obter mais exemplos sobre como criar essas consultas.
Valor predefinido O valor padrão do filtro. O filtro sempre começa com o valor padrão na renderização inicial do painel.

Gerenciar parâmetros

Depois de selecionar Parâmetros na barra superior, você pode visualizar a lista de parâmetros existentes. Em cada cartão de parâmetro, você pode selecionar o widget de lápis para editar o parâmetro, ou selecione o menu Mais [...] para duplicar, excluir ou mover o parâmetro.

Os seguintes indicadores podem ser visualizados no cartão de parâmetros:

  • Nome de exibição do parâmetro
  • Nomes de variável
  • Número de consultas em que o parâmetro foi utilizado
  • Páginas às quais o parâmetro está fixado

Você pode reordenar os cartões de parâmetros arrastando e soltando ou usando a opção Mover para > .

Captura de tela de cartões de parâmetros de exemplo.

Utilizar parâmetros na sua consulta

Um parâmetro deve ser usado na consulta para tornar o filtro aplicável para essa consulta visual. Uma vez definidos, você pode ver os parâmetros na barra superior do filtro de página > Consulta e no intellisense de consulta.

Nota

Se o parâmetro não for usado na consulta, o filtro permanecerá inativo. Depois que o parâmetro é adicionado à consulta, o filtro fica ativo.

Tipos de parâmetros

Vários tipos de parâmetros de painel são suportados, da seguinte forma:

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 tem um parâmetro de intervalo de tempo por padrão. Ele aparece no painel como um filtro somente quando usado em uma consulta. Use as palavras-chave _startTime do parâmetro e _endTime use o parâmetro de intervalo de tempo padrão em uma consulta, como visto no exemplo a seguir:

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

Uma vez salvo, o filtro de intervalo de tempo aparece no painel. Agora ele pode ser usado para filtrar os dados no cartão. Você pode filtrar seu painel selecionando na lista suspensa: Intervalo de tempo (últimos x minutos/horas/dias) ou um intervalo de tempo personalizado.

Filtre usando um 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 especificados pelo usuário. O exemplo a seguir 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 Parâmetros e selecione Novo parâmetro.

  2. Preencha os dados da seguinte forma:

    • Rótulo: Tipo de evento

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

    • Nome da variável: _eventType

    • Tipo de dados: String

    • Fixar como filtro do painel: verificado

    • Fonte: Valores fixos

      Neste exemplo, use os seguintes valores:

      Value 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 um valor Selecionar tudo : Não verificado

    • Valor padrão: Thunderstorm Wind

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

O parâmetro pode ser visto no painel lateral Parâmetros, mas não está sendo usado em nenhum elemento visual.

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

  1. Execute uma consulta de exemplo usando o novo parâmetro Event Type 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 elementos visuais.

    resultado dos cinco principais eventos.

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

Os parâmetros de valor fixo são baseados em valores predefinidos especificados pelo usuário. 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 mencionado em Usar 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.

Os novos parâmetros podem ser vistos no painel lateral Parâmetros , mas atualmente não estão sendo usados em nenhum elemento visual.

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

  1. Execute uma consulta de exemplo usando o novo parâmetro Event Type usando 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 elementos visuais.

    selecionar empresas.

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 Parâmetros e selecione Novo parâmetro.

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

    • Gravadora: 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 na parte superior 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 são derivados no tempo de carregamento do painel executando a consulta especificada pelo usuário. 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. Preencha os detalhes conforme mencionado em Usar um parâmetro de valores fixos de seleção única com as seguintes alterações:

    • Gravadora: 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 na parte superior 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 Parâmetros e selecione + Novo parâmetro.
  2. Preencha os dados da seguinte forma:
    • Gravadora: Estado
    • Tipo de parâmetro: Texto livre
    • Nome da variável: _state
    • Tipo de dados: String
    • Valor padrão: Nenhum valor padrão

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, você pode criar um parâmetro que seleciona uma ou mais das fontes de dados disponíveis. Este parâmetro pode ser usado 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. Preencha os dados da seguinte forma:

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

    Captura de tela dos parâmetros da fonte de dados.

  3. Selecionar Concluído.

O novo parâmetro agora está visível na lista de parâmetros na parte superior do painel.

Usar um parâmetro de fonte de dados

  1. Navegue até a consulta de um bloco 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 .

    Captura de tela mostrando a seleção de um parâmetro de fonte de dados na consulta.

  3. Selecione Aplicar alterações.

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

Parâmetros de filtros cruzados

Um filtro cruzado é um recurso em um painel que permite 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 a seleção do valor equivalente para o parâmetro na lista de parâmetros na parte superior do painel.

Definir cross-filters

Para criar um filtro cruzado, você deve ativar a opção no visual e, em seguida, especificar o parâmetro que é usado para filtrar os dados.

  1. Navegue até a consulta do bloco onde deseja 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 é Ponto onde você pode selecionar um valor no visual. Para selecionar um intervalo de valores, como em um gráfico de tempo, selecione Arrastar.

  5. Especifique a coluna usada para fornecer o valor e um parâmetro usado para filtrar a consulta visual.

    Importante

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

Interaja com seus dados usando filtro cruzado

Depois que o filtro cruzado estiver definido, você poderá usá-lo para interagir com seus dados. Em elementos visuais em que você definiu filtros cruzados, você pode selecionar pontos de dados e usar seus valores para filtrar a página atual do painel. Para elementos visuais de tabela, selecione pontos de dados clicando com o botão direito do mouse na célula relevante e, em seguida, no menu de contexto, selecione Filtro cruzado.

Você pode redefinir o filtro cruzado selecionando Redefinir na parte superior do visual onde ele foi selecionado.

Captura de ecrã de um visual de tabela, mostrando o botão de reposição.

Usar detalhamentos como parâmetros do painel

Os detalhamentos permitem selecionar um valor em um visual e usá-lo para filtrar os elementos visuais em uma página de destino dentro do 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, são filtrados para mostrar apenas dados relacionados. Esse recurso é útil para criar painéis com detalhamentos 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 detalhamento

Para criar um detalhamento, você deve ativar a opção no visual e, em seguida, especificar um ou mais parâmetros de detalhamento que são usados para filtrar os dados.

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

  2. Edite o visual onde você deseja adicionar um detalhamento. Certifique-se de que a guia Visual está selecionada.

    Captura de tela de um painel visual, mostrando a opção de edição.

  3. No painel direito, selecione Interações e ative o detalhamento.

    Captura de tela da página de detalhamento, mostrando a opção de ativação.

  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 esta etapa para adicionar detalhamento a outras páginas no painel 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.
    Column 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 elementos visuais na página de destino usando o valor da coluna.
    Notas Breve descrição opcional.

    Importante

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

    Captura de tela do formulário de detalhamento, destacando os campos a serem preenchidos.

Interaja com seus dados usando detalhamentos

Depois que os detalhamentos forem definidos, você poderá usá-los para interagir com seus dados. Para fazer isso, em elementos visuais ou tabelas em que você definiu um detalhamento, clique com o botão direito do mouse em um ponto de dados e selecione Detalhar para a>página de destino. Os valores do ponto de dados são usados como parâmetros para filtrar os elementos visuais na página de destino.

Captura de tela de um painel visual, mostrando a interação de detalhamento.

Usar a pesquisa de filtros para filtros de seleção única e múltipla

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

Conteúdos relacionados