Parâmetros de vários valores

Um parâmetro de vários valores permite que o usuário defina um ou mais valores arbitrários de texto. Parâmetros de vários valores são comumente usados para filtragem, geralmente quando um controle suspenso pode conter muitos valores para ser útil.

Criar um parâmetro de vários valores estáticos

1. Comece com uma pasta de trabalho vazia no modo de edição.

2. Selecione Adicionar parâmetros>Adicionar Parâmetro.

3. No novo painel de parâmetros que será aberto, insira:

   • Nome do parâmetro: Filter
   • Tipo do parâmetro: Multi-value
   • Obrigatório: unchecked
   • Obter dados de: None

4. Selecione Salvar para criar o parâmetro.

5. O parâmetro Filtrar será um parâmetro de vários valores, inicialmente sem valores.

   

6. Você pode então adicionar vários valores.

   

Um parâmetro de vários valores se comporta de forma semelhante a um parâmetro de lista suspensa de várias seleções e normalmente é usado em um cenário do tipo "interno".

    let computerFilter = dynamic([{Computer}]);
    Heartbeat
    | where array_length(computerFilter) == 0 or Computer in (computerFilter)
    | summarize Heartbeats = count() by Computer
    | order by Heartbeats desc

Estilo do campo de parâmetro

Um parâmetro de vários valores dá suporte aos seguintes estilos de campo:

1. Padrão: permite que você adicione ou remova itens de texto arbitrários.

   

2. Senha: permite que você adicione ou remova campos arbitrários de senha. Os valores de senha só ficam ocultos na interface do usuário quando você digita. Os valores ainda ficam totalmente acessíveis como um valor de parâmetro, quando referido. Eles são armazenados sem criptografia, quando a pasta de trabalho é salva.

   

Criar um parâmetro de vários valores com valores iniciais

Você pode usar uma consulta para propagar o parâmetro de vários valores com valores iniciais. Você pode remover os valores manualmente ou adicionar mais valores. Se uma consulta for usada para preencher o parâmetro de vários valores, um botão padrão de restauração será exibido no parâmetro para restaurar de volta para os valores consultados originalmente.

1. Comece com uma pasta de trabalho vazia no modo de edição.

2. Selecione Adicionar parâmetros>Adicionar Parâmetro.

3. No novo painel de parâmetros que será aberto, insira:

   • Nome do parâmetro: Filter
   • Tipo do parâmetro: Multi-value
   • Obrigatório: unchecked
   • Obter dados de: JSON

4. No bloco de texto de entrada JSON, insira este trecho de código JSON:

   ["apple", "banana", "carrot" ]
   

   Todos os itens que são o resultado da consulta serão mostrados como itens de vários valores. Você não está limitado ao JSON. Você pode usar qualquer provedor de consulta para fornecer valores iniciais, mas será limitado aos primeiros 100 resultados.

5. Selecione Executar Consulta.

6. Selecione Salvar para criar o parâmetro.

7. O parâmetro Filtrar será um parâmetro de vários valores com três valores iniciais.

   

Próximas etapas

• Parâmetros da pasta de trabalho
• Parâmetros de lista suspensa da pasta de trabalho