Hasta el momento hemos visto ejemplos de aplicación de Data Provider que requieren acceder a la base de datos para recuperar información.

Transcripción

1 Hasta el momento hemos visto ejemplos de aplicación de Data Provider que requieren acceder a la base de datos para recuperar información. Pero también es posible utilizar un Data Provider que devuelva una estructura de datos que ha sido cargada manualmente.

2 Como ejemplo de aplicación veremos la implementación de un menú que estará siempre visible en las páginas de la aplicación. Usaremos el user control: Slide Menu. Este user control no está inicialmente integrado a la barra de herramientas de GeneXus, así que deberemos instalarlo. Desde el Marketplace de GeneXus se dispone de un catálogo completo de user controls. Desde allí buscamos Slide Menu y lo descargamos. Para que quede finalmente instalado en la Toolbox de GeneXus se debe descomprimir la carpeta y copiarla en la carpeta UserControls bajo el directorio de instalación de GeneXus. Luego por línea de comando se deberá ejecutar GeneXus.exe / install. Al abrir finalmente GeneXus, el user controls aprarecerá automáticamente integrado a la toolbox.

3 Creamos un nuevo web panel de nombre WPMenu. Observemos que en la Toolbox aparece el nuevo control integrado. Lo arrastramos sobre el form. Como ya sabemos, cada vez que se utiliza un user control, se crean una serie de objetos en la KB y variables en el objeto que incluimos el user control. En este caso, se crea el SDT SlideMenuData en la KB, que si nos detenemos a observarlo podemos ver que se trata de una colección de elementos que componen a 1 menu. Cada uno de estos elementos tendrá un identificador, un nombre y un objeto al cual invocar. Además, GeneXus creó en el web panel, variables del tipo del SDT creado, que necesitaremos para completar la implementación de la carga del control.

4 Para cargar la variable colección que contiene la información del menú en el web panel, utilizaremos un Data Provider. Así que creamos el Data Provider DPMenu y arrastramos el SDT hacia él. Con qué datos cargaremos la colección? Necesitamos acceder a la base de datos? No. Porque las opciones que mostrará el menú, no están almacenadas en la base de datos, así que tendremos que cargar esta estructura con valores fijos. Cómo lo hacemos? Definiendo explícitamente cada grupo que representa una opcion en el menú. Vamos a definir nuestro menú solamente con dos opciones, para acceder a trabajar con Países y Atracciones. Indicamos el identificador del item del menú (ponemos nosotros los números), la descripción que mostrará y la invocación al objeto correspondiente utilizando el método Link. Para definir la segunda opción, copiamos y pegamos la estructura del grupo anidado. Y así podriamos seguir definiendo todas las opciones que deseemos mostrar en el menú.

5 Volvamos ahora al web panel para invocar a este Data Provider. En el evento Start, realizamos la invocación al Data Provider de forma tal que el mismo retorna su output en la variable &SlideMenuData (que fue creada automáticamente en el web panel al arrastrar el user control sobre el form).

6 Al ejecutar el web panel vemos el menú con las opciones definidas. Seleccionemos una de las opciones, se invoca al objeto correctamente, pero el menú desapareció.. Y si queremos que el menú esté siempre visible en todas las páginas de la aplicación?

7 El menú debería formar parte de la Master Page que se crea automáticamente con la KB. Vamos entonces a hacer que nuestro menú esté en el objeto AppMasterPage. Tenemos 2 opciones: 1) Declarar al web panel WPMenu (que contiene el user control Slide Menu + la invocación al Data Provider para cargarlo) como Component. Si observamos la propiedad Type del web panel WPMenu, vemos que un web panel puede ser una Master Page, una Web Page o un Component. Por defecto todo web panel es una Web Page y ya sabemos también lo que es una Master Page. Pero, qué significa definir que un Web Panel es un Component? Cuando declaramos que un web panel es un Component, estamos diciendo que dicho web panel podrá ser incluido dentro de otro objeto. Sigamos con nuestro ejemplo. AppMasterPage Observermos que en la AppMasterPage hay un control que dice ContentPlaceHolder. Se trata del contenedor de las páginas de la aplicación. Dicho en otras palabras, toda página de la aplicación (objeto GeneXus con form web) se cargará y mostrará dentro del control ContentPlaceHolder y es por eso es que siempre vemos el diseño de la Master Page en ejecución alrrededor y en el sector donde está ubicado el control ContentPlaceHolder, vemos nuestros objetos interactivos. Bien. Ahora queremos que siempre esté disponible el menú a la izquierda del control ContentPlaceHolder. Así que desde la Toolbox arrastramos un control WebComponent que será el encargado de contener y mostrar un objeto de la base de conocimiento que indiquemos (en este caso, el web panel que contiene el menú). En la propiedad Object de este control WebComponent, indicamos el nombre del objeto cuyo tipo es Component y el mismo será cargado dentro de dicho control. Así que completamos la propiedad Object=WPMenu. Presionando F5 podremos ver el resultado en ejecución. 2) En lugar de usar el web panel WPMenu, podríamos dejar de usarlo (eliminar el objeto de la KB) y arrastrar directamente el user control Slide Menu a la AppMasterPage, dentro de una celda a la izquierda del control ContentPlaceHolder. Así el menú estaría incluido directamente en la

8 AppMasterPage y no en un objeto incluido en la AppMasterPage haciendo el uso del concepto de Component. Solamente restaría invocar al Data Provider para cargar el menú en el evento Start del objeto AppMasterPage. 7

9 Ahora el menú forma parte del diseño de la master page, así que aparece cargado en todos los objetos.