Usar comandos ASP para modificar una base de datos en Dreamweaver

Última actualización el 25-04-2024

Aprenda a usar comandos ASP en Dreamweaver para modificar una base de datos y añadir y ejecutar un procedimiento almacenado.

Nota

La interfaz de usuario se ha simplificado en Dreamweaver y versiones posteriores. Como resultado, es posible que no encuentre algunas de las opciones que se describen en este artículo en Dreamweaver y versiones posteriores. Para obtener más información, consulte este artículo.

Objetos de los comandos ASP

Un objeto de comando ASP es un objeto de servidor que realiza alguna operación en una base de datos. El objeto puede contener cualquier instrucción SQL válida, incluida una que devuelva un conjunto de registros, o una que inserte, actualice o elimine registros en una base de datos. Un objeto de comando puede alterar la estructura de una base de datos si la instrucción SQL agrega o elimina una columna en una tabla. También puedes usar un objeto de comando para ejecutar un procedimiento almacenado en una base de datos.

Un objeto de comando puede ser reutilizable, en el sentido de que el servidor de aplicaciones puede reutilizar una sola versión compilada del objeto para ejecutar el comando varias veces. Haces que un comando sea reutilizable estableciendo la propiedad Prepared del objeto Command en verdadero, como en la siguiente instrucción VBScript:

mycommand.Prepared = true

Si sabes que el comando se ejecutará más de unas pocas veces, tener una sola versión compilada del objeto puede hacer que las operaciones de base de datos sean más eficientes.

Nota

No todos los proveedores de base de datos admiten comandos preparados. Si tu base de datos no lo admite, podría devolver un error cuando estableces esta propiedad en verdadero. Incluso podría ignorar la solicitud de preparar el comando y establecer la propiedad Prepared en false.

Un objeto de comando se crea mediante scripts en una página ASP, pero Dreamweaver te permite crear objetos de comando sin escribir una línea de código ASP.

Utilización de comandos ASP para modificar una base de datos

Puedes usar Dreamweaver para crear objetos de comando ASP que inserten, actualicen o eliminen registros en una base de datos. Proporcionas al objeto de comando la instrucción SQL o el procedimiento almacenado que realiza la operación en la base de datos.

En Dreamweaver, abrir la página ASP que ejecutará el comando.
Abrir el panel Comportamientos del Servidor (Ventana > Comportamientos del Servidor), hacer clic en el botón Más (+) y seleccionar Comando.
Introducir un nombre para el comando, seleccionar una conexión a la base de datos que contiene los registros que quieres editar y seleccionar la operación de edición que quieres que realice el comando: Insertar, Actualizar o Eliminar.

Dreamweaver inicia la instrucción SQL, basándose en el tipo de operación que selecciones. Por ejemplo, si seleccionas Insertar, el cuadro de diálogo se ve como el siguiente ejemplo:

Introducción del comando ASP
Introducción del comando ASP

Realice la declaración SQL.

Para obtener información sobre cómo escribir instrucciones SQL que modifiquen bases de datos, consulta un manual de Transact‑SQL.

Utilice el área Variables para definir variables SQL. Proporcionar el nombre y el valor en tiempo de ejecución.Especificar el tipo y el tamaño de cada variable previene ataques de inyección.

El siguiente ejemplo muestra una instrucción Insertar que contiene tres variables SQL. Los valores de estas variables se proporcionan mediante parámetros de URL que se pasan a la página, según se define en la columna Valor en Tiempo de Ejecución del área Variables.

Declaración Insertar que contiene tres variables SQL
Declaración Insertar que contiene tres variables SQL

Para obtener el valor de tamaño, utilice el panel Bases de datos de Dreamweaver.Busca tu base de datos en el panel Bases de datos y expándela. A continuación, busca la tabla con la que trabajas y expándela. La tabla enumera los tamaños de los campos. Por ejemplo, podría decir ADDRESS (WChar 50). En este ejemplo, 50 es el tamaño. También puedes encontrar el tamaño en tu aplicación de base de datos.

Nota

Los tipos de datos numéricos, booleanos y de fecha/hora siempre usan -1 como tamaño.

Para determinar el valor Tipo, consulta la siguiente tabla:

Tipo en la base de datos

Tipo en Dreamweaver

Tamaño

Numérico (MS Access, MS SQL Server, MySQL)

Doble

-1

Booleano, Sí/No (MS Access, MS SQL Server, MySQL)

Doble

-1

Fecha/Hora (MS Access, MS SQL Server, MySQL)

DBTimeStamp

-1

Todos los demás tipos de campos de texto, incluidos los tipos de datos de texto MySQL char, varchar y longtext

LongVarChar

compruebe la tabla de la base de datos

Texto (MS Access) o nvarchar, nchar (MS SQL Server)

VarWChar

compruebe la tabla de la base de datos

Memo (MS Access), ntext (MS SQL Server), o campos que admiten grandes cantidades de texto

LongVarWChar

1073741823

Para obtener más información sobre el tipo y el tamaño de las variables SQL, consulta www.adobe.com/go/4e6b330a.

Cierre el cuadro de diálogo.

Dreamweaver inserta código ASP en tu página que, cuando se ejecuta en el servidor, crea un comando que inserta, actualiza o elimina registros en la base de datos.

De forma predeterminada, el código establece la propiedad Prepared del objeto Command en true, lo que hace que el servidor de aplicaciones reutilice una sola versión compilada del objeto cada vez que se ejecuta el comando.Para cambiar esta configuración, cambie a la vista Código y cambie la propiedad Prepared a false.

Crear una página con un formulario HTML para que los usuarios puedan introducir datos de registro.En el formulario HTML, incluye tres campos de texto (txtCity, txtAddress, y txtPhone) y un botón de envío. El formulario usa el método GET y envía los valores del campo de texto a la página que contiene tu comando.

Procedimientos almacenados

Aunque puedes usar comportamientos del servidor para generar páginas que modifiquen bases de datos, también puedes usar objetos de manipulación de base de datos como procedimientos almacenados o objetos de comando ASP para generar las páginas.

Un procedimiento almacenado es un elemento de base de datos reutilizable que realiza alguna operación en la base de datos. Un procedimiento almacenado contiene código SQL que puede, entre otras cosas, insertar, actualizar o eliminar registros. Los procedimientos almacenados también pueden alterar la estructura de la base de datos en sí. Por ejemplo, puedes usar un procedimiento almacenado para añadir una columna de tabla o incluso eliminar una tabla.

Un procedimiento almacenado también puede llamar a otro procedimiento almacenado, así como aceptar parámetros de entrada y devolver múltiples valores al procedimiento que lo llama en forma de parámetros de salida.

Un procedimiento almacenado es reutilizable en el sentido de que puedes reutilizar una sola versión compilada del procedimiento para ejecutar una operación de base de datos varias veces. Si sabes que una tarea de base de datos se ejecutará más de unas pocas veces, o la misma tarea será ejecutada por diferentes aplicaciones, usar un procedimiento almacenado para ejecutar esa tarea puede hacer que las operaciones de base de datos sean más eficientes.

Nota

Las bases de datos MySQL y Microsoft Access no son compatibles con procedimientos almacenados.

Añadir un procedimiento almacenado (ColdFusion) (CS6)

Puedes usar un procedimiento almacenado para modificar una base de datos.Un procedimiento almacenado es un elemento de base de datos reutilizable que realiza alguna operación en la base de datos.

Antes de usar un procedimiento almacenado para modificar una base de datos, asegúrate de que el procedimiento almacenado contenga SQL que modifique la base de datos de alguna manera.Para crear y almacenar uno en tu base de datos, consulta la documentación de tu base de datos y un buen manual de Transact-SQL.

En Dreamweaver, abre la página que ejecutará el procedimiento almacenado.
En el panel Vínculos (Ventana > Vínculos), haz clic en el botón Más (+) y luego selecciona Procedimiento almacenado.
En el menú emergente Fuente de datos, selecciona una conexión a la base de datos que contiene el procedimiento almacenado.
Introduzca el nombre de usuario y la contraseña de Fuente de datos de ColdFusion.
Seleccionar un procedimiento almacenado del menú emergente Procedimientos.

Dreamweaver completa automáticamente cualquier parámetro.

Selecciona un parámetro y haz clic en Editar si tienes que hacer cambios.

Aparecerá el cuadro de diálogo Editar variable de procedimiento almacenado. El nombre de la variable que está editando aparece en el cuadro Nombre.

Nota

Debes introducir valores de prueba para cualquier parámetro de entrada del procedimiento almacenado.

Realice los cambios necesarios:
  • Seleccione una dirección en el menú emergente. Un procedimiento almacenado puede tener valores de entrada, valores de salida, o tanto valores de entrada como de salida.

  • Seleccione un tipo SQL en el menú emergente. Introduce una variable de retorno, un valor de tiempo de ejecución y un valor de prueba.

Si el procedimiento almacenado toma un parámetro, haga clic en el botón Más (+) para agregar un parámetro de página.
Nota

Debe introducir parámetros de página correspondientes para cada valor de retorno del parámetro del procedimiento almacenado.No agregues parámetros de página a menos que haya un valor de retorno correspondiente.

Haz clic en el botón Más (+) otra vez para agregar otro parámetro de página, si es necesario.

Selecciona un parámetro de página y haz clic en el botón Menos (-) para eliminar el parámetro si es necesario o haz clic en Editar para hacer cambios al parámetro.
Selecciona la opción Devuelve conjunto de registros con nombre y luego introduce un nombre para el conjunto de registros; si el procedimiento almacenado devuelve un conjunto de registros, haz clic en el botón Prueba para ver el conjunto de registros que devuelve el procedimiento almacenado.

Dreamweaver ejecuta el procedimiento almacenado y muestra el conjunto de registros, si lo hay.

Nota

Si el procedimiento almacenado devuelve un conjunto de registros y toma parámetros, debes introducir un valor en la columna Valor predeterminado en el cuadro Variables para probar el procedimiento almacenado.

Nota

Puedes usar diferentes valores de prueba para generar diferentes conjuntos de registros.Para cambiar los valores de prueba, haz clic en el botón Editar para Parámetro y cambia el valor de prueba, o haz clic en el botón Editar para Parámetro de página y cambia el valor predeterminado.

Selecciona la opción Returns Status Code Named, introduce un nombre para el código de estado, si el procedimiento almacenado devuelve un valor de retorno de código de estado. Haga clic en OK.

Después de cerrar el cuadro, Dreamweaver inserta código ColdFusion en tu página que llama a un procedimiento almacenado en la base de datos, cuando el código se ejecuta en el servidor. El procedimiento almacenado a su vez realiza una operación de base de datos, como insertar un registro.

Si el procedimiento almacenado toma parámetros, puedes crear una página que recopile los valores de los parámetros y los envíe a la página con el procedimiento almacenado. Por ejemplo, puedes crear una página que use parámetros de URL o un formulario HTML para recopilar valores de parámetros de usuarios.

Ejecutar un procedimiento almacenado (ASP) (CS6)

Con páginas ASP, debes añadir un objeto de comando a una página para ejecutar un procedimiento almacenado. Para obtener más información sobre objetos de comando, consulta Acerca de los objetos de comando ASP.

En Dreamweaver, abrir la página que ejecutará el procedimiento almacenado.
En el panel Bindings (Ventana > Bindings), haz clic en el botón Más (+) y luego selecciona Command (Stored Procedure).

Aparecerá el cuadro de diálogo Comando.

Introduzca un nombre para el comando, seleccione una conexión a la base de datos que contiene el procedimiento almacenado y luego seleccione Procedimiento almacenado en el menú emergente Tipo.
Seleccione su procedimiento almacenado expandiendo la rama Procedimientos almacenados en el cuadro Elementos de base de datos, seleccionando el procedimiento almacenado de la lista y haciendo clic en el botón Procedimiento.
Introduzca los parámetros necesarios en la tabla Variables.

No es preciso que introduzca ningún parámetro para variables RETURN_VALUE.

Haga clic en Aceptar.

Después de cerrar el cuadro de diálogo, se inserta código ASP en tu página. Cuando el código se ejecuta en el servidor, el código crea un objeto de comando que ejecuta un procedimiento almacenado en la base de datos. El procedimiento almacenado a su vez realiza una operación de base de datos, como insertar un registro.

De forma predeterminada, el código establece la propiedad Prepared del objeto Command como true, lo que hace que el servidor de aplicaciones reutilice una sola versión compilada del objeto cada vez que se ejecuta el procedimiento almacenado.Si sabes que el comando se ejecutará más de unas pocas veces, tener una sola versión compilada del objeto puede mejorar la eficiencia de las operaciones de base de datos. Sin embargo, si el comando solo se ejecutará una o dos veces, usar uno podría en realidad ralentizar tu aplicación web porque el sistema tiene que hacer una pausa para compilar el comando. Para cambiar la configuración, cambia a la vista de código y cambia la propiedad Prepared a falso.

Nota

No todos los proveedores de bases de datos admiten comandos preparados. Si tu base de datos no lo admite, podrías obtener un mensaje de error cuando ejecutes la página.Cambie a la vista Código y establezca la propiedad Preparado como false.

Si el procedimiento almacenado toma parámetros, podrías crear una página que recopile los valores de los parámetros y los envíe a la página con el procedimiento almacenado. Por ejemplo, puedes crear una página que use parámetros de URL o un formulario HTML para recopilar valores de parámetros de usuarios.