Remarque :
L’interface utilisateur a été simplifiée sous Dreamweaver CC et versions ultérieures. Par conséquent, il se peut que vous ne trouviez pas certaines options décrites dans cet article sous Dreamweaver CC et versions ultérieures. Pour plus d’informations, consultez cet article.
-
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 simplifié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 avancée s’affiche, cliquez sur le bouton Simple pour ouvrir sa version simplifiée.)
-
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.
-
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.
-
Cliquez sur Tester 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 répertoriant les données renvoyées s’affiche. Chaque ligne contient un enregistrement et chaque colonne un champ de cet enregistrement.
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.
-
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’enregistrement pour un composant ColdFusion (par exemple, un fichier CFC actuellement ouvert sous Dreamweaver), sélectionnez une fonction existante CFC à partir du menu contextuel de la fonction, ou cliquer sur la touche Nouvelle fonction pour en créer une nouvelle.
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.
-
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é.
-
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.
-
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.
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.
-
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.)
-
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, puis 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.
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.
-
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, puis 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.
-
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 (celle que doit prendre la variable si aucune valeur d’exécution n’est renvoyée) et sa valeur d’exécution.
Remarque :
Lorsque vous employez des variables dans une instruction SQL dans PHP, Dreamweaver ajoute automatiquement un signe dollar au début du nom de la variable. N’en ajoutez pas un manuellement (tapez donc « nomcolonne » et pas « $nomcolonne »).
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 :
-
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.
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.
-
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’enregistrement pour un composant ColdFusion (par exemple, un fichier CFC actuellement ouvert sous Dreamweaver), sélectionnez une fonction existante CFC à partir du menu contextuel de la fonction, ou cliquer sur la touche Nouvelle fonction pour en créer une nouvelle.
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.
-
(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, puis 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#))
-
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.
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.
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.
Au lieu de saisir manuellement des instructions SQL dans la zone SQL, vous pouvez utiliser l’interface pointer-cliquer de l’arborescence Eléments de base de données pour créer des requêtes complexes SQL. L’arborescence Eléments de base de données permet de sélectionner des objets de base de données et de les lier au moyen des instructions SQL SELECT, WHERE et ORDER BY. Après avoir créé une requête SQL, vous pouvez définir des variables dans la section Variables de la boîte de dialogue.
Les deux exemples suivants présentent deux instructions SQL et décrivent les étapes de création de ces instructions à l’aide de l’arborescence Eléments de base de données de la boîte de dialogue Jeu d’enregistrements avancée.
Dans cet exemple, la requête sélectionne l’intégralité de la table Employees. L’instruction SQL définissant la requête se présente de la façon suivante :
SELECT * FROM Employees
Dans l’exemple suivant, la requête sélectionne deux lignes de la table Employees, puis sélectionne le type de tâche (job) à 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
Les paramètres d’URL permettent de stocker les informations saisies par les utilisateurs. Avant de commencer, vérifiez que vous avez transmis un paramètre de formulaire ou d’URL au serveur. Après avoir défini la variable d’URL, vous pouvez utiliser sa valeur dans la page sélectionnée.
Les paramètres de formulaire permettent de stocker les informations récupérées dans la requête HTTP d’une page web. Si vous créez un formulaire utilisant la méthode POST, les données envoyées par le formulaire sont transmises au serveur. Avant de commencer, vérifiez que vous avez transmis un paramètre de formulaire au serveur. Après avoir défini le paramètre de formulaire comme source de contenu, vous pouvez l’utiliser dans une page.
Les variables de session permettent de mémoriser et d’afficher des informations conservées pendant toute la durée de la visite de l’utilisateur (ou session). Le serveur crée un objet de session différent pour chaque utilisateur et le conserve pendant une période définie ou jusqu’à ce qu’il soit explicitement clos.
Avant de définir des variables de session pour une page, vous devez les créer dans le code source. Vous pouvez utiliser Dreamweaver pour récupérer sa valeur et l’utiliser dans une page web après avoir créé une variable de session dans le code source de l’application Web.
Dans ASP et ColdFusion, les variables d’application permettent de mémoriser et d’afficher des informations conservées pendant toute la durée d’utilisation de l’application, quel que soit l’utilisateur. Après avoir défini une variable d’application, vous pouvez utiliser sa valeur dans une page.
Remarque :
Il n’existe pas d’objets de variable d’application dans PHP.
Lorsque vous définissez un jeu d’enregistrements pour une page dans le panneau Liaisons, Dreamweaver entre le nom de la source de données ColdFusion dans la balise de page cfquery. Pour plus de flexibilité, vous pouvez stocker un nom de source de données dans une variable et utiliser cette dernière dans la balise cfquery. Dreamweaver permet de définir visuellement une variable de ce type dans vos jeux d’enregistrements.
-
Dreamweaver n’initialise pas la variable pour vous. De cette façon, vous pourrez le faire vous-même à votre convenance. Vous pouvez initialiser la variable dans le code de la page (avant la balise cfquery), dans un fichier inclus ou encore dans un autre fichier, comme variable d’application ou de session.
Vous définissez des variables de serveur comme sources de contenu dynamique pouvant être utilisées dans une application Web. Les variables de serveur varient d’un type de document à l’autre et comprennent notamment les variables de formulaire, les variables d’URL, les variables de session et les variables d’application.
Les variables de serveur sont accessibles à tous les clients qui accèdent au serveur et à toutes les applications exécutées sur le serveur. Les variables de serveur sont conservées jusqu’à l’arrêt du serveur.
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 de ColdFusion installée. |
Server.OS.Name |
Nom du système d’exploitation exécuté 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é. |
Les variables locales sont créées au moyen de la balise CFSET ou CFPARAM dans une page ColdFusion. La variable locale définie s’affiche dans le panneau Liaisons.
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.
-
Dans la boîte de dialogue Variable de demande, sélectionnez l’un des ensembles de demandes dans le menu déroulant Type.
L’ensemble QueryString
Récupère des informations annexées à l’URL de la page émettrice, par exemple lorsque la page comprend un formulaire HTML utilisant la méthode GET. La chaîne de requête est composée d’une ou de plusieurs paires nom/valeur (par exemple, last=Smith, first=Winston) annexées à l’URL avec un point d’interrogation (?). Si la chaîne de requête compte 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 demande 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. Cet ensemble contient une longue liste de variables, notamment CONTENT_LENGTH (longueur du contenu envoyé dans la demande HTTP, qui permet de savoir si un formulaire est vierge) et HTTP_USER_AGENT (fournit des informations sur le navigateur de l’utilisateur).
Par exemple, Request.ServerVariables("HTTP_USER_AGENT") contient des informations sur le navigateur expéditeur, comme Mozilla/4.07 [en] (WinNT; I), qui indique un navigateur Netscape Navigator 4.07.
La liste complète des variables d’environnement de serveur ASP figure dans la documentation en ligne fournie avec Microsoft Personal Web Server (PWS) ou Internet Information Server (IIS).
-
Par exemple, si vous souhaitez accéder aux informations de la variable Request.ServerVariables("HTTP_USER_AGENT"), tapez l’argument HTTP_USER_AGENT. Si vous souhaitez accéder aux informations de la variable Request.Form("lastname"), tapez l’argument lastname.
La variable de demande s’affiche dans le panneau Liaisons.
Définissez des variables de serveur comme source de contenu dynamique pour les types de document PHP. Les variables de serveur PHP s’affichent dans le panneau Liaisons.
Définissez une variable client ColdFusion comme source de contenu dynamique pour une page. Les variables de client ColdFusion que vous venez de définir s’affichent dans le panneau Liaisons.
-
Par exemple, pour accéder aux données contenues dans la Client.LastVisit, tapez LastVisit.
Les variables client sont des variables ajoutées au code pour associer des données à un client spécifique. Elles conservent l’état de l’application pendant que l’utilisateur passe d’une page à l’autre et d’une session à l’autre dans l’application.
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
Identifiant incrémentiel attribué à chacun des clients se connectant au serveur.
Client.CFTOKEN
Numéro généré aléatoirement et permettant d’identifier un client spécifique de façon univoque.
Client.URLToken
Combinaison de CFID et CFTOKEN devant être transmise de modèle en modèle lorsque les cookies ne sont pas utilisés.
Client.LastVisit
Enregistre la date de la dernière visite effectuée par un client.
Client.HitCount
Nombre de demandes de pages liées à un même client (obtenu à l’aide de CFID et CFTOKEN).
Client.TimeCreated
Enregistre l’heure de la première création de CFID et CFTOKEN pour un client spécifique.
Les variables cookie sont créées au niveau du code et permettent d’accéder aux informations contenues dans les cookies transmis au serveur par un navigateur. La variable cookie définie s’affiche dans le panneau Liaisons.
-
Par exemple, si vous souhaitez accéder aux données contenues dans la variable CGI.HTTP_REFERER , saisissez HTTP_REFERER.
Le tableau ci-dessous répertorie les variables CGI de ColdFusion les plus fréquemment créées sur le serveur :
Variable
Description
SERVER_SOFTWARE
Nom et version du logiciel du serveur d’informations répondant à la demande (et exécutant la passerelle). Format : nom/version.
SERVER_NAME
Nom d’hôte, alias DNS ou adresse IP du serveur tel qu’il/elle se présente dans les URL d’appel.
GATEWAY_INTERFACE
Révision de la spécification CGI appliquée par le serveur. Format : CGI/révision.
SERVER_PROTOCOL
Nom et révision du protocole d’informations par lequel la demande a été transmise. Format : protocole/révision.
SERVER_PORT
Numéro du port auquel la demande 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
Informations de chemin complémentaires, telles qu’elles sont fournies par le client. On accède aux scripts en utilisant leur nom de chemin virtuel suivi des informations complémentaires. Celles-ci sont envoyées en tant que PATH_INFO.
PATH_TRANSLATED
Le serveur fournit une version traduite de PATH_INFO, résultat de la conversion du chemin virtuel en chemin physique.
SCRIPT_NAME
Chemin virtuel vers le script en cours d’exécution. Variable utilisée pour les URL d’appel.
QUERY_STRING
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 cette information, il définit REMOTE_ADDR mais pas REMOTE_HOST.
REMOTE_ADDR
Adresse IP de l’hôte distant à l’origine de la demande.
AUTH_TYPE
Si le serveur prend en charge l’authentification de l’utilisateur et que le script est protégé, cette variable correspond à la méthode d’authentification spécifique au protocole utilisée pour vérifier l’identité de l’utilisateur.
REMOTE_USER AUTH_USER
Si le serveur prend en charge l’authentification de l’utilisateur et que le script est protégé, cette variable correspond au nom saisi par l’utilisateur lors de l’authentification (disponible également sous la forme AUTH_USER).
REMOTE_IDENT
Si le serveur HTTP prend en charge l’identification RFC 931, cette variable reçoit comme valeur le nom de l’utilisateur distant récupéré du serveur. Utilisez cette variable uniquement pour la connexion.
CONTENT_TYPE
Dans le cas de requêtes assorties d’informations, telles que HTTP POST et PUT, cette variable correspond au type de contenu des données.
CONTENT_LENGTH
Longueur du contenu, tel qu’il a été fourni par le client.
Le tableau ci-dessous répertorie les variables CGI les plus fréquemment créées par le navigateur et transmises au serveur :
Variable
Description
HTTP_REFERER
Document de référence. Il s’agit du document associé aux données de formulaire ou qui les envoie.
HTTP_USER_AGENT
Navigateur utilisé par le client pour envoyer la demande. Format : logiciel/version bibliothèque/version.
HTTP_IF_MODIFIED_SINCE
Date de la dernière modification de la page. Cette variable est envoyée suivant la configuration du navigateur, généralement en réponse au serveur ayant envoyé l’en-tête LAST_MODIFIED HTTP. Peut être utilisée pour tirer parti des possibilités de mise en mémoire cache au niveau du navigateur.
Vous pouvez stocker des sources de contenu dynamique dans une Design Note. Cette opération vous permet de travailler sur un site même lorsque vous n’avez pas accès à la base de données ou au serveur d’application contenant les sources de contenu dynamique. La mise en mémoire cache permet également d’accélérer le processus de développement puisqu’elle évite de se connecter en continu à la base de données et au serveur d’application via le réseau.
Si vous modifiez l’une de vos sources de contenu, vous pouvez actualiser le cache en cliquant sur le bouton Actualiser (icône en forme de flèche en forme de cercle), dans le coin supérieur droit du panneau Liaisons. Agrandissez l’affichage si ce bouton n’apparaît pas.
Vous pouvez modifier ou supprimer n’importe quelle source de contenu dynamique, autrement dit n’importe quelle source de contenu figurant dans le panneau Liaisons.
La modification ou la suppression d’une source de contenu dans le panneau Liaisons ne change ni ne supprime les instances de cette source sur la page. Cela affecte uniquement son rôle de source de contenu pour la page.
Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.