Le gadget JDBCQuery affiche pour les utilisateurs une base de données JDBC préconfigurée. Des paramètres de configuration sont disponibles pour permettre à l'utilisateur de préciser le nom du pilote JDBC, les chaînes de connexion à la base de données et l'instruction de requête de la base de données. L'assistant de configuration fourni permet de personnaliser le mode d'affichage des résultats de la requête, en affichant une série de menus qui servent à configurer entièrement l'instruction de requête. Vous pouvez notamment choisir les tables et les champs à inclure, définir des filtres pour restreindre la recherche et utiliser des options de tri par colonne. Les filtres permettent d'inclure des conditions SQL standard. Les filtres comprennent également des macros de critères NDS qui utilisent des valeurs d'attribut NDS.
Voici un exemple de requête :
select Employees.FirstName,Employees.LastName,Employees.HomePhone from Employees where Employees.FirstName = '~Prénom~'
Cette requête renvoie le numéro de téléphone personnel (HomePhone), extrait de la table Employés, de l'entrée pour laquelle le prénom correspond à la valeur NDS Prénom de l'utilisateur. Le gadget remplace automatiquement ~Prénom~ par la valeur NDS de l'attribut 'Prénom' de l'utilisateur.
Utilisez les informations des sections suivantes comme guides pour la configuration du gadget JDBCQuery.
Cette section décrit les champs et les paramètres de configuration des quatre pages de l'assistant Configuration de l'assignation de gadgets. Pour obtenir des instructions sur la configuration d'une requête de base de données, reportez-vous à Configuration d'une requête de base de données.
Toutes les pages de configuration de l'assistant sont divisées en deux sections. La section supérieure fournit des informations de configuration et la section inférieure contient une vue des résultats des paramètres actuels. Tous les boutons de ces pages permettent de mettre à jour les résultats. Vous disposez du bouton Rafraîchir les résultats de la requête pour rafraîchir les résultats après le changement d'une zone de modification.
Vous pouvez modifier les paramètres JDBCClass, JDBCConnect, DVUsername et DCPassword sur la page de configuration.
Modifiez les paramètres JDBCClass, JDBCConnect, DVUsername et DCPassword en fonction des informations que vous utilisez.
Cliquez sur Connecter.
Si les valeurs de connexion définies dans Etape 1 sont correctes, un message confirme l'établissement de la connexion.
Sélectionnez les options permettant de modifier le mode d'affichage des résultats de la requête dans le gadget.
Après avoir modifié une option, vous pouvez cliquer sur le bouton Rafraîchir les résultats de la requête pour afficher les résultats produits par les nouveaux paramètres choisis.
Cliquez sur Terminer pour enregistrer les modifications et quitter l'assistant.
Pour obtenir des instructions sur l'élaboration d'une requête de base de données, passez à la section suivante.
Vous ne pouvez construire une instruction de requête qu'après vous être connecté à la base de données.
Cliquez sur Créer l'instruction de requête.
Sélectionnez une table dans la liste et cliquez sur Changer la table.
Sélectionnez dans la liste l'un des champs disponibles et effectuez l'une des opérations suivantes :
Vous pouvez sélectionner le nombre de champs de votre choix pour les inclure dans votre requête.
Cliquez sur l'assistant Créer l'instruction de requête.
Cliquez sur Ajouter/Modifier.
Sélectionnez la colonne à utiliser comme critère de filtre et cliquez sur Ajouter le filtre.
(Facultatif) Répétez l'opération Etape 3 pour ajouter des paramètres au filtre.
Vous pouvez construire des filtres de requête plus complexes en insérant AND et OR dans l'instruction de requête.
Cliquez sur Terminer > OK > Enregistrer > Fermer.