Añadir comportamientos de servidor personalizados en Dreamweaver

Comportamientos de servidor personalizados

Dreamweaver incluye un conjunto de comportamientos de servidor integrados que te permite añadir fácilmente capacidades dinámicas a un sitio. Puedes ampliar la funcionalidad de Dreamweaver creando comportamientos de servidor que se adapten a tus necesidades de desarrollo, o obteniendo comportamientos de servidor del sitio web de Dreamweaver Exchange.

Antes de crear tus propios comportamientos de servidor, debes consultar el sitio web de Dreamweaver Exchange para ver si otra persona ya ha creado un comportamiento de servidor que proporcione la funcionalidad que te gustaría añadir a tu sitio web. A menudo, un desarrollador tercero ha creado y probado un comportamiento de servidor que atenderá tus necesidades.

Acceso a Dreamweaver Exchange

Instalar un comportamiento de servidor u otra extensión en Dreamweaver

Flujo de trabajo de comportamientos de servidor personalizados

Si eres un desarrollador web experto en ColdFusion, JavaScript, VBScript o PHP, puedes escribir tus propios comportamientos de servidor.Los pasos para crear un comportamiento de servidor incluyen las siguientes tareas:

• Escribir uno o más bloques de código que realicen la acción requerida.

• Especificar dónde debe insertarse el bloque de código dentro del código HTML de la página.

• Si el comportamiento de servidor requiere que se especifique un valor para un parámetro, crea un cuadro de diálogo que solicite al desarrollador web que aplique el comportamiento que proporcione un valor apropiado.

• Compruebe el comportamiento de servidor antes de ponerlo a disposición de otras personas.

Utilización del Creador de comportamientos de servidor

Usa el Creador de comportamientos de servidor para añadir el bloque o bloques de código que el comportamiento inserta en una página.

Opciones avanzadas

Después de especificar el código fuente y la ubicación de inserción para cada bloque de código, el comportamiento del servidor está completamente definido.En la mayoría de los casos, no necesitas especificar información adicional.

Si eres un usuario avanzado, puedes establecer cualquiera de las siguientes opciones:

Especifica si el bloque de código debe tratarse como un identificador.

Como opción predeterminada, cada bloque de código es un identificador. Si Dreamweaver encuentra un bloque de código identificador en cualquier lugar de un documento, enumera el comportamiento en el panel Comportamientos del servidor.Utiliza la opción Identificador para especificar si el bloque de código debe tratarse como un identificador.

Al menos uno de los bloques de código del comportamiento del servidor debe ser un identificador.Un bloque de código no debe ser un identificador si se aplica alguna de las siguientes condiciones: el mismo bloque de código es utilizado por algún otro comportamiento del servidor; o el bloque de código es tan simple que podría aparecer de forma natural en la página.

Especifica el título del comportamiento en el panel Comportamientos del servidor.

Cuando el diseñador de páginas haga clic en el botón Más (+) del panel Comportamientos del servidor, el título del nuevo comportamiento del servidor aparecerá en el menú emergente.Cuando un diseñador aplica una instancia de un comportamiento del servidor a un documento, el comportamiento aparece en la lista de comportamientos aplicados en el panel Comportamientos del servidor.Use el cuadro Título del comportamiento del servidor para especificar el contenido del menú emergente Más (+) y la lista de comportamientos aplicados.

El Valor inicial en el cuadro es el nombre que proporcionó en el cuadro de diálogo Nuevo comportamiento del servidor.A medida que se definen los parámetros, el nombre se actualiza automáticamente para que los parámetros aparezcan entre paréntesis después del nombre del comportamiento del servidor.

Establecer variable de sesión (@@Name@@, @@Value@@)

Si el Usuario acepta el Valor predeterminado, todo lo que está antes de los paréntesis aparece en el menú emergente Más (+) (por ejemplo, Establecer Variable de sesión).El nombre más los parámetros aparecerán en la lista de comportamientos aplicados, por ejemplo, Establecer Variable de sesión ("abcd", "5").

Especifica qué bloque de código se selecciona cuando el usuario selecciona el comportamiento en el panel Comportamientos de servidor.

Cuando aplicas un comportamiento de servidor, uno de los bloques de código dentro del comportamiento se designa como el "bloque de código a seleccionar". Si aplicas el comportamiento de servidor y luego seleccionas el comportamiento en el panel Server Behaviors, el bloque designado se selecciona en la ventana Documento. De forma predeterminada, Dreamweaver selecciona el primer bloque de código que no esté por encima de la etiqueta html. Si todos los bloques de código están por encima de la etiqueta html, entonces se selecciona el primero. Los usuarios avanzados pueden especificar qué bloque de código es el seleccionado.

Crear bloques de código

Los bloques de código que creas en el Server Behavior Builder se encapsulan en un comportamiento de servidor que aparece en el panel Server Behaviors. El código puede ser cualquier código de tiempo de ejecución válido para el modelo de servidor especificado. Por ejemplo, si eliges ColdFusion como tipo de documento para tu comportamiento de servidor personalizado, el código que escribas debe ser código ColdFusion válido que se ejecute en un servidor de aplicación ColdFusion.

Puedes crear los bloques de código directamente en el Server Behavior Builder, o puedes copiar y pegar el código de otras fuentes. Cada bloque de código que creas en el Server Behavior Builder debe ser una sola etiqueta o bloque de Script. Si debes insertar múltiples bloques de etiquetas, divídelos en bloques de código separados.

Condiciones en los bloques de código

Dreamweaver te permite desarrollar bloques de código que incorporan sentencias de control que se ejecutan condicionalmente.El Server Behavior Builder usa declaraciones if, elseif y else, y también puede contener parámetros de comportamiento de servidor. Esto te permite insertar bloques de texto alternativos basados en los valores de relaciones OR entre parámetros de comportamiento de servidor.

El siguiente ejemplo muestra las declaraciones if, elseif y else. Los corchetes ([ ]) denotan código opcional y el asterisco (*) denota cero o más instancias. Para ejecutar una parte de un bloque de código o todo el bloque de código solo si se aplica una condición o condiciones determinadas, usa la siguiente sintaxis:

<@ if (expression1) @> condicional

texto1[<@ elseif (expression2) @> texto condicional2]*[<@ else @>

texto condicional3]<@ endif @>

Las expresiones de condición pueden ser cualquier expresión de JavaScript que se pueda evaluar usando la función eval() de JavaScript, y pueden incluir un parámetro de comportamiento de servidor marcado por @@. (Los @@ distinguen el parámetro de las variables y palabras clave de JavaScript.)

Utilización eficaz de expresiones condicionales

Cuando usas las directivas if, else y elseif dentro de la etiqueta XML insertText, el texto participante se preprocesa para resolver las directivas if y determinar qué texto incluir en el resultado. Las directivas if y elseif toman la expresión como argumento. La expresión de condición es la misma que para las expresiones de condición de JavaScript, y también puede contener parámetros de comportamiento de servidor. Las directivas como esta te permiten elegir entre bloques de código alternativos basados en los valores de, o relaciones entre, parámetros de comportamiento del servidor.

Por ejemplo, el siguiente código JSP viene de un comportamiento de servidor de Dreamweaver que usa un bloque de código condicional:

@@rsName@@.close();

<@ if (@@callableName@@ != '') @>

@@callableName@@.execute();

@@rsName@@ = @@callableName@@.getResultSet();<@ else @>

@@rsName@@ = Statement@@rsName@@.executeQuery();

<@ endif @>

@@rsName@@_hasData = @@rsName@@.next();

El bloque de código condicional comienza con <@ if (@@callableName@@ != '') @> y termina con <@ endif @>. De acuerdo con el código, si el usuario introduce un valor para el parámetro @@callableName@@ en el cuadro de diálogo Parámetro del comportamiento del servidor—en otras palabras, si el valor del parámetro @@callableName@@ no es nulo, o (@@callableName@@ != '')—entonces el bloque de código condicional se reemplaza con las siguientes declaraciones:

@@callableName@@.execute();

@@rsName@@ = @@callableName@@.getResultSet();

De lo contrario, el bloque de código se reemplaza con la siguiente declaración:

@@rsName@@ = Statement@@rsName@@.executeQuery();

Colocación de un bloque de código

Cuando creas bloques de código usando el Server Behavior Builder, debes especificar dónde insertarlos en el código HTML de la página.

Por ejemplo, si insertas un bloque de código por encima de la etiqueta de apertura <html>, entonces debes especificar la posición del bloque de código relativa a otras etiquetas, scripts y comportamientos de servidor en esa sección del código HTML de la página.Los ejemplos típicos incluyen posicionar un comportamiento antes o después de cualquier consulta de recordset que también pueda existir en el código de página encima de la etiqueta de apertura <html>.

Cuando seleccionas una opción de posicionamiento del menú emergente Insertar código, las opciones disponibles en el menú emergente Posición relativa cambian para proporcionar opciones relevantes para esa parte de la página. Por ejemplo, si seleccionas Encima de la etiqueta <html> en el menú emergente Insertar código, las opciones de posicionamiento disponibles en el menú emergente Posición relativa reflejan opciones relevantes para esa parte de la página.

La siguiente tabla muestra las opciones de inserción de bloques de código, y las opciones de posicionamiento relativo disponibles para cada una:

Para especificar una posición personalizada, debes asignar un peso al bloque de código.Usa la opción Posición personalizada cuando necesites insertar más de un bloque de código en un orden particular. Por ejemplo, para insertar una serie ordenada de tres bloques de código después de los bloques de código que abren conjuntos de registros, introduciría un peso de 60 para el primer bloque, 65 para el segundo y 70 para el tercero.

De forma predeterminada, Dreamweaver asigna un peso de 50 a todos los bloques de código de apertura de conjuntos de registros insertados encima de la etiqueta <html>.Si el peso de dos o más bloques coincide, Dreamweaver establece de forma aleatoria el orden entre los bloques.

Colocar un bloque de código (instrucciones generales)

Colocar un bloque de código relativo a otra etiqueta en la página

Colocar un bloque de código relativo a una etiqueta seleccionada por el diseñador de páginas

Repetición de bloques de código con la directiva loop

Para repetir una parte de un bloque de código o todo el bloque de código varias veces, utilice la siguiente sintaxis:

<@ loop (@@param1@@,@@param2@@) @> código

bloque<@ endloop @>

Al crear comportamientos del servidor, puedes utilizar construcciones de bucle para repetir un bloque de código un número específico de veces.<@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> bloque de código <@ endloop @>La directiva loop acepta una lista separada por comas de matrices de parámetros como argumentos.En este caso, los argumentos de matriz de parámetros permiten que un usuario proporcione varios valores para un solo parámetro. El texto que se repite se duplica n veces, donde n es la longitud de los argumentos de matriz de parámetros. Si se especifica más de un argumento de matriz de parámetros, todas las matrices deben tener la misma longitud. En la i-ésima evaluación del bucle, los i-ésimos elementos de las matrices de parámetros reemplazan las instancias de parámetros asociadas en el bloque de código.

Al crear un cuadro de diálogo para el comportamiento del servidor, puede agregar un control al cuadro de diálogo que permita al diseñador de páginas crear matrices de parámetros.Dreamweaver incluye un control de matriz simple que puede utilizar para crear cuadros de diálogo. Este control, denominado Lista separada por comas de campo de texto, está disponible a través del Generador de comportamientos del servidor. Para crear elementos de interfaz de usuario de mayor complejidad, consulte la documentación de la API para crear un cuadro de diálogo con un control para crear matrices (un control de cuadrícula, por ejemplo).

Puede anidar cualquier número de condicionales o una directiva de bucle dentro de una directiva condicional. Por ejemplo, puede especificar que si una expresión es verdadera ejecute un bucle.

El siguiente ejemplo muestra cómo se pueden utilizar dichos bloques de código repetitivos para crear comportamientos del servidor (el ejemplo es un comportamiento de ColdFusion utilizado para acceder a un procedimiento almacenado):

<@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> bloque de código

<@ endloop @>

<CFSTOREDPROC procedure="AddNewBook"

datasource=#MM_connection_DSN#

username=#MM_connection_USERNAME#

password=#MM_connection_PASSWORD#>

<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryID#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"

cfsqltype="CF_SQL_VARCHAR">

</CFSTOREDPROC>

En este ejemplo, la etiqueta CFSTOREDPROC puede incluir cero o más etiquetas CFPROCPARAM. Sin embargo, sin compatibilidad con la directiva loop, no hay manera de incluir las etiquetas CFPROCPARAM dentro de la etiqueta CFSTOREDPROC insertada. Si esto se creara como un comportamiento del servidor sin el uso de la directiva loop, sería necesario dividir este ejemplo en dos participantes: una etiqueta principal CFSTOREDPROC, y una etiqueta CFPROCPARAM cuyo tipo de participante es múltiple.

Usando la directiva loop, puedes escribir el mismo procedimiento como sigue:

<CFSTOREDPROC procedure="@@procedure@@"

datasource=#MM_@@conn@@_DSN#

username=#MM_@@conn@@_USERNAME#

password=#MM_@@conn@@_PASSWORD#>

<@ loop (@@paramName@@,@@value@@,@@type@@) @>

<CFPROCPARAM type="IN"

dbvarname="@@paramName@@"

value="@@value@@"

cfsqltype="@@type@@">

<@ endloop @>

</CFSTOREDPROC>

Si el usuario introdujo los siguientes valores de parámetro en el cuadro de diálogo Server Behavior Builder:

procedure = "proc1"

conn = "connection1"

paramName = ["@CategoryId", "@Year", "@ISBN"]

value = ["#Form.CategoryId#", "#Form.Year#", "#Form.ISBN#"]

type = ["CF_SQL_INTEGER", "CF_SQL_INTEGER", "CF_SQL_VARCHAR"]

El comportamiento del servidor insertaría el siguiente código de tiempo de ejecución en la página:

<CFSTOREDPROC procedure="proc1"

datasource=#MM_connection1_DSN#

username=#MM_connection1_USERNAME#

password=#MM_connection1_PASSWORD#>

<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryId#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@Year" value="#Form.Year#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"

cfsqltype="CF_SQL_VARCHAR">

</CFSTOREDPROC>

Utilización de las variables _length e _index de la directiva loop

La directiva loop incluye dos variables integradas que puedes usar para condiciones if embebidas.Dichas variables son: _length y _index. La variable _length corresponde a la longitud de las matrices procesadas por la directiva de bucle, mientras que la variable _index corresponde al índice actual de la directiva de bucle.Para asegurarte de que las variables solo se reconozcan como directivas, y no como parámetros reales que se pasan al bucle, no incluyas ninguna Variable en @@.

Un ejemplo de uso de variables integradas es aplicarlas al atributo import de la directiva de página.El atributo import requiere separación por comas de paquetes. Si la directiva loop se extiende alrededor de todo el atributo import, solo se mostraría el nombre del atributo import= en la primera iteración del bucle—esto incluye las comillas dobles de cierre (&quot;)—y no se mostraría una coma en la última iteración del bucle.Usando la variable integrada, puedes expresar esto de la siguiente manera:

<@loop (@@Import@@)@>

<@ if(_index == 0)@>import="

<@endif@>@@Import@@<@if (_index == _length-1)@>"<@else@>,

<@ endif @>

<@endloop@>

Solicitar un parámetro para el comportamiento del servidor

Los comportamientos del servidor a menudo requieren que el diseñador de páginas proporcione un Valor de parámetro. Este valor debe insertarse antes de que el código del comportamiento del servidor se inserte en la página.

Creas el cuadro de diálogo definiendo los parámetros proporcionados por el diseñador en el código. Luego generas un cuadro de diálogo para el comportamiento del servidor, que solicita al diseñador de páginas un Valor de parámetro.

Definir el parámetro en el código del comportamiento del servidor

También puede resaltar la cadena y hacer clic en el botón Insertar parámetro en bloque de código. Escriba el nombre del parámetro y haga clic en Aceptar. Dreamweaver reemplazará todas las instancias de la cadena resaltada por el nombre de parámetro especificado entre los marcadores de parámetro.

Dreamweaver utiliza las cadenas especificadas entre marcadores de parámetros para asignar una etiqueta a los controles del cuadro de diálogo que genera (consulte el siguiente procedimiento). En el ejemplo anterior, Dreamweaver crea un cuadro de diálogo con la siguiente etiqueta:

Crear un cuadro de diálogo para tu comportamiento del servidor para solicitar el valor del parámetro

Visualización del cuadro de diálogo

Editar el cuadro de diálogo que creaste para el comportamiento del servidor

Edición y modificación de comportamientos de servidor

Puedes editar cualquier comportamiento del servidor creado con el Generador de comportamientos del servidor, incluyendo comportamientos del servidor que descargues del sitio web Dreamweaver Exchange, y otros desarrolladores externos.

Si aplicas un comportamiento de servidor a una página y después editas el comportamiento en Dreamweaver, las instancias del comportamiento anterior ya no aparecen en el panel Comportamientos del servidor. El panel Comportamientos del servidor busca en la página código que coincida con el código de comportamientos de servidor conocidos. Si el código de un comportamiento de servidor cambia, el panel no reconoce versiones anteriores del comportamiento en esa página.

Conservar las versiones antigua y nueva del comportamiento en el panel

Editar el código de un comportamiento de servidor creado con el Generador de comportamientos del servidor

Reglas de programación

En general, el código del comportamiento de tu servidor debe ser compacto y robusto.Los desarrolladores de aplicaciones web son muy sensibles al código añadido a sus páginas. Sigue las prácticas de codificación generalmente aceptadas para el lenguaje del tipo de documento (ColdFusion, JavaScript, VBScript o PHP). Al escribir comentarios, ten en cuenta las diferentes audiencias técnicas que podrían necesitar entender el código, como diseñadores web y de interacción, u otros desarrolladores de aplicaciones web.Incluir comentarios que describan con precisión el propósito del código y cualquier instrucción especial para incluirlo dentro de una página.

Ten en cuenta las siguientes pautas de codificación cuando crees comportamientos del servidor:

Un requisito importante. El código del comportamiento del servidor debe gestionar los casos de error de forma elegante.Intente prever cualquier posibilidad: Por ejemplo, ¿qué pasa si falla una solicitud de parámetro? ¿Qué pasa si no se devuelven registros de una consulta?

Ayuda a garantizar que tu código sea claramente identificable y evite conflictos de nombres con código existente.Por ejemplo, si la página contiene una función llamada hideLayer() y una variable global llamada ERROR_STRING, y el comportamiento del servidor inserta código que también usa esos nombres, el comportamiento del servidor puede entrar en conflicto con el código existente.

Te permite identificar tus propias funciones de tiempo de ejecución y variables globales en una página.Una posible convención consiste en usar sus iniciales. Nunca utilice el prefijo MM_, ya que está reservado para uso exclusivo de Dreamweaver. Dreamweaver antepone todas las funciones y variables globales con el prefijo MM_ para evitar que entren en conflicto con cualquier código que escribas.

var MM_ERROR_STRING = "...";

function MM_hideLayer() {

para que el código que escribas no se parezca demasiado al código en otros bloques.Si un bloque de código se parece demasiado a otro bloque de código en la página, el panel Comportamientos del servidor podría identificar erróneamente el primer bloque de código como una instancia del segundo bloque de código (o viceversa). Una solución simple es añadir un comentario a un bloque de código para hacerlo más único.

Probar comportamientos del servidor

Dreamweaver Exchange recomienda realizar las siguientes pruebas en cada comportamiento del servidor que crees:

• Aplique el comportamiento desde el panel Comportamientos del servidor. Si tiene un cuadro de diálogo, introducir datos válidos en cada campo y hacer clic en Aceptar.Verifique que no se produce ningún error al aplicar el comportamiento. Verificar que el código de tiempo de ejecución para el comportamiento del servidor aparezca en el inspector de Código.

• Aplicar el comportamiento del servidor de nuevo e introducir datos no válidos en cada campo del cuadro de diálogo.Intenta dejar el campo en blanco, usar números grandes o negativos, usar caracteres no válidos (como /, ?, :, *, etcétera), y usar letras en campos numéricos. Puedes escribir rutinas de validación de formularios para manejar datos no válidos (las rutinas de validación implican codificación manual, lo cual está más allá del ámbito de este libro).

  Después de aplicar exitosamente tu comportamiento del servidor a la página, verifica lo siguiente:

• Revisa el panel Comportamientos del servidor para asegurarte de que el nombre del comportamiento del servidor aparezca en la lista de comportamientos añadidos a la página.

• Si corresponde, verifica que los iconos de Script del lado del servidor aparezcan en la página. Los iconos genéricos de los scripts del lado del servidor son escudos de oro. Para ver los iconos, habilite Elementos invisibles (Vista > Ayudas visuales > Elementos invisibles).

• En vista de Código (Ver > Código), verifica que no se genere código no válido.

  Además, si tu comportamiento del servidor inserta código en el documento que establece una conexión a una base de datos, crea una base de datos de prueba para probar el código insertado en el documento. Verifica la conexión definiendo consultas que produzcan diferentes conjuntos de datos, y diferentes tamaños de conjuntos de datos.

  Finalmente, carga la página al servidor y ábrela en un explorador. Consulte el código fuente HTML de la página y verifique que no se haya generado HTML no válido por los scripts del lado del servidor.