Nota:

La compatibilidad con ColdFusion se ha eliminado en Dreamweaver CC y versiones posteriores.

Componentes de ColdFusion

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

Nota:

Sólo es posible utilizar CFC con ColdFusion MX o una versión posterior. Los CFC no son compatibles con ColdFusion 5.

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.

Nota:

El panel Componentes solo está disponible cuando se ve una página de ColdFusion en Dreamweaver.

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.

Nota:

Según el componente, es posible que deba completar el código manualmente.

  1. Abra una página de ColdFusion en Dreamweaver.

  2. En el panel Componentes (Ventana > Componentes), seleccione Componentes CF en el menú emergente.

  3. Haga clic en botón de signo más (+), rellene el cuadro de diálogo Crear componentes y haga clic en OK.

    a. En la sección Componentes, introduzca los detalles del componente. A continuación se incluye una lista parcial:

    Nombre Especifica el nombre de archivo del componente. El nombre solo debe contener caracteres alfanuméricos y guiones bajos (_). No especifique la extensión .cfc cuando introduzca el nombre.

    Directorio componente Especifica dónde se guarda el componente. Seleccione la carpeta raíz de la aplicación web (como, por ejemplo, \Inetpub\wwwroot\myapp\) o cualquiera de sus subcarpetas. 

    b. Para definir una o varias funciones para el componente, seleccione Funciones en la lista Sección, haga clic en el botón de signo más (+) e introduzca los detalles de la nueva función.

    Asegúrese de que especifica el tipo de valor devuelto por la función en la opción Tipo de retorno.

    Nota:

    Si selecciona Remoto en el menú Acceso, la función pasará a estar disponible como servicio web.

    c. Para definir uno o varios argumentos para una función, seleccione Argumentos en la lista Sección, seleccione la función en el menú emergente, haga clic en el botón de signo más (+) e introduzca los detalles del nuevo argumento a la derecha.

  4. Si utiliza un servidor de desarrollo remoto, cargue el archivo CFC y los archivos dependientes (como los empleados para implementar una función o incluir archivos) en el servidor remoto.

    La carga de archivos garantiza la correcta ejecución de funciones de Dreamweaver como Vista en vivo y Vista previa en el navegador.

    Dreamweaver escribe un archivo CFC y lo guarda en la carpeta especificada. El nuevo componente también aparecerá en el panel Componentes (después de hacer clic en Actualizar).

  5. Si utiliza un servidor de desarrollo remoto, cargue el archivo CFC y los archivos dependientes (como los empleados para implementar una función o incluir archivos) en el servidor remoto.

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.

Nota:

Para utilizar Dreamweaver con el fin de inspeccionar los CFC que residen en la raíz del servidor mientras administra también los archivos del sitio en la raíz de un sitio web diferente, puede definir dos sitios de Dreamweaver. Configure el primer sitio de manera que señale a la raíz del servidor y el segundo, a la raíz del sitio web. Utilice el menú emergente sitio del panel Archivos para alternar rápidamente entre los dos sitios.

Para ver CFC en Dreamweaver, siga estos pasos:

  1. Abra cualquier página de ColdFusion en Dreamweaver.
  2. En el panel Componentes (Ventana > Componentes), seleccione Componentes CF en el menú emergente.
  3. Haga clic en el botón Actualizar del panel para recuperar los componentes.

    El paquete de componentes aparece en el servidor. Un paquete de componentes es una carpeta que contiene archivos CFC.

    Si no aparecen los paquetes de componentes existentes, haga clic en el botón Actualizar, en la barra de herramientas del panel.

  4. Para mostrar solamente los CFC ubicados en la carpeta del sitio, haga clic en el botón Mostrar solo CFC del sitio actual, en la barra de herramientas del panel Componentes.

    Nota:

    Esta función solo está disponible si ha definido un ordenador en el que se ejecuta ColdFusion MX 6 o una versión posterior como servidor de prueba para Dreamweaver.

    Nota:

    Si el sitio actual se muestra en una carpeta virtual del servidor remoto, el filtrado no funciona.

  5. Haga clic en el botón de signo más (+) situado junto al nombre del paquete para ver los componentes almacenados en el paquete.
    • Para ver las funciones de un componente, haga clic en el botón de signo más (+) situado junto al nombre del componente.

    • Para ver los argumentos que toma una función, así como el tipo de argumentos y si son obligatorios u opcionales, abra la rama de la función en la vista de árbol.

      Las funciones que no toman argumentos muestran el botón de signo más (+) junto a ellas.

    • Para ver rápidamente los detalles de un argumento, una función, un componente o un paquete, seleccione el elemento en la vista de árbol y haga clic en el botón Obtener datos de la barra de herramientas del panel.

      También puede hacer clic con el botón derecho (Windows) o mantener presionada la tecla Control y hacer clic (Macintosh) en el elemento; a continuación, seleccione Obtener datos en el menú emergente.

      Se mostrarán los detalles del elemento en un cuadro de mensaje.

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.

  1. Abra cualquier página de ColdFusion en Dreamweaver y visualice los componentes en el panel Componentes (Ventana > Componentes).
  2. 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.

    Nota:

    Para editar visualmente el juego de registros del CFC, haga doble clic en el panel Vinculaciones.

  3. Para editar un archivo de componente en general, abra el paquete y haga doble clic en el nombre del componente en la vista de árbol.

    El archivo del componente se abre en la vista de Código.

  4. Para editar una función, argumento o propiedad específica, haga doble clic en el elemento en la vista de árbol.
  5. Realice los cambios deseados manualmente en la vista de Código.
  6. Guarde el archivo (Archivo > Guardar).
  7. Para ver una función nueva en el panel Componentes, actualice la vista haciendo clic en el botón Actualizar de la barra de herramientas del panel.

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.

Nota:

Para obtener más información sobre otras maneras de utilizar los componentes, consulte la documentación de ColdFusion que se encuentra en Dreamweaver (Ayuda > Utilización de ColdFusion).

  1. En Dreamweaver, abra la página de ColdFusion que utilizará la función de componente.
  2. Cambie a la vista de Código (Ver > Código).
  3. Abra el panel Componentes (Ventana > Componentes) y seleccione Componentes CF en el menú emergente del panel.
  4. Busque el componente deseado e insértelo utilizando una de las técnicas siguientes:
    • Arrastre una función desde la vista de árbol hasta la página. Se insertará el código en la página para activar la función.

    • Seleccione la función en el panel y haga clic en el botón Insertar de la barra de herramientas del panel (el segundo botón a la derecha). Dreamweaver insertará el código en la página en el punto de inserción.

  5. Si inserta una función que tiene argumentos, complete el código del argumento manualmente.

    Para obtener más información, consulte la documentación de ColdFusion en Dreamweaver (Ayuda > Ayuda de ColdFusion).

  6. Guarde el archivo (Archivo > Guardar).

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.

Nota:

Esta función solo está disponible si se accede a un ordenador que ejecute ColdFusion MX 7 o una versión posterior. Para obtener más información, consulte Activación de las mejoras de ColdFusion.

 

  1. Cree o abra un archivo CFC existente en Dreamweaver.
  2. En el panel Vinculaciones (Ventana > 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. Puede trabajar el las dos versiones de este cuadro de diálogo: la simple y la avanzada.

  3. Para utilizar una función existente en el CFC, seleccione la función en el menú emergente Función y siga con el paso 5.

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

  4. Para definir una función nueva en el CFC, haga clic en el botón Nueva función, escriba un nombre para la función en el cuadro de diálogo que aparece y, por último, haga clic en Aceptar.

    El nombre solo debe contener caracteres alfanuméricos y guiones bajos (_).

  5. Para definir un juego de registros para la función, rellene las opciones del cuadro de diálogo Juego de registros.

    La nueva función se insertará en el CFC que define el juego de registros.

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.

Nota:

Esta función solo está disponible si se accede a un equipo que ejecute ColdFusion MX 7 o una versión posterior. Para obtener más información, consulte Activación de las mejoras de ColdFusion.

  1. Abra una página de ColdFusion en Dreamweaver.
  2. En el panel Vinculaciones (Ventana > 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. Puede trabajar el las dos versiones de este cuadro de diálogo: la simple y la avanzada.

  3. Haga clic en el botón CFC Query (Consulta CFC).
  4. Rellene el cuadro de diálogo de consulta de CFC, haga clic en Aceptar y luego haga clic de nuevo en Aceptar para añadir el juego de registros de CFC a la lista de fuentes de contenido disponibles en el panel Vinculaciones.
  5. Utilice el panel Vinculaciones para vincular el juego de registros a los distintos elementos de la página.

    Para obtener más información, consulte Adición de contenido dinámico a las páginas.

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.

Nota:

La carpeta debe estar en la ruta relativa a la carpeta raíz del sitio.

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.

Nota:

Los cuadros Conexión y SQL son de solo lectura.

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.

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