Utiliser des paramètres dans des tableaux de bord en temps réel

Les paramètres sont les blocs de construction des filtres dans Real-Time tableaux de bord. Vous les gérez au niveau du tableau de bord et ajoutez-les aux requêtes pour filtrer les données affichées dans un visuel. Une requête peut utiliser un ou plusieurs paramètres.

Cet article explique comment créer et utiliser des paramètres, des filtres croisés et des extractions dans les tableaux de bord. Vous pouvez filtrer des visuels de tableau de bord en sélectionnant des valeurs de paramètre dans la barre de filtres ou en utilisant des filtres croisés.

Les exemples de requête utilisés dans cet article sont basés sur la table StormEvents dans les exemples de données Weather analytics disponibles dans la galerie d’exemples.

Prérequis

• Un espace de travail avec une capacité compatible avec Microsoft Fabric.
• Autorisations de l’éditeur sur un tableau de bord en temps réel
• Tableau de bord avec des objets visuels

Consulter une liste de paramètres

Pour afficher la liste de tous les paramètres de tableau de bord, sélectionnez Gérer>Paramètres.

Créer un paramètre

Pour créer un paramètre :

1. Sélectionnez le bouton Nouveau paramètre dans le menu supérieur. Le volet Paramètres s’ouvre.
2. Sélectionnez + Ajouter en haut du volet droit.
3. Renseignez les propriétés pertinentes pour votre paramètre.
4. Sélectionnez Terminé pour créer le paramètre.

Propriétés

Dans le volet Ajouter un paramètre, configurez les propriétés ci-dessous.

Gérer les paramètres

Après avoir sélectionné Paramètres dans la barre supérieure, vous pouvez afficher la liste des paramètres existants. Dans chaque carte de paramètre, sélectionnez l’icône de modification pour modifier le paramètre, ou sélectionnez Plus [...] pour dupliquer, supprimer ou déplacer le paramètre.

Vous pouvez afficher les indicateurs suivants dans la carte de paramètres :

• Nom d’affichage du paramètre.
• Nom de la variable.
• Nombre de requêtes qui utilisent le paramètre.
• Pages où le paramètre s’affiche.

Vous pouvez réorganiser les cartes de paramètres en faisant glisser-déplacer ou en utilisant Déplacer vers >.

Utiliser des paramètres dans votre requête

Un paramètre doit être utilisé dans la requête avant que le filtre n’affecte ce visuel. Après avoir défini un paramètre, vous pouvez l’afficher dans la barre de filtres de la page Requête et dans IntelliSense des requêtes.

Types de paramètres

Le tableau de bord prend en charge les types de paramètres suivants :

• Paramètre Intervalle de temps par défaut
• Paramètres à valeurs fixes et à sélection unique
• Paramètres à valeurs fixes et à sélection multiple
• Paramètres basés sur une requête et à sélection unique
• Paramètres basés sur une requête à sélection multiple
• Paramètres de texte libre
• Paramètres de source de données

Les exemples suivants décrivent comment utiliser des paramètres dans une requête pour différents types de paramètres.

Paramètre Intervalle de temps par défaut

Chaque tableau de bord inclut un paramètre d’intervalle de temps par défaut. Il apparaît en tant que filtre uniquement lorsque vous l’utilisez dans une requête. Utilisez les mots-clés _startTime et _endTime pour appliquer le paramètre de plage de temps par défaut, comme indiqué dans l’exemple suivant :

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

Lorsque vous enregistrez la requête, le filtre d’intervalle de temps s’affiche sur le tableau de bord. Vous pouvez ensuite filtrer le visuel en sélectionnant une présélection dans l’intervalle de temps ou en sélectionnant Intervalle de temps personnalisé.

Paramètres à valeurs fixes et à sélection unique

Les paramètres de valeur fixe sont basés sur des valeurs prédéfinies que vous spécifiez. L’exemple suivant montre comment créer un paramètre à valeur fixe à sélection unique.

Créer un paramètre à valeurs fixes et à sélection unique

1. Sélectionnez Paramètres pour ouvrir le volet Paramètres , puis sélectionnez Nouveau paramètre.

2. Entrez les informations suivantes :

   • Étiquette : Type d’événement

   • Type de paramètre : sélection unique

   • Nom de la variable : _eventType

   • Type de données : Chaîne

   • Épingler comme filtre de tableau de bord: Sélectionné

   • Source : Valeurs fixes

     Dans cet exemple, utilisez les valeurs suivantes :

     Valeur	Nom d’affichage du paramètre
     Vent d’orage	Vent d’orage
     Grêle	Grêle
     Crue soudaine	Crue soudaine
     Sécheresse	Sécheresse
     Météo hivernale	Météo hivernale

   • Ajouter une valeur Tout sélectionner : Non coché

   • Valeur par défaut : Vent orage

3. Sélectionnez Terminé pour créer le paramètre.

Le paramètre apparaît dans le volet Paramètres , mais vous ne l’utilisez pas encore dans des visuels.

Utiliser un paramètre à valeurs fixes et à sélection unique

1. Exécutez un exemple de requête qui utilise le nouveau paramètre Type d’événement à l’aide du nom de la _eventType variable :

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

   Le nouveau paramètre apparaît dans la liste des paramètres en haut du tableau de bord.

2. Sélectionnez différentes valeurs pour mettre à jour les visuels.

   

Paramètres à valeurs fixes et à sélection multiple

Les paramètres de valeur fixe sont basés sur des valeurs prédéfinies que vous spécifiez. L’exemple suivant montre comment créer et utiliser un paramètre à valeur fixe à sélection multiple.

Créer un paramètre à valeurs fixes et à sélection multiple

1. Sélectionnez Paramètres pour ouvrir le volet Paramètres , puis sélectionnez Nouveau paramètre.

2. Renseignez les détails comme décrit dans Créer un paramètre à valeurs fixes à sélection unique, avec les modifications suivantes :

   • Étiquette : Type d’événement
   • Type de paramètre : sélection multiple
   • Nom de la variable : _eventType

3. Sélectionnez Terminé pour créer le paramètre.

Le nouveau paramètre apparaît dans le volet Paramètres , mais vous ne l’utilisez pas encore dans des visuels.

Utiliser un paramètre à valeurs fixes et à sélection multiple

1. Exécutez un exemple de requête qui utilise le nouveau paramètre Type d’événement et la _eventType variable.

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Le nouveau paramètre apparaît dans la liste des paramètres en haut du tableau de bord.

2. Sélectionnez une ou plusieurs valeurs différentes pour mettre à jour les visuels.

   

Paramètres basés sur une requête et à sélection unique

Les valeurs des paramètres basés sur une requête sont récupérées lors du chargement du tableau de bord en exécutant la requête avec paramètres. L’exemple suivant vous montre comment créer et utiliser un paramètre basé sur une requête et à sélection unique.

Créer un paramètre basé sur une requête et à sélection unique

1. Sélectionnez Paramètres pour ouvrir le volet Paramètres , puis sélectionnez Nouveau paramètre.

2. Renseignez les détails comme décrit dans Créer un paramètre à valeurs fixes à sélection unique, avec les modifications suivantes :

   • Libellé : État

   • Nom de la variable : _state

   • Source : requête

   • Source de données : StormEventsSample

   • Sélectionnez Modifier la requête, puis entrez la requête suivante. Cliquez sur Terminé.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Valeur : état

   • Nom d’affichage : État

   • Valeur par défaut : choisissez une valeur par défaut

3. Sélectionnez Terminé pour créer le paramètre.

Utiliser le paramètre basé sur une requête à sélection unique

1. L’exemple de requête suivant avec le nouveau paramètre State utilise la variable _state :

   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
   

   Le nouveau paramètre apparaît dans la liste des paramètres en haut du tableau de bord.

2. Sélectionnez différentes valeurs pour mettre à jour les visuels.

Paramètres basés sur une requête à sélection multiple

Les valeurs de paramètre basées sur une requête proviennent de l’exécution d’une requête spécifiée par l’utilisateur lorsque le tableau de bord se charge. L’exemple suivant montre comment créer un paramètre basé sur une requête à sélection multiple.

Créer un paramètre basé sur une requête et à sélection multiple

1. Sélectionnez Paramètres pour ouvrir le volet Paramètres , puis sélectionnez + Nouveau paramètre.

2. Entrez les détails comme décrit dans Créer un paramètre basé sur une requête à sélection unique, avec les modifications suivantes :

   • Étiquette : État
   • Type de paramètre : sélection multiple
   • Nom de la variable : _state

3. Sélectionnez Terminé pour créer le paramètre.

Utiliser un paramètre basé sur une requête et à sélection multiple

1. L’exemple de requête suivant utilise le nouveau paramètre State avec la variable _state.

   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
   

   Remarque

   Cet exemple utilise l’option Tout sélectionner en vérifiant la présence de valeurs vides avec la fonction isempty().

   Le nouveau paramètre apparaît dans la liste des paramètres en haut du tableau de bord.

2. Sélectionnez une ou plusieurs valeurs différentes pour mettre à jour les visuels.

Paramètres de texte libre

Les paramètres de texte libre ne contiennent aucune valeur. Ils vous permettent d’introduire votre propre valeur.

Créer un paramètre de texte libre

1. Sélectionnez Paramètres pour ouvrir le volet Paramètres , puis sélectionnez + Nouveau paramètre.
2. Saisissez les informations suivantes :
   • Libellé : État
   • Type de paramètre : Texte libre
   • Nom de la variable : _state
   • Type de données : Chaîne
   • Valeur par défaut : Aucune valeur par défaut
3. Sélectionnez Terminé pour créer le paramètre.

Utiliser un paramètre de texte libre

1. Exécutez un exemple de requête à l’aide du nouveau paramètre State en utilisant le nom de variable _state :

   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
   

Paramètres de source de données

Après avoir ajouté des sources de données à votre tableau de bord, vous pouvez créer un paramètre qui sélectionne une ou plusieurs des sources de données disponibles. Utilisez ce paramètre dans les vignettes et d’autres paramètres.

Créer un paramètre de source de données

1. Sélectionnez Paramètres pour ouvrir le volet Paramètres , puis sélectionnez + Nouveau paramètre.

2. Entrez les informations suivantes :

   • Étiquette : Source
   • Type de paramètre : source de données
   • Afficher sur les pages : Sélectionner tout
   • Valeurs : Sélectionner tout
   • Valeur par défaut : StormEvents

   

3. Cliquez sur Terminé.

La liste des paramètres en haut du tableau de bord affiche désormais le nouveau paramètre.

Utiliser un paramètre de source de données

1. Accédez à la requête d’une vignette nouvelle ou existante.

2. Dans Source, sélectionnez le nom de votre nouveau paramètre sous Paramètres de source de données, tels que le nouveau paramètre Source.

   

3. Sélectionnez Appliquer les modifications.

4. Utilisez le paramètre Source pour modifier la source de données pour cette requête connectée.

Paramètres de filtre croisé

Un filtre croisé est une fonctionnalité d’un tableau de bord que vous utilisez pour sélectionner une valeur dans un visuel et filtrer les données dans d’autres visuels sur le même tableau de bord. L’utilisation de filtres croisés permet d’obtenir le même résultat que la sélection de la valeur équivalente pour le paramètre dans la liste de paramètres en haut du tableau de bord.

Définir des filtres croisés

Pour créer un filtre croisé, activez l’option dans le visuel, puis spécifiez le paramètre qui filtre les données.

1. Accédez à la requête de la vignette dans laquelle vous souhaitez ajouter des filtres croisés.

2. Sélectionnez Visual.

3. Dans le volet droit, sélectionnez Interactions, puis activez les filtres croisés.

4. Si vous le souhaitez, spécifiez le type d’Interaction. La valeur par défaut est Point où vous sélectionnez une valeur dans le visuel. Pour sélectionner une plage de valeurs, comme dans un graphique chronologique, sélectionnez Glisser.

5. Spécifiez à la fois la colonne qui fournit la valeur et un paramètre qui filtre la requête des visuels.

   Important

   La colonne et le paramètre doivent être du même type de données.

Interagir avec vos données à l’aide d’un filtre croisé

Après avoir défini le filtre croisé, utilisez-le pour interagir avec vos données. Dans les visuels où vous définissez des filtres croisés, sélectionnez des points de données et utilisez leurs valeurs pour filtrer la page du tableau de bord actuel. Pour les visuels de tableau, cliquez avec le bouton droit sur la cellule appropriée, puis sélectionnez Filtre croisé.

Vous pouvez réinitialiser le filtre croisé en sélectionnant Réinitialiser en haut du visuel où vous l’avez sélectionné.

Utiliser les explorations détaillées comme paramètres de dashboard

L’exploration détaillée vous permet de sélectionner une valeur dans une visualisation et de l’utiliser pour filtrer les visualisations d’une page cible dans le même tableau de bord. Lorsque la page cible s’ouvre, la valeur est présélectionnée dans les filtres appropriés. Les visuels de la page, tels que les graphiques en courbes ou en nuages de points, affichent uniquement les données associées. Cette fonctionnalité est utile lorsque vous souhaitez explorer une page récapitulative vers une page de détails. Pour plus d’informations sur la création de pages, consultez Ajouter une page.

Définir une exploration détaillée

Pour créer une extraction, activez l’option dans le visuel, puis spécifiez un ou plusieurs paramètres d’extraction qui filtrent les données.

1. Dans votre page principale, entrez en mode Édition.

2. Modifiez le visuel où vous souhaitez ajouter une exploration détaillée. Vérifiez que l’onglet Visuel est sélectionné.

   

3. Dans le volet droit, sélectionnez Interactions, puis activez l’exploration détaillée.

   

4. Sous Exploration détaillée, sélectionnez Créer, puis indiquez les informations suivantes. Sélectionnez éventuellement Ajouter une autre paire pour ajouter plusieurs paramètres pour une page cible. Répétez cette étape pour ajouter des extractions à d’autres pages du tableau de bord actuel à l’aide de différents paramètres.

   Champ	Descriptif
   Page de destination	Une ou plusieurs pages cibles à explorer à l’aide des paramètres définis.
   Colonne	Colonne du résultat de la requête à utiliser comme valeur pour un paramètre dans la page cible.
   Paramètre	Paramètre utilisé pour filtrer les visuels dans la page cible à l’aide de la valeur de colonne.
   Remarques	Brève description facultative.

   Important

   Les paires colonne/paramètre doivent être du même type de données.

   

Interagissez avec vos données en utilisant des explorations détaillées

Après avoir défini des explorations détaillées, utilisez-les pour interagir avec vos données. Dans les visuels ou les tableaux dans lesquels vous définissez une exploration amont, cliquez avec le bouton droit sur un point de données, puis sélectionnez Explorer vers la> destination. Les valeurs du point de données filtrent les visuels sur la page cible.

Utiliser la recherche de filtres pour les filtres de sélection unique et de sélection multiple

Dans les filtres de sélection unique et de sélection multiple, tapez la valeur souhaitée. Le filtre est mis à jour pour afficher uniquement les valeurs qui correspondent au terme de recherche.

Contenu connexe

• Visualisation de données avec des tableaux de bord en temps réel
• Personnaliser des visuels de tableau de bord en temps réel