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 #

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.

Définir les formats #

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 #

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 #