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.

Definición de un juego de registros sin escribir SQL

Puede crear un juego de registros sin introducir manualmente declaraciones SQL.

  1. En la ventana de documento, abra la página que utilizará el juego de registros.
  2. Seleccione Ventana > Vinculaciones para mostrar el panel Vinculaciones.
  3. 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).

  4. Seleccione las opciones del cuadro de diálogo Juego de registros para el tipo de documento.

    Para instrucciones, véanse las siguientes secciones.

  5. 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, introduzca un valor en el cuadro Valor de prueba y haga clic en Aceptar. Si se crea correctamente una instancia del juego de registros, aparecerá una tabla mostrando los datos extraídos del juego de registros.

  6. Haga clic en Aceptar para añadir el juego de registros a la lista de fuentes de contenido disponibles en el panel Vinculaciones.

Opciones del cuadro de diálogo Juego de registros sencillo (PHP, ASP)

  1. 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.

  2. Seleccione una conexión en el menú emergente Conexión.

    Si no aparece ninguna conexión en la lista, haga clic en Definir para crear una.

  3. En el menú emergente Tabla, seleccione la tabla de la base de datos que proporcionará los datos al juego de registros.

    El menú emergente muestra todas las tablas de la base de datos especificada.

  4. Para incluir un subconjunto de las columnas de la tabla en el juego de registros, haga clic en Seleccionado y elija las columnas deseadas presionando Control (Windows) o Comando (Macintosh) mientras hace clic en ellas en la lista.

  5. 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.

  6. (Opcional) Para ordenar los registros, seleccione la columna por la que desea ordenar y luego especifique si los registros deben clasificarse en orden ascendente (1, 2, 3... o A, B, C...) o descendente.

  7. Haga clic en Prueba para conectar con la base de datos y crear una instancia de la fuente de datos y haga clic en Aceptar para cerrar la fuente de datos.

    Aparecerá una tabla mostrando los datos devueltos. Cada fila contiene un registro y cada columna representa un campo de dicho registro.

  8. Haga clic en Aceptar. El juego de registros que acaba de definir aparecerá en el panel Vinculaciones.

Opciones del cuadro de diálogo Juego de registros sencillo (ColdFusion)

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.

  1. 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.

  2. 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.

    El juego de registros se definirá en la función.

  3. Seleccione una fuente de datos en el menú emergente Fuente de datos.

    Si no aparece ninguna fuente de datos en el menú emergente, deberá crear una fuente de datos ColdFusion.

  4. 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.

  5. En el menú emergente Tabla, seleccione la tabla de la base de datos que proporcionará los datos al juego de registros.

    El menú emergente Tabla muestra todas las tablas de la base de datos especificada.

  6. Para incluir un subconjunto de las columnas de la tabla en el juego de registros, haga clic en Seleccionado y elija las columnas deseadas presionando Control (Windows) o Comando (Macintosh) mientras hace clic en ellas en la lista.

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

  8. (Opcional) Para ordenar los registros, seleccione la columna por la que desea ordenar y luego especifique si los registros deben clasificarse en orden ascendente (1, 2, 3... o A, B, C...) o descendente.

  9. 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.

  10. Haga clic en Aceptar. El juego de registros ColdFusion que acaba de definir aparecerá en el panel Vinculaciones.

Definición de un juego de registros avanzado escribiendo SQL

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.

  1. En la ventana de documento, abra la página que utilizará el juego de registros.
  2. Seleccione Ventana > Vinculaciones para mostrar el panel Vinculaciones.
  3. 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).

  4. Complete el cuadro de diálogo Juego de registros avanzado.

    Para instrucciones, véanse las siguientes secciones.

  5. 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.

  6. Haga clic en Aceptar para añadir el juego de registros a la lista de fuentes de contenido disponibles en el panel Vinculaciones.

Opciones del cuadro de diálogo Juego de registros avanzado (PHP, ASP)

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.

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

    Los nombres de juegos de registros sólo admiten letras, números y el guión bajo (_). No puede incluir caracteres especiales ni espacios.

  2. Seleccione una conexión en el menú emergente Conexión.
  3. 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.

  4. 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:

    Modelo de servidor

    Expresión de valor de tiempo de ejecución para el parámetro de URL

    ASP

    Request.QueryString(“formFieldName”)

    PHP

    $_GET['formFieldName']

    Parámetros de formulario en la columna Valor de tiempo de ejecución:

    Modelo de servidor

    Expresión de valor de tiempo de ejecución para el parámetro de formulario

    ASP

    Request.Form(“formFieldName”)

    PHP

    $_POST['formFieldName']

  5. 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.

  6. Cuando esté satisfecho con los cambios realizados, haga clic en Aceptar.

Opciones del cuadro de diálogo Juego de registros avanzado (ColdFusion)

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.

  1. 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.

    El juego de registros se definirá en la función.

  2. Seleccione una fuente de datos en el menú emergente Fuente de datos.

    Si no aparece ninguna fuente de datos en la lista del menú emergente deberá crear una fuente de datos ColdFusion.

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

  4. 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.
  5. (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#))

    El cuadro de diálogo Añadir parámetros de página contendría un emparejamiento nombre-valor similar a éste:

    Nombre

    Valores predeterminados

    FormFieldName

    0001

    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.

  6. 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.

  7. Cuando esté satisfecho con los cambios realizados, haga clic en Aceptar.

Definición de parámetros en una declaración SQL (ColdFusion)

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.

  1. Seleccione un nombre de parámetro en el menú emergente Nombre.
  2. Introduzca un valor predeterminado para el parámetro en el cuadro de texto Parámetro predeterminado y haga clic en Aceptar.

Definición de parámetros en una declaración SQL (PHP)

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.

  1. Introduzca un nombre de parámetro en el cuadro Nombre.
  2. Introduzca un valor predeterminado para el parámetro en el cuadro Parámetro predeterminado.
  3. Introduzca un valor de tiempo de ejecución para un parámetro en el cuadro Valor de tiempo de ejecución y haga clic en Aceptar.

Creación de consultas SQL utilizando el árbol Elementos de base de datos

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.

Ejemplo: Selección de una tabla

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

Para crear esta consulta, siga estos pasos.

  1. Amplíe la rama Tablas para ver todas las tablas de la base de datos seleccionada.
  2. Seleccione la tabla Employees.
  3. Haga clic en el botón Seleccionar.
  4. Haga clic en Aceptar para añadir el juego de registros al panel Vinculaciones.

Ejemplo: Selección de filas específicas de una tabla y ordenación de los resultados

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
  1. Amplíe la rama Tablas para ver todas las tablas de la base de datos seleccionada y, a continuación, amplíe la tabla Employees para ver las filas de la tabla por separado.
  2. Cree la declaración SQL de la siguiente forma:
    • Seleccione emplNo y haga clic en el botón Seleccionar.

    • Seleccione emplName y haga clic en el botón Seleccionar.

    • Seleccione emplJob y haga clic en el botón Dónde.

    • Seleccione emplName y haga clic en el botón Ordenar por.

  3. Sitúe el punto de inserción después de WHERE emplJob en el área de texto SQL y escriba ='varJob' (incluido el signo igual).
  4. Haga clic en el botón de signo más (+) en el área Variables e introduzca los siguientes valores en las columnas Nombre, Valor predeterminado y Valor de tiempo de ejecución para definir la variable 'varJob'. varJob, CLERK, Request("job").
  5. Haga clic en Aceptar para añadir el juego de registros al panel Vinculaciones.

Definición de parámetros de URL

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.

  1. En la ventana de documento, abra la página que utilizará la variable.
  2. Seleccione Ventana > Vinculaciones para mostrar el panel Vinculaciones.
  3. En el panel Vinculaciones, haga clic en el botón de signo más (+) y seleccione una de las siguientes opciones en el menú emergente.

    Tipos de documento

    Elemento del menú en el panel Vinculaciones para variable de URL

    ASP

    Variable de petición > Request.QueryString

    ColdFusion

    Variable de URL

    PHP

    Variable de URL

  4. En el cuadro de diálogo Variable de URL, introduzca el nombre de la variable de URL en el cuadro y haga clic en Aceptar.

    El nombre de la variable de URL suele ser el nombre del campo de formulario HTML o del objeto empleado para obtener su valor.

  5. La variable de URL aparecerá en el panel Vinculaciones.

Definición de parámetros de formulario

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.

  1. En la ventana de documento, abra la página que utilizará la variable.
  2. Seleccione Ventana > Vinculaciones para mostrar el panel Vinculaciones.
  3. En el panel Vinculaciones, haga clic en el botón de signo más (+) y seleccione una de las siguientes opciones en el menú emergente.

    Tipos de documento

    Elemento del menú en el panel Vinculaciones para variable de formulario

    ASP

    Variable de petición > Request.Form

    ColdFusion

    Variable de formulario

    PHP

    Variable de formulario

  4. En el cuadro de diálogo Variable de formulario, introduzca el nombre de la variable de formulario y haga clic en Aceptar. El nombre de la variable de formulario suele ser el nombre del campo de formulario HTML o del objeto empleado para obtener su valor.

    El parámetro de formulario aparecerá en el panel Vinculaciones.

    Panel Vinculaciones con la sección Formulario expandida
    Panel Vinculaciones con formulario expandido

Definición de variables de sesión

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.

  1. Cree una variable de sesión en el código fuente y asígnele un valor.

    Este ejemplo ColdFusion crea una instancia de una sesión llamada username y le asigna el valor Cornelius:

    <CFSET session.username = Cornelius>
  2. Elija Ventana > Vinculaciones para mostrar el panel Vinculaciones.
  3. Haga clic en el botón de signo más (+) y seleccione Variable de aplicación en el menú emergente.
  4. Introduzca el nombre de la variable definida en el código fuente de la aplicación y haga clic en Aceptar.

Definición de variables de aplicación para ASP y ColdFusion

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.

  1. Abra un documento de tipo dinámico en la ventana de documento.
  2. Elija Ventana > Vinculaciones para mostrar el panel Vinculaciones.
  3. Haga clic en el botón de signo más (+) y seleccione Variable de aplicación en el menú emergente.
  4. Introduzca el nombre de la variable definida en el código fuente de la aplicación y haga clic en Aceptar.

    La variable de aplicación aparece en el panel Vinculaciones bajo el icono Application.

    Panel Vinculaciones con la sección Aplicación expandida
    Panel Vinculaciones con la sección Aplicación expandida

Use una variable como fuente de datos para un juego de registros ColdFusion

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.

  1. Compruebe que hay una página ColdFusion activa en la ventana de documento.
  2. En el panel Vinculaciones, haga clic en el botón de signo más (+) y seleccione Variable de nombre de fuente de datos en el menú emergente.

    Aparecerá el cuadro de diálogo Variable de nombre de fuente de datos.

  3. Defina una variable y haga clic en Aceptar.
  4. Al definir un juego de registros, seleccione la variable como Fuente de datos para el juego de registros.

    En el cuadro de diálogo Juego de registros, la variable aparece en el menú emergente Fuente de datos junto con las fuentes de datos ColdFusion del servidor.

  5. Seleccione las opciones del cuadro de diálogo Juego de registros y haga clic en Aceptar.
  6. Inicialice la variable.

    Dreamweaver no inicializa la variable para que usted pueda inicializarla como y donde desee. Puede inicializar la variable en el código de la página (antes de la etiqueta cfquery), en un archivo de inclusión (include) o en otro archivo como variable de sesión o de aplicación.

Definición de variables de servidor

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.

Definición de variables de servidor ColdFusion

  1. Abra el panel Vinculaciones (Ventana > Vinculaciones). En el cuadro de diálogo Variable de servidor, introduzca el nombre de la variable de servidor y haga clic en Aceptar.
  2. Haga clic en el botón de signo más (+) y seleccione la variable de servidor en el menú emergente.
  3. Escriba el nombre de la variable y haga clic en Aceptar (Windows) o en OK (Mac OS). La variable de servidor ColdFusion aparecerá en el panel Vinculaciones.

La tabla siguiente muestra las variables de servidor ColdFusion incorporadas:

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.

Definición de una variable local ColdFusion

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.

  1. En el cuadro de diálogo Variable local, introduzca el nombre de la variable local y haga clic en Aceptar.

Definición de variables de servidor ASP

Puede definir las siguientes variables de servidor ASP como fuentes de contenido dinámico: Request.Cookie, Request.QueryString, Request.Form, Request.ServerVariables, Request.ClientCertificates.

  1. Abra el panel Vinculaciones (Ventana > Vinculaciones).
  2. Haga clic en el botón de signo más (+) y seleccione Variable de petición en el menú emergente.
  3. 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).

    Colección Cookies

    Recupera los valores de las cookies enviadas en una petición HTTP. Por ejemplo, supongamos que la página lee una cookie denominada “readMe” en el sistema del usuario. En el servidor, los valores de la cookie se almacenan en la variable Request.Cookies("readMe").

    Colección ClientCertificate

    Recupera los campos de certificado de la petición HTTP enviada por el navegador. Los campos de certificado se especifican en la norma X.509.

  4. Especifique la variable de la colección a la que desea obtener acceso y haga clic en Aceptar.

    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.

Definición de variables de servidor PHP

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.

  1. Abra el panel Vinculaciones (Ventana > Vinculaciones).
  2. Haga clic en el botón de signo más (+) y seleccione la variable en el menú emergente.
  3. En el cuadro de diálogo Variable de petición, introduzca el nombre de la variable (por ejemplo, REQUEST_METHOD) y haga clic en Aceptar.

    Para más información, busque la palabra clave $_SERVER en la documentación de PHP.

Definición de una variable de cliente ColdFusion

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.

  1. 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.

  1. En el cuadro de diálogo Variable de cookie, introduzca el nombre de la variable de cookie y haga clic en Aceptar.

Definición de una variable CGI ColdFusion

La variable CGI definida aparecerá en el panel Vinculaciones.

  1. En el cuadro de diálogo Variable CGI, introduzca el nombre de la variable y haga clic en Aceptar.

    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.

Creación de un caché de las fuentes de contenido

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.

  1. Haga clic en el botón de flecha situado en la esquina superior derecha del panel Vinculaciones y seleccione la opción Caché en el menú emergente.

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).

Cambio o eliminación de fuentes de contenido

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.

Cambio de una fuente de contenido en el panel Vinculaciones

  1. En el panel Vinculaciones (Ventana > Vinculaciones), haga doble clic en el nombre de la fuente de contenido que desea editar.
  2. Realice los cambios en el cuadro de diálogo que aparece.
  3. Cuando esté satisfecho con los cambios realizados, haga clic en Aceptar.

Eliminación de una fuente de contenido en el panel Vinculaciones

  1. En el panel Vinculaciones (Ventana > Vinculaciones), seleccione la fuente de contenido de la lista.
  2. Haga clic en el botón de signo menos (-).

Copia de un juego de registros de una página a otra

Puede copiar un juego de registros de una página a otra dentro de un sitio definido.

  1. Seleccione el juego de registros en el panel Vinculaciones o el panel Comportamientos del servidor.
  2. Haga clic con el botón derecho en el juego de registros y seleccione Copiar en el menú emergente.
  3. Abra la página en la que desea copiar el juego de registros.
  4. Haga clic con el botón derecho en el panel Vinculaciones o la barra de herramientas Comportamientos del servidor y seleccione Pegar en el menú emergente.

Esta obra está autorizada con arreglo a la licencia de Reconocimiento-NoComercial-CompartirIgual 3.0 Unported de Creative Commons.  Los términos de Creative Commons no cubren las publicaciones en Twitter™ y Facebook.

Avisos legales   |   Política de privacidad en línea