08 – Rendre le Tableau de Bord interactif

Objectif de cette étape #

Nous allons ajouter une liste de pays permettant de filtrer tous les autres composants.

Lorsqu’un pays sera sélectionné :

• le chiffre d’affaires sera recalculé ;
• le nombre de commandes sera recalculé ;
• les graphiques seront recalculés ;
• le tableau détaillé sera actualisé.

Ajouter la liste des pays #

Type de composant #

Ajoutez un composant de type liste déroulante.

Datasource #

PARCOURS_06_LISTE_PAYS

Valeur affichée et valeur de référence #

Pays / Pays

Configuration proposée #

Pourquoi utiliser un paramètre de requête ? #

Un lien de filtrage classique agit sur les lignes déjà chargées dans un composant.
Or le KPI du chiffre d’affaires ne contient qu’une seule ligne :

ChiffreAffaires

Il ne contient pas de colonne Pays sur laquelle appliquer un filtre local.
Nous devons donc transmettre le pays sélectionné au paramètre SQL :

pPays

La requête est ensuite exécutée à nouveau avec cette valeur.

La documentation BiBOARD distingue notamment les liens filtrant les données chargées et les liens alimentant les paramètres des requêtes. Les liens par paramètres sont particulièrement adaptés lorsque les données doivent être recalculées ou filtrées directement par la requête.

Créer les liens #

La liste de pays est le composant source.
Chaque autre composant est une cible.

Principe du lien #

Liste des pays

    Champ source : Pays
        ↓
Paramètre cible : pPays
        ↓
Nouvelle exécution de la requête

Liens à créer #

Selon l’interface utilisée, le lien peut être créé vers le composant ou vers sa Datasource.
L’important est que la valeur sélectionnée alimente le paramètre pPays de la requête cible.

Fonctionnement du paramètre #

Toutes les requêtes contiennent :

AND (
      :pPays = '#NULL'
      OR cl.Pays = :pPays
    )

Aucun pays sélectionné #

pPays = #NULL

La première condition est vraie et toutes les données sont retournées.

Un pays est sélectionné #

pPays = France

La seconde condition conserve uniquement les clients dont le pays est France.

Tester les interactions #

Test 1 — Vue globale #

Ouvrez le Tableau de Bord sans sélectionner de pays.

Vérifiez que :

• plusieurs pays apparaissent dans le tableau ;
• les KPI affichent des valeurs globales ;
• les graphiques présentent l’ensemble des ventes.

Test 2 — Sélection d’un pays #

Sélectionnez un pays.

Vérifiez que :

• tous les composants se rafraîchissent ;
• le tableau ne contient plus que ce pays ;
• le nombre de commandes diminue ou reste identique ;
• le chiffre d’affaires correspond au pays sélectionné ;
• les catégories sans vente peuvent disparaître.

Test 3 — Changement de pays #

Sélectionnez un autre pays.

Tous les composants doivent être recalculés avec la nouvelle valeur.

Test 4 — Réinitialisation #

Effacez la sélection ou utilisez l’action de réinitialisation disponible –> Sélectionner <- vide ->

Le paramètre doit revenir à :

#NULL

Le Tableau de Bord doit alors retrouver sa vue globale.

Erreurs fréquentes #

Un seul composant se met à jour

Le lien n’a probablement été créé que pour une cible.
Créez un lien vers chacun des cinq composants.

Le composant devient vide #

Vérifiez :

• le nom du paramètre ;
• la valeur envoyée ;
• la valeur par défaut ;
• l’orthographe du champ Pays ;
• la présence du filtre SQL dans la requête cible.

La liste se filtre elle-même #

La liste des pays ne doit pas recevoir son propre paramètre.
Elle reste indépendante afin que l’utilisateur puisse toujours sélectionner un autre pays.

Résultat attendu
La sélection d’un pays met à jour l’ensemble du Tableau de Bord.