Définition de sources de contenu dynamique

Dernière mise à jour le 25 avr. 2024
Annotation

L’interface utilisateur a été simplifiée sous Dreamweaver et versions ultérieures. Par conséquent, il se peut que vous ne trouviez pas certaines options décrites dans cet article sous Dreamweaver et versions ultérieures. Pour plus d’informations, consultez cet article.

Définir un recordset sans écrire de SQL

Vous pouvez créer un recordset sans saisir manuellement des instructions SQL.

Dans la fenêtre Document, ouvrez la page qui va utiliser le recordset.
Sélectionnez Fenêtre > Liaisons pour afficher le panneau Liaisons.
Dans le panneau Liaisons, cliquez sur le bouton Plus (+) et sélectionnez Recordset (Requête) dans le menu contextuel.

La boîte de dialogue Jeu d’enregistrements simplifiée s’affiche. Si vous développez un site ColdFusion, la boîte de dialogue Recordset est légèrement différente.(Si la boîte de dialogue Recordset avancée apparaît à la place, cliquez sur le bouton Simple pour passer à la boîte de dialogue Recordset simple.)

Complétez les options de la boîte de dialogue Jeu d’enregistrements pour votre type de document.

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

Cliquez sur le bouton Test pour exécuter la requête et vous assurer qu'elle récupère les informations souhaitées.

Si vous avez défini un filtre qui utilise des paramètres saisis par les utilisateurs, saisissez une valeur dans la zone Valeur de test, puis cliquez sur OK.Si une Instance du recordset est créée avec succès, un tableau apparaît qui affiche les données extraites du recordset.

Cliquez sur OK pour ajouter le recordset à la liste des sources de contenu disponibles dans le panneau Liaisons.

Options de la boîte de dialogue Recordset simple (PHP, ASP)

Dans la zone Nom, entrez un nom pour le recordset.

Une pratique courante consiste à ajouter le préfixe rs aux noms de recordset pour les distinguer des autres noms d'objets dans le code, par exemple : rsPressReleases.

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

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.

Dans le menu contextuel Tableau, sélectionnez le tableau de base de données qui fournira les données au recordset.

Le menu contextuel affiche tous les tableaux de la base de données spécifiée.

Pour inclure un sous-ensemble des colonnes du tableau dans le recordset, cliquez sur Sélectionné et choisissez les colonnes souhaitées en cliquant dessus tout en maintenant la touche Contrôle enfoncée (Windows) ou Commande enfoncée (Macintosh) dans la liste.

Pour limiter davantage les enregistrements renvoyés par le tableau, complétez la section Filtre :

  • Dans le premier menu contextuel, sélectionnez une colonne de la table de base de données à comparer avec une valeur de test que vous définissez.

  • Dans le second menu contextuel, sélectionnez une expression conditionnelle pour comparer la valeur sélectionnée dans chaque enregistrement avec la valeur de test.

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

  • Dans la zone, saisissez la valeur test.

    Si la Valeur spécifiée dans un enregistrement répond à votre condition de filtrage, l'enregistrement est inclus dans le recordset.

(Facultatif) Pour trier les enregistrements, sélectionnez une colonne de tri, puis spécifiez si les enregistrements doivent être triés par ordre croissant (1, 2, 3... ou A, B, C...) ou ordre décroissant.

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

Un tableau apparaît affichant les données renvoyées. Chaque ligne contient un enregistrement et chaque colonne représente un champ de cet enregistrement.

Cliquez sur OK. Le jeu d'enregistrements nouvellement défini apparaît dans le panneau Liaisons.

Options de la boîte de dialogue Jeu d'enregistrements simple (ColdFusion)

Définissez un jeu d'enregistrements pour les types de document ColdFusion comme une source de contenu dynamique sans avoir à coder manuellement des instructions SQL.

Dans la zone Nom, saisissez un nom pour le jeu d'enregistrements.

Une pratique courante consiste à ajouter le préfixe rs aux noms de jeux d'enregistrements pour les distinguer des autres noms d'objets dans votre code.Par exemple : rsPressReleases

Les noms de jeux d'enregistrements ne peuvent contenir que des lettres, des chiffres et le caractère 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 (c'est-à-dire si un fichier CFC est actuellement 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 nouvelle fonction.

Annotation

Le menu contextuel Fonction n'est disponible que si un fichier CFC est le document actuel et que vous avez accès à un ordinateur exécutant ColdFusion MX 7 ou une version ultérieure.

Le jeu d'enregistrements est défini dans la fonction.

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

Si aucune source de données n'apparaît dans le menu contextuel, vous devez créer une source de données ColdFusion.

Dans les zones Nom d'utilisateur et Mot de passe, saisissez le nom d'utilisateur et le mot de passe pour le serveur d'application ColdFusion si nécessaire.

Les sources de données dans ColdFusion peuvent nécessiter un nom d'utilisateur et un mot de passe pour y accéder. Si vous n'avez pas le nom d'utilisateur et le mot de passe pour accéder à une source de données dans ColdFusion, contactez l'administrateur ColdFusion de votre organisation.

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

Le menu contextuel Table affiche toutes les tables de la base de données spécifiée.

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

Pour limiter davantage les enregistrements renvoyés par la table, complétez la section Filtre :

  • Dans le premier menu contextuel, sélectionnez une colonne de la table de base de données à comparer par rapport à une valeur de test que vous définissez.

  • Dans le deuxième menu contextuel, sélectionnez une expression conditionnelle pour comparer la valeur sélectionnée dans chaque enregistrement avec la valeur de test.

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

  • Dans la zone, saisissez la valeur test.

    Si la valeur spécifiée dans un enregistrement répond à votre condition de filtrage, l'enregistrement est inclus dans le jeu d'enregistrements.

(Facultatif) Pour trier les enregistrements, sélectionnez une colonne de tri, puis spécifiez si les enregistrements doivent être triés par ordre croissant (1, 2, 3... ou A, B, C…)ou ordre décroissant.

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

Un tableau apparaît et affiche les données renvoyées. Chaque ligne contient un enregistrement et chaque colonne représente un champ dans cet enregistrement. Cliquez sur OK pour fermer le jeu d’enregistrements test.

Cliquez sur OK. Le jeu d'enregistrement ColdFusion nouvellement défini apparaît dans le panneau Liaisons.

Définir un jeu d'enregistrements avancé en écrivant du code SQL

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

Dans la fenêtre de document, ouvrez la page qui utilise le jeu d'enregistrements.
Sélectionnez Fenêtre > Liaisons pour afficher le panneau Liaisons.
Dans le panneau Liaisons, cliquez sur le bouton Plus (+) et sélectionnez Jeu d'enregistrements (Requête) dans le menu contextuel.

La boîte de dialogue Jeu d’enregistrements avancée s’affiche. Si vous développez un emplacement ColdFusion, la boîte de dialogue Jeu d'enregistrements est légèrement différente. (Si la boîte de dialogue Jeu d'enregistrements simple apparaît à la place, passez à la boîte de dialogue Jeu d'enregistrements avancé en cliquant sur le bouton Avancé.)

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

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

Cliquez sur le bouton Test pour exécuter la requête et vous assurer qu'elle récupère les informations que vous souhaitiez.

Si vous avez défini un filtre qui utilise des paramètres saisis par les utilisateurs, le bouton Test affiche la boîte de dialogue Valeur de test. Saisissez une valeur dans la zone Valeur de test et cliquez sur OK. Si une instance du jeu d'enregistrements est créée avec succès, un tableau affichant les données du jeu d'enregistrements apparaît.

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

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

Définissez un jeu d'enregistrements comme source de contenu dynamique en écrivant une instruction SQL personnalisée, ou en créant une instruction SQL à l'aide de l'arborescence graphique Éléments de base de données.

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

Une pratique courante consiste à ajouter le préfixe rs aux noms de jeux d'enregistrements pour les distinguer des autres noms d'objets dans le code. Par exemple : rsPressRelease

Les noms de jeux d'enregistrements ne peuvent contenir que des lettres, des chiffres et le caractère de soulignement (_).Vous ne pouvez pas utiliser de caractères spéciaux ou d'espaces.

Sélectionnez une connexion dans le menu déroulant Connexion.
Saisissez une instruction SQL dans la zone de texte SQL ou utilisez l'arborescence graphique Éléments de base de données en bas de la boîte de dialogue pour créer une instruction SQL à partir du jeu d'enregistrements choisi.

Procédez comme suit pour utiliser l'arborescence Éléments de base de données pour créer l'instruction SQL :

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

  • Développez les branches de l'arbre jusqu'à ce que vous trouviez l'objet de base de données dont vous avez besoin : une colonne dans une table, par exemple, 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 sur le côté droit de l'arbre.

    Par exemple, si vous sélectionnez une colonne de table, les boutons disponibles sont SELECT, WHERE et ORDER BY. Cliquez sur l'un des boutons pour ajouter la clause associée à votre instruction SQL.

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

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, son type (entier, texte, date ou nombre à virgule flottante), sa valeur par défaut (la valeur que la variable doit prendre si aucune valeur d'exécution n'est renvoyée) et sa valeur d'exécution.
Annotation

Lorsque vous utilisez des variables dans une instruction SQL en PHP, Dreamweaver ajoute automatiquement un signe dollar au début du nom de la variable. Vous devez donc omettre le signe dollar (par exemple, colname au lieu de $colname).

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

La valeur d'exécution est généralement une URL ou un paramètre de formulaire saisi par un 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

$_GET['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

$_POST[’formFieldName’]

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

Si l'instruction SQL contient des variables, assurez-vous que la colonne Valeur par défaut de la zone Variables contient des valeurs de test valides avant de cliquer sur Test.

En cas de succès, une table s'affiche avec les données de votre jeu d'enregistrements.Chaque ligne contient un enregistrement et chaque colonne représente un champ de cet enregistrement. Cliquez sur OK pour effacer le jeu d'enregistrements.

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

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

Utilisez la boîte de dialogue Jeu d'enregistrements avancé pour rédiger des requêtes SQL personnalisées, ou utilisez l'arbre des éléments de base de données pour créer des requêtes SQL à l'aide d'une interface pointer-cliquer.

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

Une pratique courante consiste à ajouter le préfixe rs aux noms de jeux d'enregistrements pour les distinguer des autres noms d'objets dans votre code.Par exemple : rsPressReleases

Les noms de jeux d'enregistrements ne peuvent contenir que des lettres, des chiffres et le caractère 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 (c'est-à-dire si un fichier CFC est actuellement ouvert dans Dreamweaver), sélectionnez une fonction CFC existante dans le menu contextuel Fonction ou cliquez sur le bouton Nouvelle fonction pour créer une nouvelle fonction.

Annotation

Le menu contextuel Fonction n'est disponible que si un fichier CFC est le document actuel et que vous avez accès à un ordinateur exécutant ColdFusion MX 7 ou version ultérieure.

Le jeu d'enregistrements est défini dans la fonction.

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

Si aucune source de données n'apparaît dans la liste du menu déroulant, vous devez d'abord créer une source de données ColdFusion.

Dans les zones Nom d'utilisateur et Mot de passe, entrez le nom d'utilisateur et le mot de passe pour le serveur d'application ColdFusion si nécessaire.

Les sources de données dans ColdFusion peuvent nécessiter un nom d'utilisateur et un mot de passe pour y accéder. Si vous ne disposez pas du nom d'utilisateur et du mot de passe pour accéder à une source de données dans ColdFusion, contactez l'administrateur ColdFusion de votre organisation.

Entrez une instruction SQL dans la zone de texte SQL ou utilisez l'arborescence graphique Éléments de la base de données en bas de la boîte de dialogue pour créer une instruction SQL à partir du recordset choisi.
(Facultatif) Procédez comme suit pour utiliser l'arborescence Éléments de la base de données afin de créer l'instruction SQL :
  • Vérifiez que la zone de texte SQL est vierge.

  • Développez les branches de l'arborescence jusqu'à trouver l'objet de base de données dont vous avez besoin, par exemple une colonne dans une table.

  • Sélectionnez l'objet de base de données et cliquez sur l'un des boutons situés sur le côté droit 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 des boutons pour ajouter la clause associée à votre instruction SQL.

Si votre 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 (la valeur que le paramètre doit prendre si aucune valeur d'exécution n'est renvoyée).

Si l'instruction SQL contient des paramètres, assurez-vous que la colonne Valeur par défaut de la zone Paramètres contient des valeurs de test valides.

Les Paramètres de page permettent de fournir des valeurs par défaut pour les références de valeur d'exécution dans le SQL que vous écrivez. Par exemple, l'instruction SQL suivante sélectionne un enregistrement d'employé basé sur la valeur de l'ID de l'employé. Vous pouvez attribuer une valeur par défaut à ce paramètre, garantissant qu'une valeur d'exécution est toujours renvoyée. Dans cet exemple, FormFieldName fait référence à un champ de formulaire dans lequel l'utilisateur saisit un ID d'employé :

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

La boîte de dialogue Ajouter des paramètres de page contiendrait un appariement nom-valeur similaire à :

Nom

Valeurs par défaut

FormFieldName

0001

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

Cliquez sur Test pour vous connecter à la base de données et créer une instance du recordset.

Si l'instruction SQL contient des références d'exécution, assurez-vous que la colonne Valeur par défaut du champ Paramètres de page contient des valeurs de test valides avant de cliquer sur Test.

En cas de succès, un tableau apparaît affichant les données de votre recordset. Chaque ligne contient un enregistrement et chaque colonne représente un champ de cet enregistrement. Cliquez sur OK pour effacer le recordset.

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

Définir des paramètres dans une instruction SQL (ColdFusion)

Définissez des paramètres dans une instruction SQL ; la valeur par défaut est la valeur que le paramètre doit utiliser si aucune valeur d'exécution n'est renvoyée.

Sélectionnez un paramètre dans le menu déroulant Nom.
Saisissez une valeur par défaut pour le paramètre dans la zone Paramètre par défaut, puis cliquez sur OK.

Définir des paramètres dans une instruction SQL (PHP)

Définissez des paramètres dans une instruction SQL ; la valeur par défaut est la valeur que le paramètre doit utiliser si aucune valeur d'exécution n'est renvoyée.

Entrez un nom de paramètre dans la zone Nom.
Saisissez une valeur par défaut pour le paramètre dans la zone Paramètre par défaut.
Saisissez une valeur d'exécution pour un paramètre dans la zone Valeur d'exécution, puis cliquez sur OK.

Créer des requêtes SQL à l'aide de l'arborescence des éléments de base de données

Au lieu de saisir manuellement des instructions SQL dans la zone SQL, vous pouvez utiliser l'interface pointer-cliquer de l'élément de base de données pour créer des requêtes SQL complexes.L'arborescence des éléments de base de données vous permet de sélectionner des objets de base de données et de les lier à l'aide des clauses SQL SELECT, WHERE et ORDER BY.Après avoir créé une requête SQL, vous pouvez définir toutes les variables à l'aide de la zone Variables de la boîte de dialogue.

Les deux exemples suivants décrivent deux instructions SQL et les étapes de leur création à l'aide de l'arborescence des éléments de base de données de la boîte de dialogue Recordset avancée.

Exemple : Sélection d’une table

Cet exemple sélectionne l'intégralité du contenu de la table Employees.L'instruction SQL définissant la requête s'affiche comme suit :

SELECT * FROM Employees

Pour créer cette requête, procédez comme suit.

Développez la branche Tables pour afficher toutes les tables de la base de données sélectionnée.
Sélectionnez la table Employees.
Cliquez sur le bouton Select.
Cliquez sur OK pour ajouter le jeu d’enregistrements au panneau Liaisons.

Exemple : sélection de lignes spécifiques d'une table et classement des résultats

L'exemple suivant sélectionne deux lignes de la table Employees et sélectionne le type de poste à l'aide d'une variable que vous devez définir.Les résultats sont ensuite classés par nom d’employé.

SELECT emplNo, emplName

FROM Employees

WHERE emplJob = 'varJob'

ORDER BY emplName

Développez la branche Tables pour afficher toutes les tables de la base de données sélectionnée ; développez ensuite la table Employees pour afficher les lignes de la table.
Générez l'instruction SQL en procédant de la façon suivante :
  • Sélectionnez emplNo, puis cliquez sur le bouton Sélectionner.

  • Sélectionnez emplName, puis cliquez sur le bouton Sélectionner.

  • Sélectionnez emplJob, puis cliquez sur le bouton Where.

  • Sélectionnez emplName, puis cliquez sur le bouton Trier par.

Placez le point d'insertion après WHERE emplJob dans la zone de texte SQL et saisissez ='varJob' (en incluant le signe égal).
Définissez la Variable 'varJob' en cliquant sur le bouton Plus (+) dans la zone Variables et en saisissant les valeurs suivantes dans les colonnes Nom, Valeur par défaut et Valeur d'exécution : varJob, CLERK, Request("job").
Cliquez sur OK pour ajouter le jeu d’enregistrements au panneau Liaisons.

Définition de paramètres d’URL

Les paramètres d'URL stockent les informations saisies par les utilisateurs.Avant de commencer, assurez-vous de transmettre un formulaire ou un paramètre d'URL au serveur.Après avoir défini la variable URL, vous pouvez utiliser sa valeur dans la page actuellement sélectionnée.

Dans la fenêtre Document, ouvrez la page qui utilisera la variable.
Sélectionnez Fenêtre > Liaisons pour afficher le panneau Liaisons.
Dans le panneau Liaisons, cliquez sur le bouton Plus (+) et sélectionnez l'une des options suivantes dans le menu contextuel :

Types de document

Elément du menu du panneau Liaisons permettant de définir une variable d’URL

ASP

Variable de demande > Request.QueryString

ColdFusion

Variable d’URL

PHP

Variable d’URL

Dans la boîte de dialogue Variable URL, saisissez le nom de la variable URL dans la zone, puis cliquez sur OK.

Le nom de la variable URL est normalement le nom du champ de formulaire HTML ou de l'objet utilisé pour obtenir sa valeur.

La variable d’URL s’affiche dans le panneau Liaisons.

Définition de paramètres de formulaire

Les paramètres de formulaire stockent les informations récupérées qui sont incluses dans la requête HTTP pour une page web.Si vous créez un formulaire qui utilise la méthode POST, les données soumises par le formulaire sont transmises au serveur.Avant de commencer, assurez-vous de transmettre un paramètre de formulaire au serveur.Après avoir défini le paramètre de formulaire comme source de contenu, vous pouvez utiliser sa valeur dans votre page.

Dans la fenêtre Document, ouvrez la page qui utilisera la variable.
Sélectionnez Fenêtre > Liaisons pour afficher le panneau Liaisons.
Dans le panneau Liaisons, cliquez sur le bouton Plus (+) et sélectionnez l'une des options suivantes dans le menu contextuel :

Types de document

Elément du menu du panneau Liaisons permettant de définir une variable de formulaire

ASP

Variable de demande > Request.Form

ColdFusion

Variable de formulaire

PHP

Variable de formulaire

Dans la boîte de dialogue Variable de formulaire, saisissez le nom de la variable de formulaire, puis cliquez sur OK.Le nom du paramètre de formulaire est normalement le nom du champ de formulaire HTML ou de l'objet utilisé pour obtenir sa valeur.

Le paramètre de formulaire s’affiche dans le panneau Liaisons.

Panneau liaisons avec formulaire prolongé
Panneau liaisons avec formulaire prolongé

Définition de variables de session

Vous pouvez utiliser les variables de session pour stocker et afficher les informations maintenues pendant la durée de la visite (ou session) d'un utilisateur.Le serveur crée un objet de session différent pour chaque utilisateur et le maintient pendant une période définie ou jusqu'à ce que l'objet soit explicitement arrêté.

Avant de définir les variables de session pour une page, vous devez les créer dans le code source.Après avoir créé une Variable de session dans le code source de l'application web, vous pouvez utiliser Dreamweaver pour récupérer sa Valeur et l'utiliser dans une page web.

Créez une variable de session dans le code source et attribuez-lui une valeur.

Par exemple, cet exemple ColdFusion instancie une session appelée username et lui attribue la valeur Cornelius :

<CFSET session.username = Cornelius>

Sélectionnez Fenêtre > Liaisons pour afficher le panneau Liaisons.
Cliquez sur le bouton Plus (+) et sélectionnez Variable de session dans le menu contextuel.
Saisissez le nom de la variable que vous avez définie dans le code source de l'application, puis cliquez sur OK.

Définir des variables d'application pour ASP et ColdFusion

Dans ASP et ColdFusion, vous pouvez utiliser des variables d'application pour stocker et afficher des informations qui sont maintenues pendant toute la durée de vie de l'application et persistent d'un utilisateur à l'autre.Après avoir défini la variable d'application, vous pouvez utiliser sa valeur dans une page.

Annotation

Il n'y a pas d'objets de Variable d'application dans PHP.

Ouvrez un type de document dynamique dans la fenêtre de document.
Sélectionnez Fenêtre > Liaisons pour afficher le panneau Liaisons.
Cliquez sur le bouton Plus (+) et sélectionnez Variable d'application dans le menu contextuel.
Entrez le nom de la Variable telle que définie dans le code source de l'application et cliquez sur OK.

La variable d'application apparaît dans le panneau Liaisons sous l'icône Application.

Panneau liaisons avec application détaillée
Panneau liaisons avec application détaillée

Utiliser une variable comme source de données pour un recordset ColdFusion

Lorsque vous définissez un recordset pour une page dans le panneau Liaisons, Dreamweaver saisit le nom de la source de données ColdFusion dans la balise cfquery sur la page.Pour plus de flexibilité, vous pouvez stocker un nom de source de données dans une variable et utiliser la variable dans la balise cfquery.Dreamweaver fournit une méthode visuelle pour spécifier une telle variable dans vos recordsets.

Assurez-vous qu'une page ColdFusion est active dans la fenêtre document.
Dans le panneau Liaisons, cliquez sur le bouton Plus (+) et sélectionnez Variable de nom de source de données dans le menu contextuel.

La boîte de dialogue Variable du nom de source de données s’affiche.

Définissez une variable, puis cliquez sur OK.
Lors de la définition du recordset, sélectionnez la Variable comme source de données pour le recordset.

Dans la boîte de dialogue Recordset, la Variable apparaît dans le menu contextuel Source de données avec les sources de données ColdFusion sur le serveur.

Complétez les options de la boîte de dialogue Jeu d’enregistrements, puis cliquez sur OK.
Initialisez la variable.

Dreamweaver n'initialise pas la Variable pour vous afin que vous puissiez l'initialiser comme et où vous le souhaitez. Vous pouvez initialiser la Variable dans le code de page (avant la balise cfquery), dans un fichier d'inclusion, ou dans un autre fichier comme Variable de session ou d'application.

Définition de variables de serveur

Vous définissez des variables de serveur comme sources de contenu dynamique à utiliser dans une application web.Variables de serveur varient d'un type de document à l'autre et incluent les variables de formulaire, les variables d'URL, les variables de session et les variables d'application.

Les variables de serveur peuvent être consultées par tous les clients qui accèdent au serveur, et par toutes les applications s'exécutant sur le serveur.Les variables persistent jusqu'à ce que le serveur soit arrêté.

Définition de variables de serveur ColdFusion

Ouvrez le panneau Liaisons (Fenêtre > Liaisons).Dans la boîte de dialogue Variable de serveur, saisissez le nom de la variable de serveur, puis cliquez sur OK.
Cliquez sur le bouton Plus (+) et sélectionnez la variable de serveur dans le menu contextuel.
Saisissez le nom de l’objet, puis cliquez sur OK. La variable de serveur ColdFusion apparaît dans le panneau Liaisons.

Le tableau suivant répertorie les variables de serveur ColdFusion intégrées :

Variable

Description

Server.ColdFusion.ProductName

Nom de produit de ColdFusion.

Server.ColdFusion.ProductVersion

Numéro de version de ColdFusion.

Server.ColdFusion.ProductLevel

Édition de ColdFusion (édition entreprise ou professionnelle).

Server.ColdFusion.SerialNumber

Numéro de série de la version actuellement installée de ColdFusion.

Server.OS.Name

Nom du système d'exploitation s'exécutant sur le serveur (Windows XP, Windows 2000, Linux).

Server.OS.AdditionalInformation

Informations supplémentaires sur le système d'exploitation installé (service packs, mises à jour).

Server.OS.Version

Version du système d’exploitation installé.

Server.OS.BuildNumber

Numéro de compilation du système d’exploitation installé.

Définition d’une variable locale ColdFusion

Les variables locales sont des variables créées avec la balise CFSET ou CFPARAM dans une page ColdFusion.La Variable locale définie apparaît dans le panneau Liaisons.

Dans la boîte de dialogue Variable locale, saisissez le nom de la variable locale et cliquez sur OK.

Définition de variables de serveur ASP

Vous pouvez définir les variables de serveur ASP suivantes comme sources de contenu dynamique : Request.Cookie, Request.QueryString, Request.Form, Request.ServerVariables, et Request.ClientCertificates.

Ouvrez le panneau Liaisons (Fenêtre > Liaisons).
Cliquez sur le bouton Plus (+), puis sélectionnez Variable de requête dans le menu contextuel.
Dans la boîte de dialogue Variable de requête, sélectionnez l'une des collections de requête suivantes dans le menu contextuel Type :

L’ensemble QueryString

Récupère les informations ajoutées à l'URL de la page d'envoi, comme lorsque la page contient un formulaire HTML utilisant la méthode GET. La chaîne de requête se compose d'une ou plusieurs paires nom-Valeur (par exemple, last=Smith, first=Winston) ajoutées à l'URL avec un point d'interrogation (?). Si la chaîne de requête contient plusieurs paires nom-valeur, elles sont combinées avec des esperluettes (&).

L’ensemble Form

Récupère les informations de formulaire incluses dans le corps de la requête HTTP par un formulaire HTML utilisant la méthode POST.

L’ensemble ServerVariables

Récupère les valeurs de variables d’environnement prédéfinies. La collection comporte une longue liste de variables, notamment CONTENT_LENGTH (la longueur du contenu soumis dans la requête HTTP, que vous pouvez utiliser pour vérifier si un formulaire est vide), et HTTP_USER_AGENT (fournit des informations sur le navigateur de l'Utilisateur).

Par exemple, Request.ServerVariables(&quot;HTTP_USER_AGENT&quot;) contient des informations sur le navigateur qui envoie la requête, telles que Mozilla/4.07 [en] (WinNT; I), qui indique un navigateur Netscape Navigator 4.07.

Pour obtenir une liste complète des variables d'environnement de serveur ASP, consultez la documentation en ligne installée avec Microsoft Personal Web Server (PWS) ou Internet Information Server (IIS).

L’ensemble Cookies

Récupère les valeurs des cookies envoyés dans une demande HTTP. Par exemple, supposons que la page lise un cookie appelé « readMe » sur le système de l'Utilisateur. Sur le serveur, les valeurs du cookie sont stockées dans la variable Request.Cookies(&quot;readMe&quot;).

L’ensemble ClientCertificate

Récupère les champs de certification de la requête HTTP envoyée par le navigateur. Les champs de certification sont spécifiés dans la norme X.509.

Spécifiez la Variable dans la collection à laquelle vous voulez accéder, puis cliquez sur OK.

Par exemple, si vous voulez accéder aux informations dans la variable Request.ServerVariables(&quot;HTTP_USER_AGENT&quot;), saisissez l'argument HTTP_USER_AGENT.Si vous voulez accéder aux informations dans la variable Request.Form(&quot;lastname&quot;), saisissez l'argument lastname.

La Variable de requête apparaît dans le panneau Liaisons.

Définition de variables de serveur PHP

Définissez les variables serveur comme source de contenu dynamique pour les pages PHP. Les variables serveur PHP apparaissent dans le panneau Liaisons.

Ouvrez le panneau Liaisons (Fenêtre > Liaisons).
Cliquez sur le bouton Plus (+), puis sélectionnez la Variable dans le menu contextuel.
Dans la boîte de dialogue Variable de requête, saisissez le nom de la variable (par exemple, REQUEST_METHOD), puis cliquez sur OK.

Pour plus d'informations, recherchez le mot-clé $_SERVER dans la documentation PHP.

Définition d’une variable client ColdFusion

Définissez une variable client ColdFusion comme source de contenu dynamique pour la page.Les nouvelles variables client ColdFusion définies apparaissent dans le panneau Liaisons.

Dans la boîte de dialogue Variable client, saisissez le nom de la variable, puis cliquez sur OK.

Par exemple, pour accéder aux informations dans la variable ColdFusion Client.LastVisit, saisissez LastVisit.

Les variables client sont des variables créées dans le code pour associer des données à un client spécifique. Les variables client maintiennent l'état de l'application lorsque l'utilisateur passe d'une page à l'autre dans l'application, ainsi que d'une session à l'autre.

Il existe deux types de variables serveur : les variables intégrées et les variables définies par l’utilisateur. Le tableau ci-dessous répertorie les variables client ColdFusion intégrées :

Variable

Description

Client.CFID

Un ID incrémentiel pour chaque client qui se connecte au serveur.

Client.CFTOKEN

Un nombre généré de façon aléatoire utilisé pour identifier de manière unique un client particulier.

Client.URLToken

Une combinaison de CFID et CFTOKEN à faire transiter entre les modèles lorsque les cookies ne sont pas utilisés.

Client.LastVisit

Enregistre la date et heure de la dernière visite effectuée par un client.

Client.HitCount

Le nombre de requêtes de page liées à un seul client (suivi à l'aide de CFID et CFTOKEN).

Client.TimeCreated

Enregistre la date et heure de création initiale de CFID et CFTOKEN pour un client particulier.

Les variables cookie sont créées dans le code, et accèdent aux informations contenues dans les cookies transmis au serveur par un navigateur. La variable cookie définie apparaît dans le panneau Bindings.

Dans la boîte de dialogue Variable cookie, saisissez le nom de la variable cookie, puis cliquez sur OK.

Définition d’une variable CGI ColdFusion

La variable CGI définie apparaît dans le panneau Liaisons.

Dans la boîte de dialogue Variable CGI, saisissez le nom de la variable, puis cliquez sur OK.

Par exemple, si vous voulez accéder aux informations de la variable CGI.HTTP_REFERER , saisissez HTTP_REFERER.

Le tableau suivant répertorie les variables CGI ColdFusion les plus courantes qui sont créées sur le serveur :

Variable

Description

SERVER_SOFTWARE

Le nom et la version du logiciel de serveur d'information qui répond à la requête (et qui exécute la passerelle).Format : nom/version.

SERVER_NAME

Le nom d'hôte, l'alias DNS ou l'adresse IP du serveur tel qu'il apparaît dans les URL faisant référence au serveur lui-même.

GATEWAY_INTERFACE

La révision de la spécification CGI à laquelle ce serveur se conforme. Format : CGI/révision.

SERVER_PROTOCOL

Le nom et la révision du protocole d'informations avec lequel cette requête est arrivée. Format : protocole/révision.

SERVER_PORT

Le numéro de port auquel la requête a été envoyée.

REQUEST_METHOD

Méthode utilisée pour l’exécution de la demande. Dans le cas de HTTP, il s'agit de Get, Head, Post, etc.

PATH_INFO

Les informations de chemin d'accès supplémentaires, telles que fournies par le client. Les scripts peuvent être accessibles par leur nom de chemin d'accès virtuel, suivi d'informations supplémentaires à la fin de ce chemin d'accès. Les informations supplémentaires sont envoyées sous forme de PATH_INFO.

PATH_TRANSLATED

Le serveur fournit une version traduite de PATH_INFO, qui prend le chemin d'accès et effectue tout mappage du virtuel vers le physique sur celui-ci.

SCRIPT_NAME

Un chemin d'accès virtuel vers le script en cours d'exécution ; utilisé pour les URL d'autoréférence.

QUERY_STRING

Les informations de requête qui suivent le point d'interrogation (?)dans l'URL référençant le script.

REMOTE_HOST

Nom de l'hôte à l'origine de la demande. Si le serveur ne dispose pas de ces informations, il définit REMOTE_ADDR et ne définit pas REMOTE_HOST.

REMOTE_ADDR

L'adresse IP de l'hôte distant qui effectue la requête.

AUTH_TYPE

Si le serveur prend en charge l'authentification utilisateur, et que le script est protégé, il s'agit de la méthode d'authentification spécifique au protocole utilisée pour valider l'utilisateur.

REMOTE_USER AUTH_USER

Si le serveur prend en charge l'authentification utilisateur et que le script est protégé, il s'agit du nom d'utilisateur sous lequel l'authentification a eu lieu.(disponible également sous la forme AUTH_USER).

REMOTE_IDENT

Si le serveur HTTP prend en charge l'identification RFC 931, cette variable est définie sur le nom d'utilisateur distant récupéré à partir du serveur.Utilisez cette variable uniquement pour la connexion.

CONTENT_TYPE

Pour les requêtes qui ont des informations jointes, telles que HTTP POST et PUT, il s'agit du type de contenu des données.

CONTENT_LENGTH

La longueur du contenu telle que fournie par le client.

Le tableau suivant répertorie les variables CGI les plus courantes créées par le navigateur et transmises au serveur :

Variable

Description

HTTP_REFERER

Document de référence. Il s'agit du document qui a établi un lien vers les données de formulaire ou les a soumises.

HTTP_USER_AGENT

Le navigateur que le client utilise actuellement pour envoyer la requête. Format : logiciel/version bibliothèque/version.

HTTP_IF_MODIFIED_SINCE

Date de la dernière modification de la page. Cette variable est envoyée à la discrétion du navigateur, généralement en réponse au serveur ayant envoyé l'en-tête HTTP LAST_MODIFIED. Elle peut être utilisée pour tirer parti du cache côté navigateur.

Mise en mémoire cache de sources de contenu

Vous pouvez mettre en cache ou stocker les sources de contenu dynamique dans une note de conception.Cela vous permet de travailler sur un site même si vous n'avez pas accès à la base de données ou au serveur d'applications qui stocke les sources de contenu dynamique.La mise en cache peut également accélérer le développement en éliminant les accès répétés sur le réseau vers la base de données et le serveur d'applications.

Cliquez sur le bouton de flèche dans le coin supérieur droit du panneau Liaisons et activez/désactivez Cache dans le menu contextuel.

Si vous apportez des modifications à l'une des sources de contenu, vous pouvez actualiser le cache en cliquant sur le bouton Actualiser (l'icône flèche circulaire) dans le coin supérieur droit du panneau Liaisons. (Développez le panneau si vous ne voyez pas le bouton.)

Modification ou suppression de sources de contenu

Vous pouvez modifier ou supprimer toute source existante de contenu dynamique, c'est-à-dire toute source de contenu répertoriée dans le panneau Liaisons.

Modifier ou supprimer une source de contenu dans le panneau Liaisons ne modifie ni ne supprime aucune instance de ce contenu sur la page. Cela modifie ou supprime simplement cette source comme source possible de contenu pour la page.

Modifier une source de contenu dans le panneau Liaisons

Dans le panneau Liaisons (Fenêtre > Liaisons), double-cliquez sur le nom de la source de contenu que vous souhaitez modifier.
Procédez aux modifications dans la boîte de dialogue qui s’affiche.
Si le résultat vous convient, cliquez sur OK.

Supprimer une source de contenu du panneau Liaisons

Dans le panneau Liaisons (Fenêtre > Liaisons), sélectionnez la source de contenu dans la liste.
Cliquez sur le bouton Moins (-).

Copier un recordset d'une page vers une autre page

Vous pouvez copier un recordset d'une page vers une autre dans un emplacement défini.

Sélectionnez le recordset dans le panneau Liaisons ou dans le panneau Comportements de serveur.
Cliquez avec le bouton droit sur le recordset et sélectionnez Copier dans le menu contextuel.
Ouvrez la page dans laquelle coller le jeu d’enregistrements.
Cliquez avec le bouton droit sur le panneau Liaisons ou la barre d'outils Comportements de serveur, puis sélectionnez Coller dans le menu contextuel.