Paramètres à valeurs multiples

Un paramètre à valeurs multiples permet à l’utilisateur de définir une ou plusieurs valeurs de texte arbitraires. Les paramètres à valeurs multiples sont couramment utilisés pour le filtrage, souvent lorsqu’un contrôle déroulant peut contenir trop de valeurs pour être utiles.

Créer un paramètre à valeurs multiples statiques

1. Démarrez avec un classeur vide en mode d’édition.

2. Sélectionnez Ajouter des paramètres>Ajouter un paramètre.

3. Dans le nouveau volet des paramètres qui apparaît, entrez :

   • Nom du paramètre : Filter
   • Type de paramètre : Multi-value
   • Obligatoire : unchecked
   • Récupérer des données à partir de : None

4. Sélectionnez Enregistrer pour créer le paramètre.

5. Le paramètre Filtre est un paramètre à valeurs multiples, initialement sans valeur.

   

6. Vous pouvez ensuite ajouter plusieurs valeurs.

   

Un paramètre à valeurs multiples se comporte de la même façon qu’un paramètre de liste déroulante à sélection multiple et est couramment utilisé dans un scénario de type « in ».

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

Style du champ de paramètre

Le paramètre à valeurs multiples prend en charge les styles de champ suivants :

1. Standard : vous permet d’ajouter ou de supprimer des éléments de texte arbitraires.

   

2. Mot de passe : vous permet d’ajouter ou de supprimer des champs de mot de passe arbitraires. Les valeurs de mot de passe sont masquées uniquement dans l’interface utilisateur lorsque vous tapez. Les valeurs restent entièrement accessibles en tant que valeur de paramètre lorsqu’elles sont référencées. Elles sont stockées non chiffrées lorsque le classeur est enregistré.

   

Créer un paramètre à valeurs multiples avec des valeurs initiales

Vous pouvez utiliser une requête pour amorcer le paramètre à valeurs multiples avec des valeurs initiales. Vous pouvez ensuite supprimer manuellement des valeurs ou ajouter d’autres valeurs. Si une requête est utilisée pour remplir le paramètre à valeurs multiples, un bouton Restaurer les valeurs par défaut s’affiche sur le paramètre pour revenir aux valeurs interrogées à l’origine.

1. Démarrez avec un classeur vide en mode d’édition.

2. Sélectionnez Ajouter des paramètres>Ajouter un paramètre.

3. Dans le nouveau volet des paramètres qui apparaît, entrez :

   • Nom du paramètre : Filter
   • Type de paramètre : Multi-value
   • Obligatoire : unchecked
   • Récupérer des données à partir de : JSON

4. Dans le bloc de texte de l’entrée JSON, insérez cet extrait de code JSON :

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

   Tous les éléments qui sont le résultat de la requête sont affichés sous forme d’éléments à valeurs multiples. Vous n’êtes pas limité à JSON. Vous pouvez utiliser n’importe quel fournisseur de requêtes pour fournir des valeurs initiales, mais vous serez limité aux 100 premiers résultats.

5. Sélectionnez Run Query (Exécuter la requête).

6. Sélectionnez Enregistrer pour créer le paramètre.

7. Le paramètre Filtre est un paramètre à valeurs multiples avec trois valeurs initiales.

   

Étapes suivantes

• Paramètres du classeur
• Paramètres de liste déroulante du classeur