---
title: 08 – Rendre le Tableau de Bord interactif
description: "## 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é ; -…"
url: "https://wiki.biboard.fr/wiki/08-rendre-le-tableau-de-bord-interactif/"
updated: "2026-07-23"
category: "Parcours d'apprentissage / Initiation"
---

# 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

| **Propriété** | **Valeur** |
| --- | --- |
| Titre | Pays |
| Champ affiché | Pays |
| Champ retourné | Pays |
| Sélection | Une seule valeur |
| Tri | Alphabétique |
| Position | Première ligne, à gauche des KPI |

### 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.

![](https://wiki.biboard.fr/wp-content/uploads/2026/07/CP-C1-TdB-lie-02-1-1024x617.png)

## 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

| **Composant source** | **Champ source** | **Composant cible** | **Paramètre cible** |
| --- | --- | --- | --- |
| Liste Pays | Pays | KPI chiffre d’affaires | pPays |
| Liste Pays | Pays | KPI nombre de commandes | pPays |
| Liste Pays | Pays | Graphique mensuel | pPays |
| Liste Pays | Pays | Graphique par catégorie | pPays |
| Liste Pays | Pays | Tableau détaillé | pPays |

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.

![](https://wiki.biboard.fr/wp-content/uploads/2026/07/CP-C1-TdB-lie-01-1024x612.png)

### 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.

![](https://wiki.biboard.fr/wp-content/uploads/2026/07/CP-C1-TdB-lie-03-1024x542.png)

---
