Soporte de Page Designer para EGL

Cuando crea un archivo JSP en un proyecto Web de EGL, EGL crea automáticamente un PageHandler y ese PageHandler incluye código EGL de esqueleto para que usted lo personalice. En Page Designer, haga lo siguiente:
  1. Arrastre componentes de la paleta a un JSP
  2. Utilice la vista Atributos para establecer características específicas de componente, como por ejemplo color y para establecer enlaces, que son relaciones entre componentes y datos o lógica
Puede realizar tareas específicas de EGL:

Al utilizar la pestaña de código fuente en Page Designer, puede enlazar manualmente componentes de un archivo JSP (específicamente de un archivo JavaServer Faces) con áreas de datos y funciones de un PageHandler. Aunque EGL no es sensible a las mayúsculas y minúsculas, los nombres de EGL a los que se hace referencia en el archivo JSP deben coincidir en cuanto a mayúsculas y minúsculas con la declaración de variable o función EGL; si la coincidencia no es total, se produce un error de JavaServer Faces. Es recomendable no cambiar las mayúsculas y minúsculas de una variable o función EGL después de enlazar esa variable o función con un campo JSP.

Para conocer más detalles sobre la denominación, consulte el apartado Cambios en identificadores de EGL en archivos JSP y beans Java generados.

Enlazar los componentes con las áreas de datos del PageHandler

La mayoría de los componentes del JSP mantienen una correspondencia de uno a uno con los datos. Un recuadro de texto, por ejemplo, muestra el contenido del elemento EGL al que está enlazado. Un recuadro de texto de entrada también actualiza el elemento EGL si el usuario cambia los datos.

Una situación más compleja tiene lugar cuando el usuario especifica un grupo de recuadros de selección, un recuadro de lista, un grupo de botones de selección o un recuadro combinado. En tales casos, son necesarios dos tipos de enlaces diferentes:
  • Uno destinado a enlazar el componente con el texto que el usuario debe visualizar. Un ejemplo de ello es el texto de un elemento de un recuadro de lista.
  • Otro destinado a enlazar el componente con un área de datos del PageHandler que recibe un valor para indicar la elección del usuario. Puede crear un elemento de datos, por ejemplo, que debe recibir el índice numérico de un elemento de recuadro de lista seleccionado por el usuario.
En la vista Propiedades, puede utilizar dos procedimientos para enlazar el componente con el texto que el usuario visualiza:
  • Puede utilizar Añadir opción para indicar que el componente está asociado con una sola serie de caracteres, que puede especificarse explícitamente o identificarse mediante un elemento del PageHandler
  • Puede utilizar Añadir conjunto de opciones para indicar que el componente está asociado con una lista de series de caracteres, que puede especificarse explícitamente o identificarse mediante un área del PageHandler, como por ejemplo una tabla de datos o una matriz de elementos de carácter

Como alternativa, puede enlazar un componente de selección única (recuadro combinado, recuadro de lista de selección única o grupo de botones de selección) con una matriz de elementos de carácter arrastrando la matriz desde la vista Datos de página hasta el componente.

Para enlazar un componente con un área de datos que va a recibir un valor que indicará la elección del usuario, puede utilizar la vista Datos de página o la vista Propiedades. El procedimiento es el mismo que para enlazar cualquier componente, incluso un recuadro de texto simple.

Si el valor sólo puede ser una de dos alternativas, puede enlazar el componente con un elemento EGL para el que la propiedad de elemento boolean esté establecida en yes. El componente rellena el elemento con uno de estos dos valores:
  • Para un elemento de caracteres, el valor es Y (para sí) o N (para no)
  • Para un elemento numérico, el valor es 1 (para sí) o 0 (para no)

Cuando se visualiza un recuadro de selección, el estado (seleccionado o no seleccionado) depende del valor del elemento enlazado.

Para obtener detalles acerca de las propiedades que pueden aplicarse a los elementos de datos del PageHandler, consulte el apartado Propiedades de elemento de página.

Enlazar los componentes con las funciones

Después de enlazar un botón de mandato o un hiperenlace de mandato a la superficie de la página, puede enlazar ese componente con una función EGL existente o con un manejador de eventos creado por Page Designer:
  • Puede enlazar el componente con un manejador de eventos existente de cualquiera de estas formas:
    • Arrastrando la función EGL del nodo Acciones de la vista Datos de página hasta el componente, tal como se recomienda
    • Abriendo el componente en la vista Edición rápida
    • Pulsando el componente con el botón derecho del ratón y seleccionando Editar evento de mandato Faces
  • Puede hacer que Page Designer cree un manejador de eventos nuevo cuando el usuario abra el componente en la vista Edición rápida o cuando pulsa el componente con el botón derecho del ratón y selecciona Editar evento de mandato Faces

Si Page Designer crea un manejador de eventos en el PageHandler y le proporciona acceso a esa función del PageHandler, el nombre de la función es el ID de botón asignado por la herramienta más la serie "Action". Si el nombre no es exclusivo del PageHandler, Page Designer añade un número al final del nombre de función.

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.