Mise en place de paramètres de requête

Vous pouvez passer des paramètres à la requête, qui permettront de filtrer la requête en temps réel grâce aux valeurs sélectionnées ou entrées par l'utilisateur.

Pour déclarer un paramètre de requête, il faut utiliser le symbole @nom_paramètre

Dans l'exemple ci-dessous la requête filtre les utilisateurs en fonction de l'email saisi dans l'invite présentée à l'utilisateur

Requête paramétrée

Dans le logiciel Biwee vous pouvez ensuite saisir la valeur du paramètre qui sera passé à la requête

Invite de commande

Lorsque le tableau de bord est consulté depuis le web, l'utilisateur a la pop up suivante :

Invite de commande sur le web

L'utilisateur sur le Web peut changer en direct la valeur des paramètres au sein de son tableau de bord, en cliquant sur l'icône ci-dessous :

Bouton de modification des valeurs des paramètres de requête

Configuration des paramètres de requête

Vous pouvez configurer vos paramètres de requête pour définir leur libellé d'affichage, le type de données, le type d'input : saisie libre/liste déroulante, saisie de date...

Pour cela, cliquez dans le menu Réglages du tableau de bord, puis dans paramètres de requête

La fenêtre de configuration s'affiche :

Configuration des paramètres de requête

Type de donnée :

• Automatic : Biwee détecte automatiquement le format des données

• String : la valeur saisie par l'utilisateur sera passée à la requête au format String. Elle sera encapsulée de ' ' automatiquement

• DateTime : l'utilisateur aura un calendrier de sélection de date afin de sélectionner sa date et la valeur sera passée à la requête dans le format précisé dans la colonne format

• Int32 : la valeur passée à la requête sera la valeur saisie par l'utilisateur, sans être encapsulée de ' '

• Decimal : la valeur passée à la requête sera la valeur saisie par l'utilisateur, sans être encapsulée de ' '

Nom d'affichage :

Ce texte sera affiché dans la boîte de dialogue affichée à l'utilisateur pour saisir les valeurs de paramètres

Valeur par défaut :

Vous pouvez spécifier unevaleur par défaut qui sera passée en paramètre à la requête. Si tous les paramètres de requête ont une valeur par défaut de saisie, l'utilisateur n'aura pas la pop up de saisie des paramètres qui s'affiche à l'ouverture du tableau de bord.

Il pourra toujours modifier la valeurs des paramètres en cliquant sur l'icône ci-dessous:

Bouton de modification des valeurs des paramètres de requête

Valeurs disponibles :

Si vous souhaitez que l'utilisateur sélectionne la valeur du paramètre dans une liste de valeur définie, vous pouvez saisir les valeurs dans cet espace, en séparant les valeurs par une ','

Ex : valeur 1, valeur 2, valeur 3 présente la liste déroulante suivante à l'utilisateur :

Sélection multiple :

Cochez cette case si vous voulez que l'utilisateur puisse saisir plusieurs valeurs dans la liste déroulante et qu'elles soient passées en valeur au paramètre

Format

Cette case est à renseigner pour les paramètres de type date uniquement, afin de préciser à Biwee sous quel format sera renvoyée la date sélectionnée par l'utilisateur dans un calendrier.

Le format à spécifier dépend du type de base de données interrogé.

SGBD	Valeur à saisir
SQL Server	'yyyy-MM-dd'
MySQL	DATE 'yyyy-MM-dd'
pOSTgRE	'yyyy-MM-dd'

Lors de l'appel IFRAME, le passage de valeurs de paramètres de type date, doit bien respecter la syntaxe attendue par le moteur SQL dans la requête. Biwee va remplacer le @parametre par la valeur saisie lors de l'appel IFRAME.

Par exemple, en SQL Server : dans l'url il faudra saisir : ?p_date=2024-10-29

Saisie API :

Si le tableau de bord est intégré en IFRAME dans une application, cochez cette case si vous voulez que l'utilisateur puisse changer les valeurs de paramètres. Sinon, ce seront uniquement les valeurs passées lors de l'appel IFRAME qui seront utilisées, et l'utilisateur ne pourra pas les modifier.