Introducción a Web Panels

Transcripción

1 Introducción a Web Panels El web panel es el objeto más flexible que provee GeneXus. Como ya habíamos indicado, es básicamente una página web que nos permite resolver variadas funcionalidades, como solicitarle datos al usuario: por ejemplo, pidiéndole que ingrese un porcentaje para aplicárselo como aumento a todos los precios de los vuelos o pidiéndole un rango de nombres, Para luego invocar (presionando el botón, o la tecla Enter) a un procedimiento que imprima las atracciones que están en ese rango. o simplemente desplegar los datos devueltos por un data provider en una variable colección. Page1

2 insertada en el form (automáticamente asociada a un control grid). Pero podemos también desplegar directamente información de la base de datos, por ejemplo, la información de un cliente. Para eso creamos un web panel ViewCustomerInfo Page2

3 De la toolbox que nos ofrece todos los controles que podríamos utilizar en este form, arrastramos el control Atributo/variable y elegimos los atributos que queramos mostrar del cliente: (CustomerFullName es un atributo fórmula que devuelve juntos el apellido y el nombre y elegimos también la dirección y el . Vemos que automáticamente inserta una tabla para contenerlos, junto con sus descripciones: Si ahora ejecutamos, F5 Page3

4 Vemos que está desplegándose la información de qué cliente? Si vamos a la transacción Customer vemos que Martin Faulkner es el último y está mostrando sus datos. Hemos programado el web panel para que muestre los datos de un cliente, pero omitimos decirle de cuál. Para ello le agregamos regla parm especificándole que el parámetro recibido será el atributo CustomerId. Por recibirlo en un atributo (en lugar de en una variable) se realizará automáticamente un filtro por igualdad por este atributo. Tendremos que invocar a este web panel desde otro objeto que pueda enviarle el id del cliente deseado. Por ejemplo, otro web panel SelectCustomer, que ya hemos creado Ejecutemos y veamos el resultado Primero veamos qué clientes tenemos por ejemplo, el 2, Susan Brown Seleccionémoslo Page4

5 Y presionemos el botón o la tecla enter, para ver sus datos Podemos concluir entonces que en el form de un web panel las variables se utilizan, en forma predeterminada, como controles de entrada de datos (es decir, el usuario podrá ingresar en ellos un valor). Mientras que los atributos se utilizan como controles de salida (es decir, despliegan información de la base de datos) Detengámonos en la navegación de este web panel Qué nos informa? Que para cargar la información que le pedimos en pantalla, debe acceder a la tabla Customer de la base de datos, filtrando por el valor de CustomerId recibido por parámetro. Apreciemos todo lo que GeneXus infiere tan sólo por colocar los atributos en el form. Y si ahora queremos mostrar esa misma información, pero de todos los clientes y no de uno solo? Hagamos un save as En ese caso tendremos que colocar esos atributos en un grid. Al arrastrarlo se abre automáticamente esta ventana para elegir los atributos o variables que queramos insertar en ese grid como columnas. Page5

6 Elegimos por ejemplo estos dos atributos y cerramos. Borramos los atributos sueltos que teníamos. Además borramos la regla parm, dado que ahora mostraremos todos los clientes y no necesitamos recibir nada. Presionamos F5 y vemos cómo salen desplegados todos los clientes. Page6

7 También podemos observar que las direcciones, al ser de tipo de datos Address, son interpretadas de manera especial y al cliquear sobre una, nos ubica la dirección en un mapa, sin que hayamos tenido que programar nada. Veamos el listado de navegación de este web panel La única diferencia con el anterior, es que aquí no se está filtrando por cliente. En cualquiera de los dos casos que vimos, debido a que mencionamos atributos en el form, GeneXus encontró la tabla a recorrer, la tabla base, exactamente igual a cuando tenemos un for each. Page7

8 En el caso de estos web panels hay una especie de for each implícito, que se ejecuta para cargar las líneas del grid. Page8