---
title: 06 – Préparer les Datasources du Tableau de Bord
description: "## Objectif de cette étape Les requêtes SQL retournent les données nécessaires. Nous allons maintenant préparer ces données pour qu’elles puissent être utilisées facilement par les composants. ## Requête et Datasource : quelle différence ? ### La requête La requête…"
url: "https://wiki.biboard.fr/wiki/06-preparer-les-datasources-du-tableau-de-bord/"
updated: "2026-07-23"
category: "Parcours d'apprentissage / Initiation"
---

# 06 – Préparer les Datasources du Tableau de Bord

## Objectif de cette étape

Les requêtes SQL retournent les données nécessaires.
Nous allons maintenant préparer ces données pour qu’elles puissent être utilisées facilement par les composants.

## Requête et Datasource : quelle différence ?

### La requête

La requête définit :

- la connexion utilisée ;
- le SQL exécuté ;
- les tables interrogées ;
- les jointures ;
- les calculs ;
- les paramètres ;
- les lignes retournées.

Elle répond à la question :

Quelles données devons-nous récupérer ?

### La Datasource ou le Hub

La Datasource prépare les résultats de la requête pour les composants.

Elle permet notamment de définir :

- les champs disponibles ;
- les libellés présentés aux utilisateurs ;
- les formats ;
- les champs calculés ;
- les paramètres ;
- les propriétés utilisées par les composants.

Elle répond à la question :

Comment ces données doivent-elles être présentées et utilisées ?

Dans BiBOARD, une Datasource peut notamment être un **Hub** ou un **PivotHub**. L’enregistrement d’une requête crée ou met à jour son Hub associé, puis le Hub peut enrichir les champs issus de la requête avec des libellés, formats et champs calculés.

## Datasources générées automatiquement

| **Requête** | **Datasource ou Hub généré** |
| --- | --- |
| PARCOURS_01_DETAIL_COMMANDES | PARCOURS_01_DETAIL_COMMANDES |
| PARCOURS_02_CA_TOTAL | PARCOURS_02_CA_TOTAL |
| PARCOURS_03_NOMBRE_COMMANDES | PARCOURS_03_NOMBRE_COMMANDES |
| PARCOURS_04_CA_MENSUEL | PARCOURS_04_CA_MENSUEL |
| PARCOURS_05_CA_CATEGORIE | PARCOURS_05_CA_CATEGORIE |
| PARCOURS_06_LISTE_PAYS | PARCOURS_06_LISTE_PAYS |

Les noms peuvent être adaptés aux conventions de votre environnement.

## Préparer la Datasource de détail

Ouvrez le Hub associé à :

```
PARCOURS_01_DETAIL_COMMANDES
```

Vérifiez que les champs suivants sont présents :

```
CleLigne
NumCommande
DateCommande
CodeClient
Client
Pays
CodeProduit
NomProduit
Categorie
Quantite
PrixUnitaire
Remise
MontantBrut
MontantNet
```

### Définir les libellés

Les noms techniques peuvent être remplacés par des libellés plus lisibles.

| **Champ SQL** | **Libellé proposé** |
| --- | --- |
| NumCommande | N° de commande |
| DateCommande | Date de commande |
| Client | Client |
| Pays | Pays |
| NomProduit | Produit |
| Categorie | Catégorie |
| Quantite | Quantité |
| PrixUnitaire | Prix unitaire |
| Remise | Remise |
| MontantBrut | Montant brut |
| MontantNet | Chiffre d’affaires |

### Définir les formats

| **Champ** | **Format conseillé** |
| --- | --- |
| DateCommande | dd/MM/yy |
| PrixUnitaire | #,#,#. € |
| MontantBrut | #,#,#. € |
| MontantNet | #,#,#. € |
| NombreCommandes | #,#,#. |
| Quantite | #,#,#. |
| Remise | 0.00 % |

La syntaxe exacte du format peut dépendre des paramètres régionaux de l’environnement. L’objectif est d’obtenir par exemple :

12 345,67 €

et non :

12345.670000

### Masquer les champs techniques

Dans le tableau final, les champs suivants peuvent être conservés dans la Datasource sans être affichés :

```
CleLigne
CodeClient
CodeProduit
```

Ils restent disponibles pour de futurs liens ou traitements.

**Vérifier le paramètre**

Les Datasources reposant sur les cinq premières requêtes doivent disposer du paramètre :

```
pPays
```

Vérifiez :

- son nom ;
- son type texte ;
- sa valeur par défaut #NULL ;
- sa présence dans l’aperçu ou les propriétés de la Datasource.

### Ajouter un champ calculé facultatif

Pour illustrer le rôle du Hub, vous pouvez ajouter un champ calculé :

```
RemisePourcentage
```

Formule :

```
Field("Remise") * 100
```

Ce champ n’est pas indispensable au Tableau de Bord. Il montre simplement qu’un Hub peut enrichir les résultats SQL sans modifier la requête d’origine.

## Préparer la Datasource de CA détail

### Ouvrez le Hub associé à :

```
PARCOURS_01_DETAIL_COMMANDES
```

### Définir les formats

| **Champ** | **Format conseillé** |
| --- | --- |
| ChiffreAffaires | #,#,#. € |

### Tester chaque Datasource

Pour chaque Hub :

1. ouvrez l’aperçu ;
2. exécutez avec pPays = #NULL lorsqu’un paramètre existe ;
3. vérifiez les types de champs ;
4. vérifiez les libellés ;
5. vérifiez les formats ;
6. enregistrez les modifications.

**Résultat attendu**
Les six Datasources sont prêtes à être utilisées par les composants.

## Captures conseillées

![](https://wiki.biboard.fr/wp-content/uploads/2026/07/CP-C1-Datasource-detail-commandes-01-1024x617.png)

![](https://wiki.biboard.fr/wp-content/uploads/2026/07/CP-C1-Datasource-detail-commandes-03-1024x617.png)

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

---