Définition un jeu d'enregistrements sans rédiger d'instructions SQL

1. Dans la zone Nom, saisissez le nom du jeu d'enregistrements.

   Il est d'usage d'ajouter le préfixe rs aux noms des jeux d'enregistrements, afin de les distinguer des autres noms d'objet dans le code, par exemple : rsPressReleases.

   Les noms des jeux d'enregistrements ne peuvent contenir que des lettres, des chiffres et des caractères de soulignement (_). Ils ne doivent pas comporter d'espaces ni de caractères spéciaux.

2. Sélectionnez une connexion dans le menu déroulant Connexion.

   Si aucune connexion n'apparaît dans la liste, cliquez sur Définir pour en créer une.

3. Dans le menu déroulant Table, sélectionnez la table de base de données qui fournira des données au jeu d'enregistrements.

   Ce menu déroulant répertorie toutes les tables de la base de données spécifiée.

4. Pour inclure un sous-ensemble des colonnes de la table dans le jeu d'enregistrements, cliquez sur Sélectionnées, puis cliquez sur les colonnes souhaitées tout en maintenant la touche Ctrl (Windows) ou Commande (Macintosh) enfoncée.

5. Pour limiter le nombre d'enregistrements renvoyés depuis la table, complétez la section Filtre :

   • Dans le premier menu déroulant, sélectionnez un champ de la table à comparer à la valeur de référence définie.

   • Dans le deuxième menu déroulant, sélectionnez une expression conditionnelle pour comparer la valeur sélectionnée dans chaque enregistrement à la valeur de référence.

   • Dans le troisième menu déroulant, sélectionnez Valeur entrée.

   • Dans la zone, saisissez la valeur test.

     Si la valeur indiquée dans un enregistrement répond aux conditions de filtrage, l'enregistrement est inclus dans le jeu d'enregistrements.

6. (Facultatif) Pour trier les enregistrements, sélectionnez une colonne de tri, puis indiquez si les enregistrements doivent être triés dans l'ordre croissant (1, 2, 3... ou A, B, C...) ou décroissant.

7. Cliquez sur Tester pour vous connecter à la base de données et créer une instance de la source de données, et cliquez sur OK pour fermer la source de données.

   Un tableau répertoriant les données renvoyées s'affiche. Chaque ligne contient un enregistrement et chaque colonne un champ de cet enregistrement.

8. Cliquez sur OK. Le jeu d'enregistrements que vous venez de définir s'affiche dans le panneau Liaisons.

Définissez un jeu d'enregistrements pour les types de document ColdFusion comme source de contenu dynamique, sans qu'il soit nécessaire de rédiger manuellement des instructions SQL.

1. Dans la zone Nom, saisissez le nom du jeu d'enregistrements.

   Il est d'usage d'ajouter le préfixe rs aux noms des jeux d'enregistrements afin de les distinguer des autres noms d'objet dans le code. Par exemple : rsPressReleases

   Les noms des jeux d'enregistrements ne peuvent contenir que des lettres, des chiffres et des caractères de soulignement (_). Ils ne doivent pas comporter d'espaces ni de caractères spéciaux.

2. Si vous définissez un jeu d'enregistrements pour un composant ColdFusion (si un fichier CFC est ouvert dans Dreamweaver), sélectionnez une fonction CFC existante dans le menu déroulant Fonction, ou cliquez sur le bouton Nouvelle fonction pour créer une fonction.

   Remarque : Le menu déroulant Fonction n’est disponible que si le document actuel est un fichier CFC, et si vous pouvez accéder à un ordinateur exécutant ColdFusion MX 7 ou version ultérieure.

   Le jeu d'enregistrements sera défini dans cette fonction.

3. Sélectionnez une source de données dans le menu déroulant Source de données.

   Si le menu déroulant ne contient aucune source de données, vous devez créer une source de données ColdFusion.

4. Dans les zones Nom d'utilisateur et Mot de passe, tapez le nom d'utilisateur et le mot de passe permettant d'accéder au serveur d'application ColdFusion, le cas échéant.

   Il se peut qu'un nom d'utilisateur et un mot de passe soient nécessaires pour accéder aux sources de données dans ColdFusion. S'ils ne vous ont pas été communiqués, contactez l'administrateur ColdFusion de votre société.

5. Dans le menu déroulant Table, sélectionnez la table de base de données qui fournira des données au jeu d'enregistrements.

   Ce menu déroulant répertorie toutes les tables de la base de données spécifiée.

6. Pour inclure un sous-ensemble des colonnes de la table dans le jeu d'enregistrements, cliquez sur Sélectionnées, puis cliquez sur les colonnes souhaitées tout en maintenant la touche Ctrl (Windows) ou Commande (Macintosh) enfoncée.

7. Pour limiter le nombre d'enregistrements renvoyés depuis la table, complétez la section Filtre :

   • Dans le premier menu déroulant, sélectionnez un champ de la table à comparer à la valeur de référence définie.

   • Dans le deuxième menu déroulant, sélectionnez une expression conditionnelle pour comparer la valeur sélectionnée dans chaque enregistrement à la valeur de référence.

   • Dans le troisième menu déroulant, sélectionnez Valeur entrée.

   • Dans la zone, saisissez la valeur test.

     Si la valeur indiquée dans un enregistrement répond aux conditions de filtrage, l'enregistrement est inclus dans le jeu d'enregistrements.

8. (Facultatif) Pour trier les enregistrements, sélectionnez une colonne de tri, puis indiquez si les enregistrements doivent être triés dans l'ordre croissant (1, 2, 3... ou A, B, C...) ou décroissant.

9. Cliquez sur Tester pour vous connecter à la base de données et créer une instance de la source de données.

   Un tableau répertoriant les données renvoyées s'affiche. Chaque ligne contient un enregistrement et chaque colonne un champ de cet enregistrement. Cliquez sur OK pour fermer le jeu d'enregistrements test.

10. Cliquez sur OK. Le jeu d'enregistrements ColdFusion que vous venez de définir s'affiche dans le panneau Liaisons.