Bloc Dashboard (Tableau de bord) : Paramètres dynamiques

Les paramètres dynamiques de requête sont un moyen de faire varier au moment de la lecture des résultats un ou pluseurs paramètres externes de la requête. Par exemple, une requête d'extraction statistique peut être valide dans une plage de date particulières. Le paramétrage dynamique permettra à l'utilisateur final de progammer sa date de début de période et de fin de période sans avoir besoin de modifier ou de rééditer la requête.

La mise en place des paramètres dynamiques va faire deux choses :

Ajouter des interfaces de saisie/configuration sur l'interface du bloc, à destination de l'usager des rapports

Permettre au programmeur de la requête d'utiliser des “marque-places” pour injecter les valeurs de l'utilisateur final dans la requête.

Types de paramètres dynamiques

Les paramètres à saisir peuvent être de plusieurs types :

Texte

Une simple valeur de texte

Insertion des paramètres utilisateurs dans la requête

Dans la version actuelle, seul le marsue-place global <PARAMS> est supporté. Il permet d'ajouter l'effet de la sélection de valeurs de paramètres dans la clause WHERE de la requête.

SELECT
username as un,
firstname as fn,
lastname as ln
FROM
{user}
WHERE
1 = 1
<%%PARAMS%%>

Dans l'exemple ci-dessus, la clause 1 = 1 permet de s'assurer du fonctionnement correct de la requête même dans le cas d'une valeur vide de <PARAMS> (absence de sélection). La clause <PARAMS> et la clause <FILTERS> peuvent être utiisées conjointement.

Revenir à l'index du guide d'utilisation