Comando For Each simple y For Each anidado para listar info relacionada

Transcripción

1 Comando For Each simple y For Each anidado para listar info relacionada En otro video hemos visto cómo definir un procedimiento, el cual contenía en su source un único comando For each, que accedía a los datos de una tabla base y su tabla extendida. Ahora supongamos que la agencia de viajes nos solicita un listado que muestre todas las categorías de atracciones y para cada categoría, la lista de atracciones turísticas que hay ingresadas Pero antes de resolver este requerimiento, vamos a ejecutar la aplicación para agregar un par de atracciones turísticas. Presionamos F5 Ejecutamos la opción Work with Attraction Page1

2 Y vamos a ingresar una nueva atracción Vamos a ingresar al Cristo Redentor, que está en Brasil, en la ciudad de Rio de Janeiro, Así que escribimos Christ the Redemmer Seleccionamos Brasil La categoría que es Monument.. Su imagen Y la ciudad que es Rio de Janeiro Ahora vamos a ingresar otra atracción turística que será el Instituto Smithsoniano. Ponemos Smithsonian Institute Que se encuentra en Estados Unidos Es un museo así que cargamos la categoría Museum.. Cargamos su imagen Y la ciudad que es Washington Page2

3 Ahora sí, pasemos a definir el listado que nos solicitan. Creamos un nuevo objeto de tipo procedimiento. Y ponemos como nombre CategoriesAttractionsReport Ahora volvamos a observar lo que queremos ver en el listado Page3

4 Queremos mostrar cada categoría ingresada y para cada categoría, todas las atracciones que pertenecen a dicha categoría. Observemos que tenemos que mostrar 3 contenidos fijos y 2 contenidos con datos que debemos extraer de la base de datos Page4

5 Vamos a empezar entonces por definir el layout del procedimiento basándonos en esto que nos pidieron ver, y luego veremos cómo codificar el source Vamos a la sección del Layout Y utilizaremos este printblock ya creado para agregar el título del listado. Así que desde la Toolboc, arrastramos un control Rectangle Ajustamos el tamaño Page5

6 Y en su propiedad Back color elegimos el color que queremos para el fondo.. Luego volvemos a la Toolbox.. Arrastramos un TextBlock y en su propiedad Text escribimos Categories and Attractions Report. Cambiamos la fuente.. y ponemos el estilo negrita y cursiva. Ajustamos los tamaños, y al printblock le ponemos como nombre: Title Ahora vamos a agregar otro printblock para mostrar cada nombre de categoría Page6

7 A este printblock le ponemos como nombre: Categories Y desde la Toolbox, arrastramos un control de tipo textblock. Y en su propiedad Text, ponemos Category Al lado de este control vamos a arrastrar otro control de tipo atributo/variable Page7

8 Y seleccionamos el atributo CategoryName Ajustamos el tamaño del printblock Insertamos otro printblock que tendrá como nombre AttractionsColumnTitles Page8

9 y le agregamos un textblock que tendrá en su propiedad Text el texto Attraction name. En otro printblock agregamos el texto Country name Page9

10 y finalmente desde la Toolbox, una línea debajo. Por último insertamos otro printblock Le ponemos como nombre Attractions e incluimos los atributos AttractionName y CountryName Page10

11 Ahora pasemos al Source. Escribamos la primera instrucción para imprimir el título del listado: Y ahora detengámonos a ver cómo seguimos Como tenemos que navegar las categorías Page11

12 y para cada una de ellas, navegar varias atracciones que pertenecen a dicha categoría este listado es diferente del que hemos resuelto anteriormente. En el listado anterior como hemos visto, navegábamos las atracciones y dado que cada atracción tiene 1 sólo país, podíamos recuperar el nombre del país de cada atracción, por estar en la tabla extendida de la tabla base que estábamos navegando. Veamos ahora lo siguiente: Siempre que la información que queremos recuperar está disponible en la tabla extendida de la tabla base que estamos navegando, entonces Page12

13 la podemos referenciar directamente en el mismo For each. En cambio si estamos navegando una tabla y necesitamos para cada registro accedido, navegar varios registros relacionados que están en otra tabla, y esta tabla no pertenece a la tabla extendida de la tabla que estamos navegando, entonces necesitaremos escribir otro For each dentro del primero, para recorrer el conjunto de registros relacionados. Volvamos entonces al source de nuestro procedimiento, y comencemos a escribir un 1er For each, para navegar y mostrar las categorías Al lado del For each escribimos Category Page13

14 Y recordemos que la tabla base es el nombre de la transacción, cuya tabla física asociada queremos navegar. Dentro del For each entonces, ponemos: Print Categories Y como el printblock Categories solamente tiene incluido el atributo CategoryName, GeneXus va a entender que la tabla base de ese For each será CATEGORY. Dentro de este For each que navega las categorías, luego de mostrada una categoría, queremos navegar el conjunto de atracciones pertenecientes a dicha categoría por lo tanto necesitamos escribir el 2do For each que mencionábamos, para recorrer el conjunto de atracciones pertenecientes a la categoría que estamos navegando. Pero justo antes de navegar el conjunto de atracciones de la categoría, tendremos que mostrar los títulos que encabezarán a estas atracciones que vamos a mostrar, así que escribamos la instrucción Print AttractionsColumTitles Y ahora sí escribamos el 2do For each, dentro del cuerpo del 1ero A continuación escribimos Attraction, por ser el nombre de la transacción cuya tabla base queremos navegar ahora, y dentro del For each, Print Attractions Luego, Endfor para cerrar esta navegación y otra vez Endfor para cerrar la primera. Recordemos que para que salga el listado con formato PDF, tenemos que configurar la propiedades del reporte Main program con el valor True Call protocol como HTTP Page14

15 y tenemos que insertar la regla OutputFile Completamos el nombre del archivo y el formato PDF. Salvamos Y vamos a ejecutar a este listado haciendo click con el botón derecho y seleccionando Run Page15

16 Observamos que se listaron todas las categorías que habíamos ingresado y para cada una de ellas se listaron las atracciones que pertenecen a dicha categoría! Page16

17 O sea, exactamente lo que nos habían pedido! Ahora bien, cómo supo GeneXus cuáles atracciones debía mostrar para cada categoría si nosotros no le agregamos a nuestro source ninguna condición explícita que indique algo al respecto? Si bien escribimos un For Each que navega las atracciones, no agregamos en ningún lado una cláusula where, para filtrar aquellas atracciones que cumplan con la condición de que coincida el valor del identificador de la categoría, con el de la categoría que estamos listando. Entonces cómo hizo GeneXus para que al momento de navegar la tabla ATTRACTION donde están almacenadas todas las atracciones, recuperarnos para cada categoría, solamente aquellas que pertenecían a dicha categoría? La respuesta está en la forma en que escribimos los For Each Page17

18 Si 2 comandos For each se escriben uno a continuación del otro, entonces son independientes entre sí En cambio si escribimos un For each dentro de otro Page18

19 es porque para cada registro de la primera navegación, queremos recorrer un conjunto de registros Cuando escribimos comandos For Each anidados Page19

20 GeneXus determina para cada For each, la tabla base que navegará y luego busca si existe alguna relación entre dichas tablas base. En nuestro caso, la tabla base del For each externo es CATEGORY y la tabla base del For each interno es ATTRACTION y GeneXus tiene el conocimiento de que hay un atributo en común entre ambas tablas: Este atributo común es CategoryId, que es llave primaria en CATEGORY y llave foránea en ATTRACTION De modo que el atributo CategoryId hace que se relacionen las tablas ATTRACTION y Page20

21 CATEGORY, como vemos aquí en el diagrama, en una relación 1 a N Es decir, que para cada categoría, hay muchas atracciones relacionadas. Por lo tanto, para cada categoría navegada en el For Each externo, GeneXus ejecuta el For Each que navega la tabla de atracciones filtrando solamente aquellas atracciones que cumplan que el valor de su CategoryId coincida con el valor del CategoryId de la categoría en la que estamos posicionados. Es como si en el For each interno, hubiéramos escrito Page21

22 Where CategoryId=CategoryId. pero no tenemos que ponerlo, porque GeneXus lo detecta y lo aplica. Hemos visto qué fácil es obtener información y desplegarla en un reporte pero los procedimientos pueden hacer mucho más que eso! Y lo veremos más adelante. Finalmente actualizamos los cambios en GXserver. Page22