Parâmetros de vários valores

Um parâmetro de vários valores permite que o usuário defina um ou mais valores de texto arbitrários. Os 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 estático de vários valores

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 se abre, introduza:

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

4. Selecione Salvar para criar o parâmetro.

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

   

6. Em seguida, você pode adicionar vários valores.

   

Um parâmetro de vários valores se comporta de forma semelhante a um parâmetro suspenso de seleção múltipla e é comumente usado em um cenário semelhante ao "in".

    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 suporta os seguintes estilos de campo:

1. Padrão: Permite adicionar ou remover itens de texto arbitrários.

   

2. Palavra-passe: Permite adicionar ou remover campos de palavra-passe arbitrários. Os valores de senha só ficam ocultos na interface do usuário quando você digita. Os valores ainda estão totalmente acessíveis como um valor de parâmetro quando referidos. 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 semear o parâmetro de vários valores com valores iniciais. Em seguida, você pode remover manualmente os valores ou adicionar mais valores. Se uma consulta for usada para preencher o parâmetro de vários valores, um botão restaurar padrões aparecerá no parâmetro para restaurar os valores originalmente consultados.

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 se abre, introduza:

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

4. No bloco de texto Entrada JSON , insira este trecho JSON:

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

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

5. Selecione Executar consulta.

6. Selecione Salvar para criar o parâmetro.

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

   

Próximos passos

• Parâmetros da pasta de trabalho
• Parâmetros suspensos da pasta de trabalho