Ejercicios prcticos

GeneXus X Ev.2

Curso GeneXus X Ev2: Ejercicios prcticos

Copyright Artech Consultores S. R. L. 1988-2012. Todos los derechos reservados. Este documento no puede ser reproducido en cualquier medio sin el consentimiento explcito de Artech Consultores S.R.L. La informacin contenida en este documento es para uso personal nicamente.

Marcas Registradas Artech y GeneXus son marcas o marcas registradas de Artech Consultores S.R.L. Todas las dems marcas mencionadas en este documento son propiedad de sus respectivos dueos.

Notas previas

Con este prctico el alumno podr familiarizarse con la herramienta, su ambiente, mens, barra de herramientas, etc., as como podr poner en prctica de una manera guiada y gradual los conceptos ms importantes. Dado que la finalidad de este curso es aprender la lgica de GeneXus, su esencia, independientemente de la plataforma en que la aplicacin vaya a implementarse, podra usted prototipar en cualquiera de las plataformas soportadas por GeneXus.

Pgina 1

Curso GeneXus X Ev2: Ejercicios prcticos

1. 2. 3.

EL PROBLEMA .......................................................................................................................................................... 3 NUEVO PROYECTO, NUEVA BASE DE CONOCIMIENTO ............................................................................................. 3 PRIMERAS TRANSACCIONES .................................................................................................................................... 3 TRANSACCIN CUSTOMER ......................................................................................................................................................... 4 TRANSACCIONES ATTRACTION Y COUNTRY, RELACIONADAS ........................................................................................................... 7 Datos relacionados: cmo se mantiene la integridad? ................................................................................................... 10 TRANSACCIN CATEGORY ......................................................................................................................................................... 11 AGREGUEMOS LAS CIUDADES A LA TRANSACCIN COUNTRY ............................................................................................................. 13 TRANSACCIN ATTRACTION: AGREGUEMOS LA CIUDAD. ................................................................................................................ 14

4. 5. 6.

AGREGUEMOS COMPORTAMIENTO A LAS TRANSACCIONES (RULES) .................................................................... 15 PATTERNS: MEJORANDO LA INTERFAZ PARA TRABAJAR CON LA INFORMACIN .................................................. 16 LISTADOS PDF........................................................................................................................................................ 20

7. VARIABLE DE TIPO DE DATOS ESTRUCTURADO, DATA PROVIDER PARA CARGARLA Y WEB PANEL PARA MOSTRARLA .................................................................................................................................................................... 22 8. 9. TRANSACCIN FLIGHT Y SUBTIPOS .................................................................................................................... 24 BUSINESS COMPONENTS ....................................................................................................................................... 25 AUMENTO DE PRECIO DE LOS VUELOS ............................................................................................................................................ 25 PANTALLA PARA ELIMINACIN DE TODOS LOS VUELOS ....................................................................................................................... 27 AGREGAR UN VUELO A TRAVS DE UN WEB PANEL [OPCIONAL] ........................................................................................................... 28 10. PROCEDIMIENTOS PARA ACTUALIZAR REGISTROS ................................................................................................ 30

AUMENTO DE PRECIOS DE LOS VUELOS .......................................................................................................................................... 30 ELIMINACIN DE TODOS LOS VUELOS ............................................................................................................................................. 30 INICIALIZACIN DE LA INFORMACIN DE LA BASE DE DATOS [OPCIONAL] ............................................................................................... 32 11. PASAJE DE PARMETROS ...................................................................................................................................... 33

LISTADO DE ATRACCIONES EN UN RANGO DETERMINADO ................................................................................................................... 34 OBTENER PDF CON INFO DE UN VUELO LUEGO DE INSERTADO............................................................................................................. 34 12. FRMULAS ............................................................................................................................................................ 36

Pgina 2

Curso GeneXus X Ev2: Ejercicios prcticos

1. El problema
Una agencia de viajes lo contrata para que desarrolle un sistema para almacenar y manipular la informacin con la que trabaja. Imagine que el sistema se compone de dos mdulos: Backend: parte de la aplicacin que deber correr en un servidor web, de manera tal que los empleados de la agencia puedan manipular la informacin desde cualquier lugar con conexin a internet. Es privada, por lo que deber tener seguridad. Frontend: parte de la aplicacin que implementar el sitio web de la agencia. Ser pblica, utilizada por cualquier persona que quiera consultar informacin de viajes, destinos, atracciones tursticas, etc.

En este prctico implementaremos solamente una parte de la solucin a este problema. Qu es lo primero que debemos hacer?

2. Nuevo proyecto, nueva base de

conocimiento
Entrar a GeneXus y crear una base de conocimiento de nombre TravelAgency para comenzar el desarrollo de la aplicacin. Sugerimos: Elegir como ambiente de desarrollo C#. Asegrese de tener instalado todo lo necesario (incluyendo SQL Server). No crear la base de conocimiento en la carpeta Mis Documentos o cualquier otra carpeta que quede bajo Documents and Settings, debido a que estas carpetas tienen permisos especiales otorgados por Windows.

Tmese unos minutos para familiarizarse con el IDE. Pruebe mover ventanas, personalizndolas a su gusto, visualizar ventanas (View y View/Other Tool Windows) y observe detenidamente el Folder View dentro de la ventana Knowledge Base Navigator. Ver que aparecen ya inicializados dominios, algunos objetos, imgenes, etc. Sugerencia: mantenga la ventana de propiedades abierta (F4), pues la utilizar continuamente. Dentro del Knowledge Base Navigator eche un vistazo a las Preferences donde se configura el Environment.

3. Primeras transacciones
En las reuniones con la agencia de viajes, le transmiten lo siguiente:

Nosotros registramos los datos de nuestros clientes, y a stos les ofrecemos viajes a distintas ciudades de distintos pases, de las que registramos tambin las atracciones tursticas.
Para empezar a construir la aplicacin, debemos empezar por identificar las entidades de la realidad, y representarlas mediante transacciones. Qu transacciones debemos crear entonces en la base de conocimiento (KB)?

Pgina 3

Curso GeneXus X Ev2: Ejercicios prcticos

Transaccin Customer
Le preguntamos a la agencia de viajes: qu registran de sus clientes? Sabiendo que la respuesta es:

El nombre (que no supera los 20 caracteres), apellido (que tampoco los supera), direccin, telfono y e-mail.
Ya puede crear la transaccin Customer.

Recordar que: Para crear objetos existen varias alternativas: o Hacerlo desde la Start Page. o Hacerlo desde el men: File/ New Object o Ctrl+N Address, Phone e Email son dominios semnticos que se estudiarn ms adelante. Necesitar un atributo que identifique a cada cliente (CustomerId) Digitando punto (.) cuando va a ingresar un nuevo atributo, ste se inicializa con el nombre de la transaccin.

La estructura de la transaccin debera haberle quedado como se muestra (al lado, su form Web):

Pruebe la aplicacin en ejecucin. F5. Qu suceder?

Solucin

Pgina 4

Curso GeneXus X Ev2: Ejercicios prcticos

Se le abrir una ventana como la siguiente para que ingrese la informacin de Base de Datos, Servidor y mtodo de conexin. Recuerde que si no existe una base de datos con ese nombre, en ese servidor, GeneXus la crea.

Al completar la informacin pedida, antes de cliquear Finish, asegrese de tener la ventana Output de GeneXus habilitada y a la vista. (View/Other Tool Windows /Output)

Se despliega un Anlisis de Impacto que le informa que se crear la base de datos y la tabla CUSTOMER dentro de la misma:

Pgina 5

Curso GeneXus X Ev2: Ejercicios prcticos

Si presiona el botn Create, GeneXus proceder a ejecutar el programa que llevar a cabo estas creaciones. Al finalizar el proceso, se le abrir en el navegador que tenga configurado como el predeterminado, el men con links para ejecutar los objetos definidos. En este caso slo uno: la transaccin Customer.

Ingrese algunos clientes al sistema. Modifique algn dato de alguno de los clientes previamente ingresados y elimine algn cliente. Tambin pruebe seleccionar un cliente de la lista de seleccin (entre los conos que aparecen sealados en la imagen que sigue, tiene la imagen de una lupa).

Pgina 6

Curso GeneXus X Ev2: Ejercicios prcticos Ahora pasemos a identificar y crear la siguiente transaccin. Recordemos lo que nos haban enunciado:

Nosotros registramos los datos de nuestros clientes, y a stos les ofrecemos viajes a distintas ciudades de distintos pases, de las que registramos tambin las atracciones tursticas.

Transacciones Attraction y Country, relacionadas

Ahora vamos a crear una transaccin para registrar las atracciones tursticas y una para registrar los pases a los que stas pertenecen. Qu informacin maneja de cada atraccin la agencia de viajes?

Nombre, pas, imagen de la atraccin, categora a la que pertenece.

Ya puede crear las transacciones. Empecemos por Country.

Recuerde que: presionando punto (.) cuando est por dar nombre a un atributo en la estructura de la transaccin, aparece inicializado con el nombre de la transaccin. necesitar un atributo identificador, CountryId.

Cuando est definiendo el tipo de datos del atributo identificador, en vez de utilizar directamente Numeric(4.0), defina el dominio Id con ese tipo de datos. Configure la propiedad Autonumber de ese dominio en True, para que todos los atributos basados en el mismo se numeren automticamente, sin que el usuario deba preocuparse.

Solucin

Pgina 7

Curso GeneXus X Ev2: Ejercicios prcticos

Observe todos los dominios que ya vienen predefinidos en GeneXus. En particular Address, Email y Phone que haban aparecido automticamente cuando cre los atributos CustomerAddress, CustomerEMail y CustomerPhone en la transaccin Customer.

Defina el atributo CountryName, con tipo de datos, un nuevo dominio: Name=Character(50).

Ahora, creemos la transaccin Attraction. Por ahora ingrese solamente identificador, nombre y pas.

Observe que al ingresar AttractionId, automticamente asume el dominio Id. Anlogamente, cuando ingrese el atributo AttractionName, asumir automticamente el dominio Name.

Por qu coloc adems de CountryId, el atributo CountryName en Attraction?

Pgina 8

Curso GeneXus X Ev2: Ejercicios prcticos Ejectue para probar. F5. Le aparecer el siguiente reporte de Anlisis de Impacto.

Por qu en la tabla Attraction que GeneXyus informa que se debe crear en la Base de Datos, no aparece el atributo CountryName? Es decir, por qu la tabla fsica no lo contendr, cuando s est en la estructura de la transaccin?

Despus de estudiar el reporte, si estamos de acuerdo, presionamos Reorganize para que efectivamente se lleve a cabo eso que se informa. Se abrir el navegador con el men con links a los 3 programas que corresponden a cada una de las transacciones (Customer, Country y Attraction). Ingresar como pases a: Brasil, Francia y China. Observar que dejando 0 como valor del identificador, al grabar se le asigna automticamente el nmero posterior al ltimo asignado (efectivamente, se est autonumerando).

Pgina 9

Curso GeneXus X Ev2: Ejercicios prcticos

Ingresar como atraccin turstica: Louvre Museum, que est en Francia. Si no recuerda el identificador de Francia en el sistema, cmo ingresa el pas?:

Recuerde que se le ofrece una Lista de seleccin de pases, creada automticamente por GeneXus, y ofrecida con un cono especial, al lado de CountryId. Esto es porque CountryId tiene el rol de llave fornea (foreign key) en esta transaccin (es decir, est apuntando a otra tabla).

Datos relacionados: cmo se mantiene la integridad?

Attraction y Country estn relacionados. Al colocar CountryId en la estructura de Attraction, estamos diciendo que el pas de la atraccin corresponde al de la tabla de pases. Observe que GeneXus mantiene automticamente la integridad de la informacin. As, por ejemplo: Intente ingresar una atraccin con un id de pas que no exista. Le permite grabar la atraccin turstica? Elija una atraccin previamente ingresada (por ejemplo, Louvre Museum) y cambie el pas, por uno que no exista. Pudo grabar la modificacin? Intente eliminar un pas (usando la transaccin Country) que tenga alguna atraccin asociada (por ejemplo Francia). Se lo permite?

Conclusin: los programas correspondientes a las transacciones aseguran la integridad de los datos.

Pgina 10

Curso GeneXus X Ev2: Ejercicios prcticos

Transaccin Category
Nos falta completar la informacin de la transaccin Attraction. A usted le han dicho que registran de cada atraccin turstica, la categora (monumento, museo, parque, etc.) a la que pertenece. As que necesitaremos crear una transaccin para registrar esta informacin, y agregar la categora a la transaccin Attraction. Pero adems, le han informado que no es obligatorio conocer la categora de atraccin a la que pertenece una atraccin dada que se est manipulando. Se puede dejar vaca. Si sabemos que GeneXus controla automticamente la integridad, cmo lo conseguimos?

Solucin:

Para terminar la transaccin Attraction, agreguemos el dato que nos est faltando: la foto. Para ello, cree el atributo AttractionPhoto de tipo de datos Image. Pdale a GeneXus que construya la aplicacin, as puede probarla en ejecucin. (F5)

Observe lo que le informa el reporte de Anlisis de Impacto. Deber crearse la tabla Category, y convertirse la tabla Attraction ya existente, agregando tres elementos de informacin (uno por el atributo CategoryId y dos por el atributo AttractionPhoto. No se preocupe en entender por qu requiere almacenar dos valores por imagen).

Pgina 11

Curso GeneXus X Ev2: Ejercicios prcticos

Reorganice y ejecute. Ingrese categoras (como museo y monumento) y acceda a las atracciones tursticas ya ingresadas para completar su informacin (categora y foto). Observe que en este caso puede dejar la categora vaca (debido a que puso la propiedad Nullable en Yes en la estructura de la transaccin). Sin embargo, si intenta poner como valor de CategoryId para la atraccin turstica un valor inexistente, no le dejar grabar.

Pgina 12

Curso GeneXus X Ev2: Ejercicios prcticos

Agreguemos las ciudades a la transaccin Country

Adems de los pases con los que trabaja la agencia de viajes, necesitamos registrar la informacin de sus ciudades. Por tanto, debemos agregar un segundo nivel a la transaccin Country, con el identificador y el nombre de ciudad.

Recuerde que: posicionado en CountryName con botn derecho / Insert Level agrega el subnivel. Una vez que le d un nombre al nuevo nivel, digitando comillas () en lugar de punto, el atributo que defina se inicializar con el nombre del nivel. Las ciudades se identificarn por su propio id en combinacin con el del pas. Es decir, no podr identificar a una ciudad sin brindar antes la informacin del pas del que se trata. As, podra haber una ciudad 1 Rosario tanto para Uruguay como para Argentina: Pas: 1 (Uruguay) Ciudad: 1 (Rosario) Pas: 2 (Argentina) Ciudad: 1 (Rosario) O incluso podra ser que Rosario para Argentina se identificara con otro nmero: Pas: 2 (Argentina) Ciudad: 4 (Rosario)

Reorganice y ejecute (F5).

Pgina 13

Curso GeneXus X Ev2: Ejercicios prcticos

Observe que el Listado de Navegacin le informar que: la propiedad autonumber para el caso de CityId ser ignorada. Esto significa que en ejecucin el usuario deber ingresar manualmente los identificadores de ciudad. La explicacin ser tratada ms adelante. Se crear una nueva tabla CountryCity para almacenar la informacin correspondiente a las ciudades.

Ingrese ciudades para los pases que ya tena registrados.

Transaccin Attraction: agreguemos la ciudad.

Completemos la transaccin Attraction agregando la ciudad del pas a la que la atraccin pertenece. Qu debe hacer si la agencia de viajes nos informa que ese valor puede no ser conocido o relevante para una atraccin dada en un momento dado?

Construya la aplicacin y prubela (F5 y Reorganize).

Pgina 14

Curso GeneXus X Ev2: Ejercicios prcticos

Solucin

Antes de seguir, abra la transaccin Customer y modifique el tipo de datos de CustomerId para que tenga dominio Id (y, as, se autonumere). Tambin modifique los tipos de datos de CustomerName y CustomerLastName para que pasen a asumir el dominio Name. Reorganice.

4. Agreguemos comportamiento a las

transacciones (rules)
Despus de probar con nosotros la aplicacin que venimos desarrollando, en la agencia de viajes nos cuentan que para los clientes hay algn comportamiento especfico que debemos hacer cumplir a la hora de manipular la informacin a travs del programa (transaccin Customer). Cul es este comportamiento? Nos dicen:

El sistema no debe permitir ingresar clientes sin nombre, ni sin apellido. Debe advertirse al usuario si est dejando el telfono sin asignar, por si fue un descuido. Se debe registrar la fecha de ingreso del cliente al sistema (CustomerAddedDate) y se debe proponer como valor predeterminado para ese atributo, la fecha de hoy.

Especifique ese comportamiento y prubelo (F5 y Reorganize).

Recuerde que: Las reglas finalizan con punto y coma ;. El mtodo IsEmpty() aplicado a un atributo devuelve True cuando el atributo est vaco y False en caso contrario. La variable &today es del sistema y tiene cargado el valor de la fecha del da. Para escribir una variable dentro de la pantalla Rules, cuando tipea & se le despliegan todas las variables definidas hasta el momento para que seleccione la que necesita. La otra posibilidad es utilizar Insert / Variable

Pgina 15

Curso GeneXus X Ev2: Ejercicios prcticos

Pruebe ingresar un nuevo cliente dejando vaco el nombre. Le permite grabar o pasar al siguiente campo? dem con el apellido. Sucede lo mismo con el telfono?

Si luego le informan que la fecha de ingreso al sistema no debera ser manipulada por el usuario, sino nicamente visualizada, cmo establece este comportamiento? Especifquelo y prubelo en ejecucin.

5. Patterns: mejorando la interfaz para

trabajar con la informacin

Al mostrarle al cliente lo realizado hasta ahora, nos dice que quisiera poder manipular la informacin de pases, categoras y atracciones tursticas de un modo ms vistoso. Para ello deber aplicar los patrones Work With a las tres transacciones. Prubelo y valo en ejecucin.

Observar que: existe un Work With para Smart Devices, tambin. Pero el que usted deber aplicar es el que corresponde a la aplicacin web que est constuyendo. GeneXus crear automticamente varios objetos por transaccin, para implementar el Trabajar con esa entidad.

Solucin

Pgina 16

Curso GeneXus X Ev2: Ejercicios prcticos

Por qu no aparecen ms en el Developer Menu las transacciones Category, Country y Attraction?:

Pruebe: 1. Ingresar un nuevo pas. 2. Modificar un pas existente (por ejemplo, agregndole una ciudad) 3. Eliminar un pas existente Pgina 17

Curso GeneXus X Ev2: Ejercicios prcticos 4. Visualizar la informacin de un pas. 5. Realizar una bsqueda por nombre de pas.

6. Ingrese un par de atracciones tursticas (Ej: La muralla China, de China/Beijing, Eiffel Tower de Francia/Pars) 7. Filtre las atracciones tursticas cuyo nombre empiece con F. Y si ahora quiere poder visualizar todas las atracciones tursticas de Francia? No est incluida esta posibilidad, por lo que deberemos personalizar el pattern work with de esta transaccin, para agregrsela. Hgalo en GeneXus y pruebe en ejecucin.

Solucin
Para ello primero observe cmo est especificado el filtro que s existe, por nombre de la atraccin turstica:

8. Ahora quite los identificadores de pas y ciudad de la pantalla del Work With y prubelo en ejecucin. Pgina 18

Curso GeneXus X Ev2: Ejercicios prcticos

9. Si ahora quiere brindar la posibilidad de que el usuario elija si quiere ver las atracciones ordenadas por nombre de la atraccin o por nombre de pas, implemntelo y pruebe.

Pgina 19

Curso GeneXus X Ev2: Ejercicios prcticos

6. Listados pdf
Ahora supongamos que como parte de la aplicacin, deber implementarse la posibilidad de que a pedido del usuario, se le desplieguen listados pdf con la informacin requerida. Por ejemplo, suponga que se necesita un listado que muestre en orden alfabtico, las atracciones tursticas almacenadas en la base de datos. Si sabe que debe lucir ms o menos como sigue:

Implemntelo en GeneXus.
Recordar que para poder visualizar directamente desde el browser un listado, el mismo debe ser generado como PDF. Para esto debe configurar las siguientes propiedades del objeto procedimiento: Main program = True Call Protocol = http Report output = Only to File Y la siguiente regla: Output_file(nombre-archivo.pdf , PDF) Para ejecutar el listado, sobre la pestaa del objeto, botn derecho / Run with this only

Repar en lo que le informa el listado de navegacin del procedimiento?

Y si ahora se necesita que el listado salga ordenado por nombre de pas? Implemntelo, observe lo informado en el listado de navegacin y prubelo. Y si ahora necesita solamente listas las atracciones de Francia? Prubelo (observando listado de navegacin)

Pgina 20

Curso GeneXus X Ev2: Ejercicios prcticos

En cada caso, deduzca qu tabla de la base de datos se est recorriendo para realizar la consulta del for each.

Tambin se necesita un listado como el que sigue (que muestre cada categora, y por cada una de ellas, sus atracciones tursticas). Implemntelo y pruebe lo realizado.

Pgina 21

Curso GeneXus X Ev2: Ejercicios prcticos

7. Variable de Tipo de datos estructurado,

Data Provider para cargarla y Web Panel para mostrarla

Se va a necesitar mostrar en pantalla las categoras de atracciones tursticas, mostrando de cada una: nombre de la categora y cantidad de atracciones tursticas de esa categora y ese pas, como se ve a continuacin:

Como an no aprendimos cmo realizar un clculo, deje el nmero de atracciones tursticas con un valor predefinido (por ejemplo vaco). Ms adelante, volveremos sobre este punto, para completarlo.

Recuerde que: El objeto Web Panel le permite disear pantallas para mltiples usos Cada objeto GeneXus puede definir variables que sern espacios de memoria reservados dentro del objeto, para mantener temporalmente ciertos valores, mientras el objeto se est ejecutando (y que luego se desechan). Las variables son un nombre que se da a un espacio de memoria que se reserva. Para reservar ese espacio, debe especificarse su tipo de datos. Un caso particular, es cuando una variable no es de un tipo de datos simple, sino estructurado (all debern reservarse varias posiciones de memoria, para almacenar cada uno de los elementos del tipo de datos). Los tipos de datos estructurados pueden ser colecciones de tipos de datos. Los Data Providers se utilizan para cargar variables de tipos de datos estructurados (o business components, como se ver luego, que tambin son estructurados).

Intente implementar lo anterior por su cuenta, sin mirar lo que sigue. Solucin

Pgina 22

Curso GeneXus X Ev2: Ejercicios prcticos

Una posible solucin: crear un tipo de datos estructurado que represente una coleccin de categoras con la informacin que se necesita (nombre de categora y cantidad de atracciones tursticas correspondientes).

Y luego un Data Provider que permita cargar una variable de ese tipo, obteniendo el nombre de categora de la base de datos. Para especificar su Source, recuerde que lo ms fcil es arrastrar el SDT del Folder View y soltarlo en la pantalla Source. As solamente tendr que rellenar lo que se muestra en verde.

Por ahora dejaremos vaco el valor de CategoryAttractions. Observemos que en la propiedad Output, aparece el SDT que es coleccin, por lo que la propiedad Collection est en False (si se pusiera en True, el resultado sera una coleccin de colecciones).

Luego cree el Web Panel, definiendo la variable &categories del tipo de datos del SDT anterior e insrtela en el Form. Le ofrecer insertarla dentro de un control Grid. Deber cargarla, cmo? En el evento Start, invocando al Data Provider anterior.

Pgina 23

Curso GeneXus X Ev2: Ejercicios prcticos

Event Start &categories = GetCategories() EndEvent

8. Transaccin Flight y subtipos

Se necesita ahora registrar los vuelos de la agencia de viajes. Un vuelo tiene un identificador y va de un pas y ciudad origen a un pas y ciudad destino, y tiene un precio. Cree la transaccin para almacenar esta informacin. Para el Precio cree un dominio Numeric(10.0) Por qu no puede utilizar directamente los atributos CountryId, CountryName, CityId y CityName?

Recuerde que en la estructura de la transaccin: un cono representando una flecha hacia arriba informa que el atributo es clave fornea (Foreign Key), es decir que apunta a otra tabla. Un cono representado una flecha hacia abajo informa que el atributo es inferido de otra tabla. Un cono representando una indica que el atributo es un subitpo

Ejecute y verifique que al intentar ingresar un vuelo, se dispare un error si el pas de partida que est queriendo asignarle al vuelo no existe, o si la ciudad no existe. dem cuando el pas o la ciudad son las de arribo. No debe permitirse ingresar un vuelo cuyo pas y ciudad de partida coincidan con el pas y ciudad de arribo. Implemente ese comportamiento y prubelo en ejecucin.

Solucin

error( 'Arrival country/City could not be the same than Departure country/city') if FlightDepartureCountryId = FlightArrivalCountryId and FlightDepartureCityId=FlightArrivalCityId;

Pgina 24

Curso GeneXus X Ev2: Ejercicios prcticos

9. Business Components
Realizaremos algunas operaciones sobre la base de datos, a travs de business components.

Aumento de precio de los vuelos

Cada tanto la agencia de viajes necesita incrementar los precios de los vuelos en un porcentaje determinado. Para ello, deberemos implementar una pantalla que permita al usuario especificar ese porcentaje de aumento, y dar la orden de aplicarlo a todos los vuelos de la base de datos. Implemntelo y pruebe.
Recuerde que: El objeto web panel le permite implementar pantallas flexibles para entrada y salida de informacin. Para entrada de informacin (que el usuario pueda ingresar valores a la pantalla), se insertan controles variable en el form. Si quiere editar barras de men, posicionndose en GeneXus arriba, sobre la barra, con botn derecho podr insertar, por ejemplo, la barra Formatting. Para que el web panel tome alguna accin determinada, pueden insertarse botones y programar el evento asociado. Los business components son tipos de datos que se crean al marcar la propiedad correspondiente del objeto transaccin. Al hacerlo, para insertar, modificar o eliminar registros de las tablas correspondientes, podr utilizarse, adems de la transaccin, una variable de tipo de datos Business Component en cualquier otro objeto (por ejemplo, un web panel) y realizar las mismas operaciones a travs de los mtodos Load(), Save() y Delete(). Para que las operaciones realizadas a travs del business component queden efectuadas de manera permanente, deber ejecutar a continuacin el comando Commit. Si a un valor X se le quiere incrementar un 20%, alcanza con hacer X = X*(1+20/100) = X*1,20

Solucin
Una solucin posible (intente implementar ud. lo pedido sin mirar lo que sigue): creamos un Web panel, con una variable &percentage, de tipo de datos: Numeric(3.0)

Al hacer doble clic sobre el botn, nos lleva a la seccin Events, editando el evento Enter, asociado al mismo. All programaremos la lgica que queremos se ejecute cuando el usuario presione el botn. Necesitamos recorrer todos los vuelos y sobreescribir el precio que tenan, aumentndolo en ese porcentaje indicado por el usuario en la variable de pantalla.

Pgina 25

Curso GeneXus X Ev2: Ejercicios prcticos

Para recorrer todos los vuelos de la base de datos, usamos el comando for each. Y para cada vuelo, cmo lo editamos para modificarle el valor de FlightPrice? Necesitaremos una variable para ello, que tenga toda la estructura de la transaccin Flight, y adems nos permita grabar en la base de datos. Qu tipo de datos tendr, entonces, esa variable? El business component Flight (observar que el tipo de datos business component tiene el mismo nombre que la transaccin). Pero GeneXus no crea ese tipo de datos automticamente para cada transaccin. Se lo tenemos que pedir. Cmo lo hacamos? Prendiendo la propiedad correspondiente de la transaccin. Una vez hecho esto, entonces:

Event Enter for each &flight.Load(FlightId) &flight.FlightPrice = &flight.FlightPrice*(1+&percentage/100) &flight.Save() ... endfor EndEvent
Recuerde que al hacer: &flight.Load(1) se cargar en la variable &flight (que tiene una estructura compuesta), toda la informacin del registro de la tabla Flight de la base de datos, correspondiente al Id de vuelo, 1:

Por tanto, al hacer &flight.Load(1), si deseamos cambiar la ciudad de partida por la 4, y dejar todos los dems datos tal y como estaban, alcanzar con hacer: &flight.FlightDepartureCityId = 4 Pero si luego no pedimos que grabe estas modficaciones, se habrn hecho slo en memoria, pero no en el registro de la base de datos. Para efectivamente grabar el cambio, debemos agregar el mtodo Save: &flight.Save() Ahora, qu suceder si no existe el identificador de ciudad 4 para el pas 2? Al igual que en la transaccin, se controla la integridad de la informacin relacionada, y en ese caso un error impedir que se grabe en la base de datos. Como las operaciones de grabacin o eliminacin de la base de datos (a travs de los mtodos Save() y Delete()) pueden provocar errores, es importante saber qu ocurri. Para ello tenemos el mtodo Success() que devolver True si no hubo errores, y False en caso contrario.

Event Enter for each &flight.Load(FlightId) &flight.FlightPrice = &flight.FlightPrice*(1+&percentage/100) &flight.Save()

Pgina 26

Curso GeneXus X Ev2: Ejercicios prcticos If &flight.Success() Commit else Rollback endif endfor EndEvent

Al insertar, modificar o eliminar registros de una tabla de la base de datos, mientras que no se diga: todo lo hecho que quede permanente, esas modificaciones sern provisorias. Qu quiere decir? Que por ejemplo, si hay un apagn, esas modificaciones se perdern. La forma de decir lo hecho, que quede permanente es ejecutar el comando Commit. Si por el contrario, queremos que lo que hicimos se deshaga, ejecutamos el comando Rollback.

Pantalla para eliminacin de todos los vuelos

Grabe el web panel anterior con otro nombre (para ello alcanza con posicionarse sobre la pestaa y con botn derecho, hacer Save as) y modifique el Form para que slo contenga un botn con el texto Delete all flights, de modo que en ejecucin este web panel se vea as:

Cuando el usuario presione el botn, debern eliminarse todos los vuelos de la base de datos. Qu debe modificar del evento Enter que tena programado?
Nota: si se posiciona sobre el botn y ve sus propiedades, en la de nombre Caption puede modificar el texto del botn.

Solucin
Alcanzar con :

Event Enter for each &flight.Load(FlightId) &flight.Delete() if &flight.Success() Commit Msg( 'Successful deletion') else

Pgina 27

Curso GeneXus X Ev2: Ejercicios prcticos Msg( 'Delection could not be done') Rollback endif endfor EndEvent
Con Msg lograr que se despliegue ese mensaje en la pantalla del web panel.

Agregar un vuelo a travs de un web panel [opcional]

Con la idea de ms adelante implementar un wizard para el ingreso de un vuelo (es decir, a travs de distintas pantallas que vayan guiando al usuario): nuevo vuelo en la base de datos.

por ahora lo haremos en un solo paso. Es decir, crearemos un web panel para que el usuario ingrese los valores necesarios en una sola pantalla y al presionar el botn Confirm, grabar el vuelo en la base de datos.

Implemntelo en GeneXus y pruebe en ejecucin. Asegrese que al presionar Confirm el vuelo haya quedado efectivamente insertado en la tabla correspondiente de la base de datos. Vea qu sucede si deja el mismo pas y ciudad de partida que de arribo.

Pgina 28

Curso GeneXus X Ev2: Ejercicios prcticos

Solucin
Creamos un Web panel, con una variable &flight del tipo de datos el business component Flight. Insertamos la variable en el form (solamente para los valores que necesitamos ingrese el usuario: es decir, los que no son inferidos ni autonumerados).

Observe que podemos modificar las propiedades de un control variable para que en lugar de ser un simple campo de edicin, sea un combo que ofrezca valores de una tabla de la base de datos. As, viendo las propiedades del control &flight.FlightDepartureCountryId, cambiamos la Control Type de Edit a Dynamic Combo Box y la propiedad ItemDescriptions como mostramos:

Luego, en el evento asociado al botn programamos:

Event Enter &flight.Save() if &flight.Success() Commit msg( 'The flight was successfuly added') else Rollback msg( 'Error: the flight could not be added') endif EndEvent

Pgina 29

Curso GeneXus X Ev2: Ejercicios prcticos

10. Procedimientos para actualizar registros

Aumento de precios de los vuelos
Suponga que los vuelos a los que debe aumentar el precio en un porcentaje dado (vuelva al primer ejercicio del punto 9 del prctico) son miles. Sabiendo que el aumento de precio es un procedimiento sencillo que no har fallar la integridad de ningn modo, hgalo con un procedimiento, sin utilizar business components.

Recuerde que: Con el comando for each dentro de un procedimiento, puede actualizar los atributos de su tabla extendida a travs de simples asignaciones. La actualizacin directa a travs de procedimientos no controla la integridad de la informacin. Todo objeto debe declarar los parmetros que recibe y los parmetros que devuelve. Si no los declara, ni recibir ni devolver valores. Los parmetros se declaran a travs de la regla parm. Las variables son locales al objeto donde se utilizan. Esto significa que si quiero recibir un valor como parmetro en una variable &X, debo declararla en el objeto.

Eliminacin de todos los vuelos

Y si ahora quisiera eliminar todos los vuelos, tal como lo hizo en el punto 9 del prctico, pero a travs de un procedimiento?

Solucin
Crear un procedimiento FlightsDeletion que no recibe parmetros, con el siguiente cdigo:

for each defined by FlightPrice Delete endfor

Haga un Save as del web panel que tena implementado en el punto 9 (el que haca la eliminacin a travs de Business Component), y cambie el evento Enter:

Event Enter FlightsDeletion() EndEvent

Y si ahora quiere borrar toda la informacin de la base de datos?

Solucin

Pgina 30

Curso GeneXus X Ev2: Ejercicios prcticos

Crear un procedimiento DeleteAll con Source:

for each defined by CustomerName delete endfor for each defined by FlightPrice delete endfor for each defined by AttractionName delete endfor for each defined by CategoryName delete endfor for each defined by CountryName for each defined by CityName delete endfor delete endfor

Y cambiar el web panel anterior (sabe as), agregndole un botn, al que le asociaremos un evento de usuario. Para ello, editando las propiedades del botn , en OnClickEvent elegimos <new> y le damos el nombre que queramos:

Pgina 31

Curso GeneXus X Ev2: Ejercicios prcticos

Luego haciendo botn derecho sobre el botn: Go To Event y programamos la invocacin al procedimiento.

Inicializacin de la informacin de la base de datos [opcional]

Cuando la aplicacin que usted est desarrollando se ponga en produccin (es decir, empiece a ser utilizada por la agencia de viajes) debern cargarse todos los datos de clientes, pases, categoras, atracciones, vuelos. Escriba un procedimiento que inicialice esas tablas con informacin que nos ha brindado la agencia de viajes y prubelo.

Tener en cuenta que: El comando new ingresa un registro en una tabla fsica. Si no asigna valor a un atributo de la tabla, entonces: o Si el atributo es autonumerado, al grabarse el registro en la base de datos (al alcanzarse el endnew), en memoria quedar para ese atributo el valor dado por la base de datos al mismo. Por ejemplo, si se est grabando una categora: New CategoryName = Monument Endnew Sabemos que luego del Endnew si utilizamos el atributo CategoryId ste tendr el valor que la base de datos le dio al registro al ingresarlo.

Solucin

Crear un procedimiento DBInitialize con el Source que sigue e invocarlo desde un web panel:

new CustomerName = 'John' CustomerLastName = 'Cage' CustomerEMail = 'jcage@gmail.com' CustomerAddress = '11235 NE 4 Ave, Miami' endnew //Brazil

Pgina 32

Curso GeneXus X Ev2: Ejercicios prcticos new CountryName = 'Brazil' endnew new CountryId = CountryId CityId = 1 CityName = 'Rio de Janeiro' endnew //France new CountryName = 'France' endnew new CountryId = CountryId CityId = 1 CityName = 'Paris' endnew new CategoryName = 'Monument' endnew new AttractionName = 'Eiffel Tower' CountryId = CountryId CityId = CityId CategoryId = CategoryId AttractionPhoto = EiffelTower.Link() endnew new CountryId = CountryId CityId = 2 CityName = 'Niza' endnew //China new CountryName = 'China' endnew new CountryId = CountryId CityId = 1 CityName = 'Beijing' endnew new CountryId = CountryId CityId = 2 CityName = 'Shangai' endnew

11. Pasaje de parmetros

Muchas veces necesitamos que un objeto reciba parmetros para, en base a los mismos, ejecute su lgica. Por ejemplo, una cosa es realizar un listado pdf de todas las atracciones tursticas de la base de datos, y otra es realizar un listado de aquellas cuyo nombre se encuentra dentro de un rango dado.

Pgina 33

Curso GeneXus X Ev2: Ejercicios prcticos

Listado de atracciones en un rango determinado

Grabe con otro nombre el procedimiento que haba creado en el punto 6 para listar las atracciones tursticas, y modifquelo para que ahora solamente liste aquellas cuyo nombre se encuentra dentro de un rango recibo por parmetro (el valor inicial y el final del rango sern los parmetros recibidos). Implemente una pantalla que pida los valores de ese rango al usuario, e invoque a este objeto, pasndole esos valores por parmetro. Pruebe en ejecucin.

Recuerde que: Si define una variable basada en (based on) un atributo, quedar ligada al tipo de datos del atributo, es decir, si ste se modifica, el de la variable tambin, acorde al cambio. Las variables utilizadas para realizar una invocacin en el objeto que llama y las utilizadas para declarar los parmetros que se reciben en el objeto llamado, no tienen por qu coincidir en nombre, pero s deben tener tipos de datos compatibles.

Solucin:
Al procedimiento (llammosle AttractionsFromTo le agregamos la regla parm (y definimos ambas variables en el procedimiento):

parm( in: &fromName, in: &toName );

Y en su Source:

print Title print ColumnTitles for each where AttractionName>= &fromName where AttractionName <= &toName print Attractions endfor

Y luego creamos un web panel, en el que definimos dos variables, que pueden llamarse de cualquier manera, por ejemplo A y B, pero que deben tener como tipo de datos uno compatible con el de las variables &fromName y &toName. Por qu? Porque ser en estas variables que el usuario ingresar valores que en el evento que programemos sern enviadas por parmetro al procedimiento, as: AttractionsFromTo( &A, &B)

Obtener Pdf con info de un vuelo luego de insertado

En el ltimo ejercicio, opcional, del punto 9 haba creado un web panel que luego se transformar en un wizard, para ingresar un nuevo vuelo a la base de datos. Suponga que luego de insertado, se desea listar la informacin completa del vuelo, como un archivo pdf. Implemntelo y pruebe.

Pgina 34

Curso GeneXus X Ev2: Ejercicios prcticos

Recuerde que: Cuando en un objeto se declara como uno de los parmetros un atributo, en lugar de una variable, se est especificando algo ms fuerte: que en todos los lugares dentro del objeto donde se use ese atributo, se supondr que su valor est fijado: ser el que se recibi por parmetro al invocarse al objeto. o Ej: si en un reporte ListCustomer se tiene: parm( CustomerId ) y en el Source: For each Print CustomerPB //printblock con atributos de tabla CUSTOMER Endfor Y se invoca a este reporte: ListCustomer( 3 ) Se listar solamente la informacin del cliente cuyo Id es 3. En cambio si se hubiera declarado en la regla parm( &CustomerId ), una variable, con el mismo Source anterior (es decir, sin utilizar la variable), entonces ante la misma invocacin, se listar esta vez la informacin de todos los clientes, no slo el 3.

Solucin:
Creamos un reporte FlightInfoList con las reglas:

Parm( in: FlightId ); Output_file( 'FlightInfo.pdf', 'pdf');

Con el Source:

for each print flightPB //FlightId, FlightDepartureCountryId, //FlightDepartureCountryName, //FlightDepartureCityId, FlightDepartureCityName, FlightPrice endfor

Y en el evento del web panel, agregamos al final la invocacin al procedimiento:

Event Enter &flight.Save() if &flight.Success() Commit msg( 'The flight was successfuly added') else Rollback msg( 'Error: the flight could not be added') Pgina 35

Curso GeneXus X Ev2: Ejercicios prcticos endif FlightInfoList( &flight.FlightId ) EndEvent

12. Frmulas
Ahora estamos en condiciones de completar el web panel que implementamos en el punto 7. Calcule la cantidad de atracciones correspondientes a la categora que se est cargando.

Solucin:
En el Source del Data Provider especificamos la frmula local Count:

Categories { CategoriesItem { Category = CategoryName CategoryAttractions = count( AttractionName) } }

Pgina 36