Nota:
la interfaz de usuario se ha simplificado en Dreamweaver CC y versiones posteriores. Como resultado, es posible que no encuentre algunas de las opciones que se describen en este artículo en Dreamweaver CC y versiones posteriores. Para obtener más información, consulte este artículo.
-
En el panel Vinculaciones, haga clic en el botón de signo más (+) y seleccione Juego de registros (consulta) en el menú emergente.
Aparecerá el cuadro de diálogo Juego de registros sencillo. Si está desarrollando un sitio ColdFusion, el cuadro de diálogo Juego de registros será ligeramente distinto. (Si aparece el cuadro de diálogo Juego de registros avanzado, haga clic en el botón Simple para cambiar al cuadro de diálogo Juego de registros simple).
-
En el cuadro Nombre, introduzca un nombre para el juego de registros.
Una práctica habitual consiste en añadir el prefijo rs a los nombres de juegos de registros para distinguirlos de otros nombres de objetos en el código, por ejemplo: rsPressReleases.
Los nombres de juegos de registros sólo admiten letras, números y el guión bajo (_). No puede incluir caracteres especiales ni espacios.
-
Para limitar aun más los registros devueltos desde la tabla, seleccione las opciones de la sección Filtro:
En el primer menú emergente, seleccione una columna de la tabla de la base de datos para compararla con un valor de prueba definido por usted.
En el segundo menú emergente, seleccione una expresión condicional para comparar el valor seleccionado en cada registro con el valor de prueba.
En el tercer menú emergente, seleccione Valor introducido.
En el cuadro de texto, introduzca el valor de prueba.
Si el valor especificado en un registro cumple la condición de filtro, el registro se incluirá en el juego de registros.
Define un juego de registros para documentos de tipo ColdFusion como una fuente de contenido dinámico sin necesidad de introducir manualmente el código de las declaraciones SQL.
-
En el cuadro Nombre, introduzca un nombre para el juego de registros.
Una práctica habitual consiste en añadir el prefijo rs a los nombres de juegos de registros para distinguirlos de otros nombres de objetos en el código. Por ejemplo: rsPressReleases
Los nombres de juegos de registros sólo admiten letras, números y el guión bajo (_). No puede incluir caracteres especiales ni espacios.
-
Si va a redefinir un juego de registros para un componente de ColdFusion (es decir, si un archivo CFC ya está abierto en Dreamweaver), seleccione una función CFC existente en el menú emergente, o bien haga clic en Nueva función para crear una nueva.
Nota:
El menú emergente Función sólo está disponible si el documento actual es un archivo CFC y si se tiene acceso a un equipo en el que se esté ejecutando ColdFusion MX 7 o una versión posterior.
-
En los cuadros Nombre de usuario y Contraseña, introduzca si es necesario el nombre de usuario y la contraseña para el servidor de aplicaciones ColdFusion.
El acceso a las fuentes de datos ColdFusion pueden requerir un nombre de usuario y una contraseña. Si no tiene el nombre de usuario y la contraseña para acceder a una fuente de datos en ColdFusion, póngase en contacto con el administrador de ColdFusion de su empresa.
-
Para limitar aun más los registros devueltos desde la tabla, seleccione las opciones de la sección Filtro:
En el primer menú emergente, seleccione una columna de la tabla de la base de datos para compararla con un valor de prueba definido por usted.
En el segundo menú emergente, seleccione una expresión condicional para comparar el valor seleccionado en cada registro con el valor de prueba.
En el tercer menú emergente, seleccione Valor introducido.
En el cuadro de texto, introduzca el valor de prueba.
Si el valor especificado en un registro cumple la condición de filtro, el registro se incluirá en el juego de registros.
-
Haga clic en Prueba para conectar con la base de datos y crear una instancia de la fuente de datos.
Aparecerá una tabla en la que se mostrarán los datos devueltos. Cada fila contiene un registro y cada columna representa un campo de dicho registro. Haga clic en Aceptar para cerrar el juego de registros de prueba.
Escriba sus propias declaraciones SQL utilizando el cuadro de diálogo Juego de registros avanzado o cree una declaración SQL empleando el árbol gráfico Elementos de base de datos.
-
En el panel Vinculaciones, haga clic en el botón de signo más (+) y seleccione Juego de registros (consulta) en el menú emergente.
Aparecerá el cuadro de diálogo avanzado Juego de registros. Si está desarrollando un sitio ColdFusion, el cuadro de diálogo Juego de registros será ligeramente distinto. (Si aparece la versión sencilla del cuadro de diálogo Juego de registros, cambie a la versión avanzada haciendo clic en el botón Avanzado).
-
Haga clic en el botón Prueba para ejecutar la consulta y comprobar que recupera la información deseada.
Si ha definido un filtro que utiliza parámetros introducidos por los usuarios, el botón Prueba mostrará el cuadro de diálogo Valor de prueba. Introduzca un valor en el cuadro Valor de prueba y haga clic en Aceptar. Si se crea una instancia del juego de registros, aparecerá una tabla mostrando los datos procedentes del juego de registros.
Defina un juego de registros como fuente de contenido dinámico escribiendo una declaración SQL personalizada o creando una declaración SQL mediante el árbol gráfico Elementos de base de datos.
-
Introduzca una declaración SQL en el área de texto SQL o utilice el árbol gráfico Elementos de base de datos, situado en la parte inferior del cuadro de diálogo, para crear una declaración SQL desde el juego de registros elegido.
Realice una de las siguientes operaciones para utilizar el árbol Elementos de base de datos con el fin de crear la declaración SQL:
Compruebe que el área de texto SQL está en blanco.
Amplíe las ramas del árbol hasta que encuentre el objeto de base de datos que necesita: por ejemplo, una columna de una tabla o un procedimiento almacenado en la base de datos.
Seleccione el objeto de base de datos y haga clic en uno de los botones situados a la derecha del árbol.
Por ejemplo, si selecciona una columna de la tabla, los botones disponibles serán SELECT, WHERE y ORDER BY. Haga clic en uno de los botones para añadir la cláusula asociada a la declaración SQL.
También puede utilizar una declaración SQL predefinida en un procedimiento almacenado seleccionando el procedimiento almacenado en el árbol Elementos de base de datos y haciendo clic en el botón Procedimiento. Dreamweaver llenará automáticamente las áreas SQL y Variable.
-
Si la declaración SQL contiene variables, defina sus valores en el área Variables haciendo clic en el botón de signo más (+) e introduciendo el nombre de la variable, el tipo (entero, texto, fecha o número de coma flotante), el valor predeterminado (el valor que toma la variable si no se devuelve ningún valor de tiempo de ejecución) y un valor de tiempo de ejecución.
Nota:
Al usar variables en una declaración SQL en PHP, Dreamweaver añade automáticamente un signo de dólar al comienzo del nombre de la variable, por lo que deberá omitir el signo de dólar (es decir, deberá introducir colname en lugar de $colname).
Si la declaración SQL contiene variables, compruebe que la columna Valor predeterminado del cuadro Variables contiene valores de prueba válidos.
El valor de tiempo de ejecución suele ser un URL o un parámetro de formulario introducido por un usuario en un campo de formulario HTML.
Parámetros de URL en la columna Valor de tiempo de ejecución:
-
Haga clic en Prueba para conectar con la base de datos y crear una instancia del juego de registros.
Si la declaración SQL contiene variables, compruebe que la columna Valor predeterminado del cuadro Variables contiene valores de prueba válidos antes de hacer clic en Prueba.
Si la operación se realiza correctamente, aparecerá una tabla con los datos del juego de registros. Cada fila contiene un registro y cada columna representa un campo de dicho registro. Haga clic en Aceptar para vaciar el juego de registros.
Utilice el cuadro de diálogo Juego de registros avanzado para escribir consultas SQL personalizadas o utilizar el árbol Elementos de base de datos para crear consultas SQL utilizando una interfaz de apuntar y señalar.
-
Una práctica habitual consiste en añadir el prefijo rs a los nombres de juegos de registros para distinguirlos de otros nombres de objetos en el código. Por ejemplo: rsPressReleases
Los nombres de juegos de registros sólo admiten letras, números y el guión bajo (_). No puede incluir caracteres especiales ni espacios.
Si va a redefinir un juego de registros para un componente de ColdFusion (es decir, si un archivo CFC ya está abierto en Dreamweaver), seleccione una función CFC existente en el menú emergente, o bien haga clic en Nueva función para crear una nueva.
Nota:
El menú emergente Función sólo está disponible si el documento actual es un archivo CFC y si se tiene acceso a un equipo en el que se esté ejecutando ColdFusion MX 7 o una versión posterior.
-
(Opcional) Realice una de las siguientes operaciones para utilizar el árbol Elementos de base de datos con el fin de crear la declaración SQL:
Compruebe que el área de texto SQL está en blanco.
Amplíe las ramas del árbol hasta que encuentre el objeto de base de datos que necesita: por ejemplo, una columna de una tabla.
Seleccione el objeto de base de datos y haga clic en uno de los botones situados a la derecha del árbol.
Por ejemplo, si selecciona una columna de una tabla, los botones disponibles serán Select, Where y Order By. Haga clic en uno de los botones para añadir la cláusula asociada a la declaración SQL.
Si la declaración SQL contiene parámetros, defina sus valores en el área Parámetros. Para ello, haga clic en el botón de signo más (+) e introduzca el nombre y el valor predeterminado del parámetro (el valor que toma el parámetro si no se devuelve ningún valor de tiempo de ejecución).
Si la declaración SQL contiene parámetros, compruebe que la columna Valor predeterminado del cuadro Parámetros contiene valores de prueba válidos.
Los Parámetros de página le permiten proporcionar los valores predeterminados para referencias de valor de tiempo de ejecución en el SQL que usted escribe. Por ejemplo, la siguiente declaración SQL selecciona un registro de empleado basándose en el valor del ID del empleado. Puede asignar un valor predeterminado a este parámetro, lo que le garantiza que siempre se devolverá un valor de tiempo de ejecución. En este ejemplo, FormFieldName hace referencia a un campo de formulario en el que el usuario introduce un ID de empleado:
SELECT * FROM Employees WHERE EmpID = + (Request.Form(#FormFieldName#))
-
Haga clic en Prueba para conectar con la base de datos y crear una instancia del juego de registros.
Si la declaración SQL contiene referencias de tiempo de ejecución, compruebe que la columna Valor predeterminado del campo Parámetros de página contiene valores de prueba válidos antes de hacer clic en Prueba.
Si la operación se realiza correctamente, aparecerá una tabla con los datos del juego de registros. Cada fila contiene un registro y cada columna representa un campo de dicho registro. Haga clic en Aceptar para vaciar el juego de registros.
Defina los parámetros en una declaración SQL; el valor predeterminado es el valor que debe usar el parámetro si no se devuelve ningún valor de tiempo de ejecución.
Defina los parámetros en una declaración SQL; el valor predeterminado es el valor que debe usar el parámetro si no se devuelve ningún valor de tiempo de ejecución.
En lugar de escribir manualmente las declaraciones SQL en el cuadro de texto SQL, puede utilizar la interfaz de apuntar y señalar de Elementos de base de datos para crear consultas SQL complejas. El árbol Elementos de base de datos permite seleccionar objetos de base de datos y vincularlos utilizando las cláusulas SQL SELECT, WHERE y ORDER BY. Después de crear una consulta SQL, puede definir las variables utilizando la sección Variables del cuadro de diálogo.
Los dos ejemplos siguientes describen dos declaraciones SQL y los pasos que debe seguir para crearlas en el árbol Elementos de base de datos del cuadro de diálogo avanzado Juego de registros.
Este ejemplo selecciona todo el contenido de la tabla Empleados. La declaración SQL que define la consulta aparece de este modo:
SELECT * FROM Employees
El ejemplo siguiente selecciona dos filas de la tabla Employees y selecciona el tipo de trabajo utilizando una variable que usted debe definir. A continuación, los resultados se ordenan por nombre de empleado.
SELECT emplNo, emplName FROM Employees WHERE emplJob = 'varJob' ORDER BY emplName
Los parámetros de URL almacenan la información recuperada que han introducido los usuarios. Antes de comenzar deberá transferir un parámetro de URL o formulario al servidor. Después de definir la variable de URL puede usar su valor en la página seleccionada actualmente.
Los parámetros de formulario almacenan información recuperada que se incluye en la petición HTTP de una página Web. Si crea un formulario que utiliza el método POST, los datos enviados por el formulario se transferirán al servidor. Antes de comenzar deberá transferir un parámetro de formulario al servidor. Después de definir el parámetro de formulario como una fuente de contenido, puede utilizar su valor en la página.
Puede utilizar variables de sesión para almacenar y mostrar información mantenida durante la visita (o sesión) de un usuario. El servidor crea un objeto de sesión diferente para cada usuario y lo mantiene durante un período de tiempo establecido o hasta que se pone fin al objeto explícitamente.
Antes de definir las variables de sesión de una página deberá crearlas en el código fuente. Después de crear una variable de sesión en el código fuente de la aplicación web, puede usar Dreamweaver para recuperar su valor y usarlo en una página web.
En ASP y ColdFusion, puede utilizar variables de aplicación para almacenar y mostrar información que se mantiene mientras dure la aplicación y que se conserva de un usuario a otro. Después de definir la variable de aplicación puede usar su valor en la página.
Nota:
No hay objetos de variable de aplicación en PHP.
Al definir un juego de registros para una página en el panel Vinculaciones, Dreamweaver introduce el nombre de la fuente de datos ColdFusion en la etiqueta. cfquery de la página. Le resultará práctico almacenar un nombre de fuente de datos en una variable y usar dicha variable en la etiqueta cfquery. Dreamweaver proporciona un método visual para especificar este tipo de variables en los juegos de registros.
Puede definir variables de servidor como fuentes de contenido dinámico para utilizarlas en una aplicación Web. Las variables de servidor varían según el tipo de documento e incluyen variables de formulario, variables de URL, variables de sesión y variables de aplicación.
Pueden acceder a la variable todos los clientes que acceden al servidor, además de las aplicaciones que se ejecutan en el servidor. Las variables se mantienen hasta que se detiene el servidor.
Variable |
Descripción |
|---|---|
Server.ColdFusion.ProductName |
Nombre del producto de ColdFusion. |
Server.ColdFusion.ProductVersion |
Número de versión de ColdFusion. |
Server.ColdFusion.ProductLevel |
Edición de ColdFusion (Enterprise, Professional). |
Server.ColdFusion.SerialNumber |
Número de serie de la versión instalada de ColdFusion. |
Server.OS.Name |
Nombre del sistema operativo que se ejecuta en el servidor (Windows XP, Windows 2000, Linux). |
Server.OS.AdditionalInformation |
Información adicional sobre el sistema operativo instalado (service packs, actualizaciones). |
Server.OS.Version |
Versión del sistema operativo instalado. |
Server.OS.BuildNumber |
Número de compilación del sistema operativo instalado. |
Las variables locales se crean con la etiqueta CFSET o CFPARAM en una página ColdFusion. La variable local definida aparecerá en el panel Vinculaciones.
Puede definir las siguientes variables de servidor ASP como fuentes de contenido dinámico: Request.Cookie, Request.QueryString, Request.Form, Request.ServerVariables, Request.ClientCertificates.
-
En el cuadro de diálogo Variable de petición, seleccione una de las siguientes colecciones de petición en el menú emergente Tipo:
Colección QueryString
Recupera información añadida al URL de la página que envía los datos, por ejemplo, cuando la página tiene un formulario HTML que usa el método GET. La cadena de consulta consta de uno o varios pares nombre-valor (por ejemplo, last=Smith, first=Winston) añadidos al URL con un signo de interrogación (?). Si la cadena de consulta incluye varios pares nombre-valor, éstos se combinarán mediante signos ampersand (&).
Colección Form
Recupera información de formulario incluida en el cuerpo de la petición HTTP por un formulario HTML usando el método POST.
Colección ServerVariables
Recupera los valores de variables de entorno predefinidas. La colección tiene una larga lista de variables, incluidas CONTENT_LENGTH (la longitud del contenido enviado en la petición HTTP, que puede utilizar para comprobar si el formulario está vacío) y HTTP_USER_AGENT (proporciona información sobre el navegador del usuario).
Por ejemplo, Request.ServerVariables("HTTP_USER_AGENT") contiene información sobre el navegador que envía la información, como Mozilla/4.07 [en] (WinNT; I), que define a un navegador Netscape Navigator 4.07.
Para obtener una lista completa de variables de entorno de servidor ASP, consulte la documentación en línea instalada con Microsoft Personal Web Server (PWS) o Internet Information Server (IIS).
-
Por ejemplo, si desea obtener acceso a la información de la variable Request.ServerVariables("HTTP_USER_AGENT"), introduzca el argumento HTTP_USER_AGENT. Si desea obtener acceso a la información de la variable Request.Form("lastname"), introduzca el argumento lastname.
La variable de petición aparecerá en el panel Vinculaciones.
Defina variables de servidor como fuente de contenido dinámico para páginas PHP. Las variables de servidor PHP aparecerán en el panel Vinculaciones.
Defina una variable de cliente ColdFusion como fuente de contenido dinámico para la página. Las variables de cliente ColdFusion que acaba de definir aparecerán en el panel Vinculaciones.
-
En el cuadro de diálogo Variable de cliente, introduzca el nombre de la variable y haga clic en Aceptar.
Por ejemplo, para obtener acceso a la información de la variable Client.LastVisit de ColdFusion, introduzca LastVisit.
Las variables de cliente son variables creadas en el código para asociar datos a un cliente específico. Las variables de cliente mantienen el estado de la aplicación mientras el usuario se desplaza de una página a otra de la aplicación, así como de una sesión a otra.
Las variables de cliente pueden estar definidas por el usuario o incorporadas. La tabla siguiente muestra las variables de cliente ColdFusion incorporadas:
Variable
Descripción
Client.CFID
Un ID incremental para cada cliente que se conecta al servidor.
Client.CFTOKEN
Un número generado al azar que se emplea para identificar a cada cliente específico.
Client.URLToken
Una combinación de CFID y CFTOKEN que se transfiere entre plantillas cuando no se utilizan cookies.
Client.LastVisit
Registra la marca de la última visita realizada por un cliente.
Client.HitCount
El número de peticiones de página vinculado a un solo cliente (obtenido mediante CFID y CFTOKEN).
Client.TimeCreated
Registra la marca cuando CFID y CFTOKEN se crearon por primera vez para un determinado cliente.
Las variables de cookie se crean en el código y la información de acceso contenida en las cookies se transfiere al servidor mediante un navegador. La variable de cookie definida aparecerá en el panel Vinculaciones.
-
Por ejemplo, si desea obtener acceso a la información de la variable CGI.HTTP_REFERER, introduzca HTTP_REFERER.
La tabla siguiente muestra las variables CGI ColdFusion más comunes que se crean en el servidor:
Variable
Descripción
SERVER_SOFTWARE
El nombre y la versión del software del servidor de información que responde a la petición (y que ejecuta la pasarela). Formato: nombre/versión.
SERVER_NAME
El nombre de host del servidor, el alias DNS o la dirección IP que aparece en los URL de autorreferencia.
GATEWAY_INTERFACE
La revisión de la especificación CGI que cumple este servidor. Formato: CGI/revisión.
SERVER_PROTOCOL
El nombre y la revisión del protocolo de información con el que llegó esta petición. Formato: protocolo/revisión.
SERVER_PORT
El número de puerto al que se envió la petición.
REQUEST_METHOD
El método con el que se realizó la petición. Para HTTP, el método es Get, Head, Post, etc.
PATH_INFO
La información adicional sobre ruta facilitada por el cliente. El acceso a los scripts puede realizarse a través de su ruta virtual, que va seguida de información adicional. La información adicional se envía como PATH_INFO.
PATH_TRANSLATED
El servidor proporciona una versión traducida de PATH_INFO, que toma la ruta y realiza la asignación virtual a física.
SCRIPT_NAME
Una ruta virtual al script que se está ejecutando. Se utiliza para los URL de autorreferencia.
QUERY_STRING
La información de consulta que sigue al signo de interrogación (?) en el URL que hacía referencia a este script.
REMOTE_HOST
El nombre del host que realiza la petición. Si el servidor no tiene esta información, define REMOTE_ADDR, pero no define REMOTE_HOST.
REMOTE_ADDR
La dirección IP del host remoto que realiza la petición.
AUTH_TYPE
Si el servidor admite la autenticación de usuario y el script está protegido, este es el método de autenticación específico del protocolo que se utiliza para validar al usuario.
REMOTE_USER AUTH_USER
Si el servidor admite autenticación de usuario y el script está protegido, este es el nombre de usuario con el que se han autenticado. (También disponible como AUTH_USER).
REMOTE_IDENT
Si el servidor HTTP admite identificación RFC 931, esta variable se define como el nombre de usuario remoto recuperado del servidor. Utilice esta variable sólo para conectar.
CONTENT_TYPE
Para consultas con información adjunta, como HTTP POST y PUT, este es el tipo de contenido de los datos.
CONTENT_LENGTH
La longitud del contenido facilitado por el cliente.
La tabla siguiente muestra las variables CGI más comunes que crea el navegador y que se transfieren al servidor:
Variable
Descripción
HTTP_REFERER
El documento al que se hace referencia. Es el documento que envió o se vinculó a datos de formulario.
HTTP_USER_AGENT
El navegador que utiliza actualmente el cliente para enviar la petición. Formato: software/versión biblioteca/versión.
HTTP_IF_MODIFIED_SINCE
La última vez que se modificó la página. Esta variable se envía a discreción del navegador, generalmente como respuesta al hecho de que el servidor haya enviado el encabezado HTTP LAST_MODIFIED. Puede emplearse para aprovechar la creación de caché de lado del navegador.
Puede crear un caché (o almacenar) fuentes de contenido dinámico en una Design Note. De este modo podrá trabajar en un sitio aunque no tenga acceso al servidor de bases de datos o aplicaciones que almacena las fuentes de contenido dinámico. La creación de la caché también puede acelerar el desarrollo al eliminar el acceso repetido a través de la red al servidor de bases de datos y aplicaciones.
Si realiza cambios en alguna de las fuentes de contenido, deberá actualizar la caché haciendo clic en el botón Actualizar (el icono de flecha circular) situado en la esquina superior derecha del panel Vinculaciones. (Amplíe el panel si no ve el botón).
Puede cambiar o eliminar cualquier fuente de contenido dinámico, es decir, cualquier fuente de contenido que figure en el panel Vinculaciones.
Al cambiar o borrar una fuente de contenido del panel Vinculaciones, no se cambia ni se borra ninguna instancia de ese contenido en la página. Tan sólo se cambia o se borra como posible fuente de contenido para la página.
Los términos de Creative Commons no cubren las publicaciones en Twitter™ y Facebook.