Share via


Parámetros de varios valores

Un parámetro de varios valores permite al usuario establecer uno o varios valores de texto arbitrarios. Los parámetros de varios valores se usan normalmente para el filtrado, a menudo cuando un control desplegable puede contener demasiados valores para ser útiles.

Creación de un parámetro estático de varios valores

  1. Comience con un libro vacío en modo de edición.

  2. Seleccione Agregar parámetros>Agregar parámetro.

  3. En el panel de nuevo parámetro que se abre, escriba:

    • Nombre del parámetro: Filter
    • Tipo de parámetro: Multi-value
    • Obligatorio: unchecked
    • Obtener datos de: None
  4. Seleccione Guardar para crear el parámetro.

  5. El parámetro Filter será un parámetro de varios valores, inicialmente sin valores.

    Captura de pantalla que muestra la creación de un parámetro de varios valores en el libro.

  6. A continuación, puede agregar varios valores.

    Captura de pantalla que muestra cómo agregar un tercer valor en el libro.

Un parámetro de varios valores se comporta de forma similar a un parámetro desplegable de selección múltiple y se usa normalmente en un escenario similar a "en".

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

Estilo del campo de parámetros

El parámetro de varios valores admite los siguientes estilos de campo:

  1. Estándar: permite a un usuario agregar o quitar elementos de texto. arbitrarios

    Captura de pantalla que muestra el campo estándar de valor múltiple del libro.

  2. Contraseña: permite que pueda agregar o quitar campos de contraseña arbitrarios. Los valores de contraseña solo se ocultan en la interfaz de usuario al escribir. Los valores siguen siendo accesibles como valor de parámetro cuando son referidos. Se almacenan sin cifrar cuando se guarda el libro.

    Captura de pantalla que muestra el campo de contraseña de valor múltiple del libro.

Crear un parámetro de valor múltiple con valores iniciales

Puede usar una consulta para inicializar el parámetro de varios valores con valores iniciales. Después, puede quitar valores manualmente o agregar más valores. Si se usa una consulta para rellenar el parámetro de varios valores, aparecerá un botón de restauración de valores predeterminados en el parámetro para restaurar de nuevo a los valores consultados originalmente.

  1. Comience con un libro vacío en modo de edición.

  2. Seleccione Agregar parámetros>Agregar parámetro.

  3. En el panel de nuevo parámetro que se abre, escriba:

    • Nombre del parámetro: Filter
    • Tipo de parámetro: Multi-value
    • Obligatorio: unchecked
    • Obtener datos de: JSON
  4. En el bloque de texto de entrada JSON, inserte este fragmento de código JSON:

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

    Todos los elementos que son el resultado de la consulta se mostrarán como elementos de varios valores. No está limitado a JSON. Puede usar cualquier proveedores de consultas para proporcionar valores iniciales, pero estará limitado a los primeros 100 resultados.

  5. Seleccione Ejecutar consulta.

  6. Seleccione Guardar para crear el parámetro.

  7. El parámetro Filtro será un parámetro de varios valores, con tres valores iniciales.

    Captura de pantalla que muestra la creación de una lista desplegable en un libro.

Pasos siguientes