PDF (adobe.com)

Rédaction d'instructions SQL en vue de la définition d'un jeu d'enregistrements avancé



Rédigez vos propres instructions SQL à l'aide de la boîte de dialogue Jeu d'enregistrements avancée, ou créez une instruction SQL à l'aide de l'arborescence Eléments de base de données graphique.

  1. Dans la fenêtre de document, ouvrez la page devant utiliser le jeu d'enregistrements.
  2. Choisissez Fenêtre > Liaisons pour afficher le panneau Liaisons.
  3. Dans le panneau Liaisons, cliquez sur le bouton Plus (+) et choisissez Jeu d'enregistrements (Requête) dans le menu déroulant.

    La boîte de dialogue Jeu d'enregistrements avancée s'affiche. Si vous développez un site ColdFusion, la boîte de dialogue Jeu d'enregistrements qui s'affiche est légèrement différente. (Si la boîte de dialogue Jeu d'enregistrements simplifiée s'affiche à la place, cliquez sur le bouton Avancé pour en ouvrir la version avancée.)

  4. Définissez les options de la boîte de dialogue Jeu d'enregistrements avancée.

    Pour obtenir des instructions, consultez les rubriques ci-dessous.

  5. Cliquez sur le bouton Tester pour exécuter la requête et vérifier qu'elle récupère les informations attendues.

    Si vous avez défini un filtre qui utilise les paramètres saisis par l'utilisateur, la boîte de dialogue Valeur test s'affiche lorsque vous cliquez sur le bouton Tester. Saisissez une valeur dans la zone Valeur test et cliquez sur OK. Si la création d'une instance du jeu d'enregistrements aboutit, une table contenant les données du jeu d'enregistrements s'affiche.

  6. Cliquez sur OK pour ajouter le jeu d'enregistrements à la liste des sources de contenu disponibles du panneau Liaisons.

Options de la boîte de dialogue Jeu d'enregistrements avancée (PHP, ASP)

Définissez un jeu d'enregistrements comme source de contenu dynamique en rédigeant une instruction SQL personnalisée ou en créant une instruction SQL au moyen de l'arborescence graphique Eléments de base de données.

  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 : rsPressRelease

    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.
  3. Saisissez une instruction SQL dans la zone de texte SQL ou utilisez l'arborescence graphique Eléments de base de données située au bas de la boîte de dialogue pour créer une instruction SQL à partir du jeu d'enregistrements sélectionné.

    Pour créer une instruction SQL à l'aide de l'arborescence Eléments de base de données, procédez comme suit :

    • Vérifiez que la zone de texte SQL est vierge.

    • Développez les branches de l'arborescence jusqu'à ce que vous trouviez l'objet de base de données souhaité, par exemple une colonne de table ou une procédure stockée dans la base de données.

    • Sélectionnez l'objet de base de données et cliquez sur l'un des boutons situés à droite de l'arborescence.

      Par exemple, si vous sélectionnez une colonne de table, les boutons disponibles sont SELECT, WHERE et ORDER BY. Cliquez sur l'un de ces boutons pour insérer l'instruction associée dans l'instruction SQL.

      Vous pouvez également utiliser une instruction SQL prédéfinie issue d'une procédure stockée en sélectionnant la procédure stockée dans l'arborescence Eléments de base de données et en cliquant sur le bouton Procédure. Dreamweaver remplit automatiquement les zones SQL et Variable.

  4. Si l'instruction SQL contient des variables, définissez leurs valeurs dans la zone Variables en cliquant sur le bouton Plus (+) et en saisissant le nom de la variable, sa valeur par défaut (celle que doit prendre la variable si aucune valeur d'exécution n'est renvoyée) et sa valeur d'exécution.

    Si l'instruction SQL contient des variables, assurez-vous que la colonne Valeur par défaut de la section Variables contient des valeurs test correctes.

    La valeur d'exécution correspond généralement à un paramètre d'URL ou de formulaire saisi par l'utilisateur dans un champ de formulaire HTML.

    Paramètres d'URL dans la colonne Valeur d'exécution.

    Modèle de serveur

    Expression de la valeur d'exécution dans le cas d'un paramètre d'URL

    ASP

    Request.QueryString(“formFieldName”)

    PHP

    #formFieldName#

    Paramètres de formulaire dans la colonne Valeur d'exécution.

    Modèle de serveur

    Expression de la valeur d'exécution dans le cas d'un paramètre de formulaire

    ASP

    Request.Form(“formFieldName”)

    PHP

    #formFieldName#
  5. Cliquez sur Tester pour vous connecter à la base de données et créer une instance du jeu d'enregistrements.

    Si l'instruction SQL contient des variables, vérifiez que la colonne Valeur par défaut de la section Variables contient des valeurs test correctes avant de cliquer sur Tester.

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

  6. Si le résultat vous convient, cliquez sur OK.

Options de la boîte de dialogue Jeu d'enregistrements avancée (ColdFusion)

La boîte de dialogue Jeu d'enregistrements avancée vous permet de rédiger des requêtes SQL personnalisées ou de créer des requêtes SQL au moyen de l'interface pointer-cliquer de l'arborescence Eléments de base de données.

  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.

    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.

  2. 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 au préalable créer une source de données ColdFusion.

  3. 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é.

  4. Saisissez une instruction SQL dans la zone de texte SQL ou utilisez l'arborescence graphique Eléments de base de données située au bas de la boîte de dialogue pour créer une instruction SQL à partir du jeu d'enregistrements sélectionné.
  5. (Facultatif) Pour créer une instruction SQL à l'aide de l'arborescence Eléments de base de données, procédez comme suit :

    • Vérifiez que la zone de texte SQL est vierge.

    • Développez les branches de l'arborescence jusqu'à ce que vous trouviez l'objet souhaité, par exemple une colonne de table.

    • Sélectionnez l'objet de base de données et cliquez sur l'un des boutons situés à droite de l'arborescence.

    Par exemple, si vous sélectionnez une colonne de table, les boutons disponibles sont SELECT, WHERE et ORDER BY. Cliquez sur l'un de ces boutons pour insérer l'instruction associée dans l'instruction SQL.

    Si l'instruction SQL contient des paramètres, définissez leurs valeurs dans la zone Paramètres en cliquant sur le bouton Plus (+) et en saisissant le nom du paramètre et sa valeur par défaut (celle que doit prendre le paramètre si aucune valeur d'exécution n'est renvoyée).

    Si l'instruction SQL contient des paramètres, vérifiez que la colonne Valeur par défaut de la zone Paramètres contient des valeurs test correctes.

    Les paramètres de la page vous permettent d'indiquer les valeurs par défaut des références aux valeurs d'exécution contenues dans vos instructions SQL. Par exemple, l'instruction SQL suivante sélectionne un enregistrement d'une base de données répertoriant les employés d'une entreprise suivant la valeur du matricule de l'employé. Vous pouvez attribuer une valeur par défaut à ce paramètre pour vous assurer qu'une valeur d'exécution sera toujours renvoyée. Dans l'exemple suivant, FormFieldName désigne un champ de formulaire dans lequel les utilisateurs saisissent leur matricule :

    SELECT * FROM Employees WHERE EmpID = + (Request.Form(#FormFieldName#))

    La boîte de dialogue Add Page Parameters (Ajouter des paramètres de page) contiendrait alors une paire nom-valeur semblable à celle présentée ci-dessous :

    Nom

    Valeurs par défaut

    FormFieldName 

    0001

    La valeur d'exécution correspond généralement à un paramètre d'URL ou de formulaire saisi par l'utilisateur dans un champ de formulaire HTML.

  6. Cliquez sur Tester pour vous connecter à la base de données et créer une instance du jeu d'enregistrements.

    Si l'instruction SQL contient des références à des valeurs d'exécution, vérifiez que la colonne Valeur par défaut du champ Paramètres de la page contient des valeurs test correctes avant de cliquer sur Tester.

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

  7. Si le résultat vous convient, cliquez sur OK.

Définition de paramètres dans une instruction SQL (ColdFusion)

Définissez des paramètres dans une instruction SQL ; la valeur par défaut est celle attribuée au paramètre lorsque aucune valeur d'exécution n'est renvoyée.

  1. Sélectionnez un paramètre dans le menu déroulant Nom.
  2. Dans la zone Paramètre par défaut, saisissez la valeur par défaut que vous souhaitez attribuer au paramètre, et cliquez sur OK.

Définition de paramètres dans une instruction SQL (PHP)

Définissez des paramètres dans une instruction SQL ; la valeur par défaut est celle attribuée au paramètre lorsque aucune valeur d'exécution n'est renvoyée.

  1. Entrez un nom de paramètre dans la zone Nom.
  2. Dans la zone Paramètre par défaut, saisissez la valeur par défaut que vous souhaitez attribuer au paramètre.
  3. Tapez une valeur d'exécution dans la zone Valeur d'exécution puis sur OK.