Uso de componentes de ColdFusion en Dreamweaver

Los archivos de componentes de ColdFusion (CFC) permiten encapsular la lógica de aplicaciones y empresarial en unidades reutilizables y autónomas. Los CFC también proporcionan una forma rápida y sencilla de crear servicios web.

Un CFC es una unidad de software reutilizable escrita en el lenguaje de formato ColdFusion (CFML), que facilita la reutilización y el mantenimiento del código.

Puede utilizar Dreamweaver para trabajar con archivos CFC. Para obtener información sobre las etiquetas y la sintaxis CFC, consulte la documentación de ColdFusion que se encuentra en Dreamweaver (Ayuda > Ayuda de ColdFusion).

Los CFC están diseñados para proporcionar a los desarrolladores una forma sencilla y eficaz de encapsular elementos de sus sitios web. En general deberá utilizar componentes para la lógica de aplicaciones o empresarial. Utilice etiquetas personalizadas para elementos de presentación como saludos personalizados, menús dinámicos, etc.

Como ocurre con otros muchos tipos de construcción, los sitios dinámicos pueden a menudo beneficiarse de los componentes intercambiables. Por ejemplo, un sitio dinámico puede ejecutar la misma consulta repetidamente o calcular el precio total de las páginas de carros de la compra y recalcularlo cada vez que se añada un artículo. Los componentes pueden realizar estas tareas. Puede solucionar, mejorar, ampliar e incluso sustituir un componente con un mínimo impacto sobre el resto de la aplicación.

Supongamos que una tienda online calcula los gastos de envío basándose en el precio de los pedidos. Para pedidos de menos de 20 €, los gastos de envío son de 4 €; para los pedidos entre 20 y 40 €, los gastos ascienden a 6 €, y así sucesivamente. Puede insertar la lógica para calcular los gastos de envío en la página de carro de la compra y la página de caja, pero esto supondría mezclar el código de presentación HTML y el código de lógica CFML y, en términos generales, dificultaría el mantenimiento y la reutilización del código.

Usted decide crear un CFC llamado Pricing que tiene, entre otras cosas, una función llamada ShippingCharge. La función toma un precio como argumento y devuelve gastos de envío. Por ejemplo, si el valor del argumento es 32,80, la función devuelve 6.

En la página de carro de la compra y la página de caja, inserte una etiqueta especial para activar la función ShippingCharge. Cuando se solicita la página, se activa la función y se devuelven gastos de envío a la página.

Posteriormente, la tienda anuncia una promoción especial. Se realiza el envío gratuito para todos los pedidos que superen los 100 €. Realice el cambio en las tarifas de envío en un lugar (la función ShippingCharge del componente Pricing) y todas las páginas que utilizan la función obtendrán automáticamente gastos de envío precisos.

Introducción al panel Componentes CF (ColdFusion)

Utilice el panel Componentes (Ventana > Componentes) para ver y editar componentes de ColdFusion y añadir código a la página que ejecuta la función cuando se solicita la página CFM.

Creación o eliminación de un CFC en Dreamweaver

Puede utilizar Dreamweaver para definir visualmente un CFC y sus funciones. Dreamweaver crea un archivo .cfc e inserta las etiquetas CFML necesarias automáticamente.

Visualización de CFC en Dreamweaver

Dreamweaver permite examinar visualmente los componentes de ColdFusion (CFC) ubicados en la carpeta del sitio o en el todo el servidor. Dreamweaver lee los archivos CFC y muestra información sobre ellos en una vista de árbol de fácil navegación en el panel Componentes.

Dreamweaver busca los componentes en el servidor de prueba (consulte Conexión a la base de datos en Dreamweaver). Si crea archivos CFC o realiza modificaciones en los que ya existen, no olvide cargar los archivos CFC en el servidor de prueba para que se reflejen con precisión en el panel Componentes.

Para ver los componentes situados en otro servidor, cambie la configuración del servidor de prueba.

Puede visualizar cualquier información de la siguiente sobre sus componentes de CF:

• Mostrar todos los componentes de ColdFusion definidos para el servidor.

• Si ejecuta ColdFusion MX 7 o una versión posterior, filtrar la lista para mostrar solo los CFC ubicados en la carpeta del sitio.

• Explorar las funciones y los argumentos de cada componente.

• Consultar las propiedades de las funciones que actúan como servicios web.

Para ver CFC en Dreamweaver, siga estos pasos:

Edición de CFC en Dreamweaver

Dreamweaver proporciona un modo optimizado de editar el código de los componentes de ColdFusion definidos para el sitio. Por ejemplo, puede añadir, cambiar o eliminar cualquier función de componente sin salir de Dreamweaver .

Para utilizar esta función, el entorno de desarrollo deberá configurarse de este modo:

• ColdFusion debe ejecutarse localmente.

• En el cuadro de diálogo Definición del sitio avanzado de Dreamweaver, el tipo de acceso especificado en la categoría Servidor de prueba debe ser Local/red.

• En el cuadro de diálogo Definición del sitio avanzado, la ruta de la carpeta raíz local debe ser la misma que la de la carpeta del servidor de prueba (por ejemplo, c:\Inetpub\wwwroot\cf_projects\myNewApp\). Puede examinar y cambiar estas rutas si selecciona Sitio > Editar sitios.

• El componente debe estar almacenado en la carpeta del sitio local o en cualquiera de sus subcarpetas del disco duro.

Abra cualquier página de ColdFusion en Dreamweaver y visualice los componentes en el panel Componentes. Para mostrar los componentes, abra el panel Componentes (Ventana > Componentes), seleccione Componentes CF en el menú emergente del panel y haga clic en el botón Actualizar del panel.

Dado que ColdFusion se ejecuta localmente, Dreamweaver muestra los paquetes de componentes en el disco duro.

Siga este procedimiento para editar un componente.

Creación de páginas web que utilicen CFC

Una forma de utilizar una función de componente en las páginas web consiste en escribir código en la página que activa la función cuando se solicita la página. Puede utilizar Dreamweaver como ayuda para escribir este código.

Definición de un juego de registros en un CFC

Puede utilizar Dreamweaver para definir un juego de registros (también conocido como consulta ColdFusion) en un componente de ColdFusion (CFC). Al definir un juego de registros en un CFC, no es necesario definirlo en cada página que lo utilice. Basta con definir el juego de registros una sola vez en el CFC y utilizarlo en las distintas páginas.

Utilización de un juego de registros de CFC como fuente de contenido dinámico

Puede utilizar un componente de ColdFusion (CFC) como fuente de contenido dinámico para sus páginas si el componente contiene una función que defina el juego de registros.

Definición de contenido dinámico mediante un CFC

Puede definir un juego de registros como fuente de contenido dinámico en Dreamweaver empleando un CFC que contenga una definición de juego de registros.

1. En el cuadro Nombre, introduzca un nombre para el juego de registros CFC.

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 solo deben contener caracteres alfanuméricos y guiones bajos (_). No puede incluir caracteres especiales ni espacios.

2. Seleccione un paquete entre los que ya están definidos en el servidor.

Si el paquete no aparece en el menú emergente, puede actualizar la lista haciendo clic en el botón Actualizar que se encuentra junto al menú emergente.

Asegúrese de que primero ha cargado los CFC en el servidor de prueba. Sólo se muestran los CFC del servidor de prueba.

3. Seleccione un componente de los que se definen en el paquete seleccionado actualmente.

Si el menú emergente del componente no contiene ningún componente, o bien si ninguno de los componentes creados previamente aparece en el menú, deberá cargar los archivos CFC en el servidor de prueba.

4.(Opcional) Para crear un componente nuevo, haga clic en el botón Crear nuevo componente.

a. En el cuadro Nombre, introduzca un nombre para el nuevo CFC. El nombre solo debe contener caracteres alfanuméricos y guiones bajos (_).

b. En el cuadro Directorio de componentes, escriba la ubicación del CFC o localice la carpeta.

5. En el menú emergente Función, seleccione la función que contenga la definición del juego de registros.

El menú emergente Función contiene solo las funciones definidas en el componente seleccionado actualmente. Si no aparece ninguna función en el menú emergente, o si no se reflejan los últimos cambios realizados en las funciones que aparecen, verifique que estos cambios se guardaron y se cargaron en el servidor.

6. Haga clic en el botón Editar para editar cada parámetro (tipo, valor y valor predeterminado) que deba enviarse como argumento de función.

a. Escriba un valor para el parámetro actual. Para ello, seleccione el tipo de valor en el menú emergente Valor y escriba el valor en el cuadro de la derecha. El tipo de valor puede ser un parámetro de URL, una variable de formulario, una cookie, una variable de sesión, una variable de aplicación o un valor introducido.

b. Introduzca un valor predeterminado para el parámetro en el cuadro Valor predeterminado. Si no se devuelve ningún valor de tiempo de ejecución, se utilizará el valor de parámetro predeterminado.

c. Haga clic en OK. 

No es posible modificar la conexión de base de datos y la consulta SQL del juego de registros. Estos campos aparecen siempre desactivados: la conexión y la consulta SQL solo se muestran a título informativo.

7. 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 parámetros de página, asegúrese de que la columna Valor predeterminado del cuadro Parámetros contiene valores de prueba válidos antes de hacer clic en Prueba.

Si la consulta se ha realizado correctamente, el juego de registros se muestra en una tabla. Cada fila contiene un registro y cada columna representa un campo de dicho registro.

Haga clic en OK para vaciar la consulta CFC.

8. Haga clic en OK.