PDF (adobe.com)

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

    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

    #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

    #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 está definiendo 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.