myappgen Usted Construye la aplicación mientras la ejecuta

Transcripción

1 myappgen Usted Construye la aplicación mientras la ejecuta

2 Tutorial 9 Tópicos Avanzados Volumen 2 En este tutorial le mostraremos una serie de tópicos avanzados que se necesitan en el momento de desarrollar informes que requieran cubrir necesidades más complejas y de un mayor grado de customización. La construcción y configuración de informes parte con propuestas de informes creadas por el generador; editando el template report se puede reconfigurar (cambios en la definición de columnas, filtros, orden, cortes, subtotales, totales, etc). Cuando necesitamos crear informes de manera más específica, como es el caso de la impresión de documentos (facturas, notas de ventas, notas de débitos, notas de créditos, etc.), también podemos editar los informes y construirlos manualmente. Los ejemplos que le presentaremos en este tutorial le mostraran como construir informes en forma manual utilizando el Report Editor definitions. Observación: Este Tutorial debe ser realizado desde la base de datos instalada por myappgen, antes de comenzar si tiene algún servicio de MySQL en funcionamiento debe detenerlo. Para realizar este Tutorial abra el diccionario Sales.Dct, para acceder a este diccionario abra en forma sucesiva las carpetas de Tutorials, Tutor y Tutorial 9 - Sales. Diseño Manual de los Informes La siguiente Figura muestra una serie de informes que ya se encuentran creados y que iremos utilizando en el transcurso de este tutorial.

3 El primer informe con el que trabajaremos se muestra en la siguiente Figura. En este listado de clientes efectuaremos una serie de modificaciones desde el Report Editor definitions. Por ejemplo cambiaremos su margen, el orden, agregaremos nuevas secciones y modificaremos el aspecto de algunos de sus componentes. Para acceder al Report Editor definitions, presione el botón. Luego acceda al formulario de edición de propiedades (presione el botón ), desde este formulario cambie los márgenes derecho e izquierdo y luego confirme la modificación presionando el botón Ok.

4 Para cambiar las propiedades visuales del título presione doble clic en el componente, realice los cambios que se muestran en el formulario de propiedades y confirme con Ok. Doble clic Cambie la ubicación de los componentes indicados en la siguiente Figura, observe que cuando usted selecciona un componte de la sección line automáticamente se selecciona su titulo. Para mover los componentes puede utilizar el ratón, o puede utilizar las teclas de desplazamiento (izquierda, derecha, arriba, abajo). Una vez que movió los componentes, presione el botón para redibujar las líneas. Con el botón grabe los cambios efectuados y observe el resultado. Graba Dibuja líneas

5 Presione el botón para acceder nuevamente al Report Editor definitions, nuestra siguiente actividad consiste en cambiar el orden del informe y agregar una nueva sección. Acceda al formulario de edición de propiedades (presione el botón formulario modifique el orden del informe, vea la siguiente Figura. ), desde este Doble clic A continuación agregaremos una nueva sección que se utilizará como Header del Pais.

6 Para insertar una nueva sección presione el botón Add Sections. Desde el formulario seleccione la sección que se necesita agregar y confirme con el botón Add. Una vez que agregamos la sección header de país, debemos incluir en la misma el campo nombre del país. Utilice el Editor Tool Box, seleccione el campo cou.name y luego con la ayuda del ratón ubíquelo en el lugar que indica la Figura, confirme la inclusión presionando clic con el ratón. Clic del ratón Para dibujar una línea inferior en esta sección, presione doble clic en la sección y escriba 1 en Bottom. Doble clic

7 Por último cambie el valor que desplegará el componente que indica la Figura. Doble clic Con el botón grabe los cambios efectuados y observe el resultado. Utilización de Variables Locales y de Source Code A continuación aprenderemos como usar las variables locales, específicamente procederemos a definir las variables locales que muestra la Figura, y que sirven para calcular el valor en dólar de las facturas y para desplegar la fecha y la hora del sistema.

8 Ejecute el listado Invoice (Dollars) y presione el botón definitions. para acceder al Report Editor Lo primero que haremos será definir las variables locales que utilizaremos; desde el Editor Tool Box seleccione Local Variables y luego presione el botón. Defina las siguientes variables locales: Ubique las variables locales definidas en los puntos que se observan en la siguiente Figura, presione clic sobre cada variable y con la ayuda del ratón proceda a pegarlas en su lugar respectivo.

9 Luego proceda a cambiar las propiedades visuales de cada variable pegada. Presione doble clic sobre la variable txttotal, efectúe los cambios que muestra la Figura y confirme los cambios con el botón Ok. Doble clic Siguiendo los pasos señalados, efectúe los siguientes cambios de propiedades visuales en las restantes variables.

10 Hasta aquí lo único que hemos hecho es definir las variables locales y ubicarlas al interior de las secciones, para que estas completen su funcionalidad se necesita la definición de source code al interior del informe. Debido a que necesitamos incluir un source code que se encuentre asociado a la sección RptLine, presione right Clic del ratón sobre esta sección y luego elija la opción Source Code. right Clic Estando en el editor de source code usted no necesita escribir el nombre de las variables, puede presionar el botón y seleccionar la variable a partir de la lista. Pegue las siguientes sentencias en el lugar que indica la Figura: lintotal = inv.total / 1000; pertotal += lintotal; tottotal += lintotal;

11 El significado de cada reglón es el siguiente: lintotal = inv.total / 1000; (asigna en lintotal el valor del campo inv.total del archivo Invoice dividido por 1000) pertotal += lintotal; (acumula en pertotal el valor actual de lintotal) tottotal += lintotal; (acumula en tottotal el valor actual de lintotal) Nos queda pendiente un último source code, el cual debe contener las siguientes sentencias. record.setvalueto(invoice); invoice.dofetch(); Estas sentencias indican que por cada reglón del informe se haga Fetch en la posición equivalente dentro del archivo Invoice. Pegue el código en la posición de la siguiente Figura. Confirme los cambios con el botón Ok. Grabe los cambios efectuados y observe el resultado.

12 En los siguientes puntos seguiremos insistiendo en la utilización de los source code en el interior de los informes, nuestro objetivo es presentar casos más avanzados referentes a este tema. La siguiente Figura corresponde al Listado Profit for Invoice. En este informe tenemos creadas las variables locales que se indica en la Figura, y nos queda pendiente completar los source code requeridos para que estas variables intervengan en el proceso de cálculo. Por cada línea del informe efectuaremos los siguientes cálculos: linsaleprice = itminv.price * 1.30; (Cálculo del precio de venta) lintotventa += (itminv.quantity * linsaleprice); (Cálculo del valor total de la venta) linganancia = lintotventa - inv.total; (Ganancia que corresponde a una factura en particular)

13 Ejecute el listado Profit for Invoice y presione el botón definitions. para acceder al Report Editor Con el botón tab Src. acceda al formulario de definición de propiedades del informe y elija el Ubíquese en la sección RptLine y con el botón code. Change acceda al editor de source Para poder insertar un conjunto de sentencias que le permitan leer todos los ítems de cada factura, en Child presione el botón. Luego con enter agregue espacio en los lugares que se le indica con el fin de incorporar posteriormente las sentencias restantes.

14 Pegue los códigos que indica la siguiente figura, de modo que el grupo de sentencias queden escritas de conformidad a este texto: linsaleprice = 0; lintotventa = 0; linganancia = 0; String filter = ""; String order = ""; Child childitminv = null; database.setrelationfields(invoice, iteminvoice); childitminv = new Child(invoice, iteminvoice, filter, order); while (childitminv.gonext()) { linsaleprice = itminv.price * 1.30; lintotventa += (itminv.quantity * linsaleprice); linganancia = lintotventa - inv.total; } childitminv.doend(); tottotventa += lintotventa; totganancia += linganancia; Luego seleccione el tab getnextrecord y en este lugar pegue el siguiente grupo de sentencias: record.setvalueto(invoice); invoice.dofetch(); Confirme los cambios con el botón Ok y luego con el botón grabe los cambios efectuados y observe el resultado.

15 En el último ejemplo referente a source code, usted podrá observar cómo se pueden utilizar conjuntamente los conceptos de source code y de sentencias sql enviadas a la base de datos. Ejecute el listado Auxiliary of Purchase y presione el botón Editor definitions. para acceder al Report La finalidad de este listado es netamente didáctica y consiste en verificar que los totales presentados en el informe coincidan con los totales calculados por medio de variables locales. Utilice el Editor Tool Box para observar cuales son las variables locales que se encuentran definidas en este informe. De modo semejante al ejemplo anterior, necesitamos completar la funcionalidad del informe por medio de source code.

16 Un mecanismo alternativo para acceder al editor de source code consiste en presionar doble clic en la sección (RptLine) y desde el formulario de propiedades de la sección presionar el botón. Vea la siguiente Figura. Doble Clic

17 Ahora vamos a completar la funcionalidad que nos falta, pegue las siguientes sentencias en el lugar que le indica la Figura. java.sql.connection conn = database.getconnection(supplier); java.sql.statement stmt = conn.createstatement(); java.sql.resultset rset = null; String selectsql = "SELECT Sum(p.Total) FROM TUTOR.purchase p WHERE p.supplier = " + sup.supplier; lintotal = 0; rset = stmt.executequery(selectsql); if (rset.next()) { lintotal = rset.getdouble(1); } if (rset!= null) rset.close(); if (stmt!= null) stmt.close(); if (conn!= null) database.closeconnection(conn); tottotal += lintotal; El punto central de estas sentencias se encuentra en los siguientes reglones: lintotal = rset.getdouble(1); (El valor de lintotal se asigna a partir del actual valor del ResultSet) tottotal += lintotal; (El valor de lintotal se acumula en tottotal) Luego seleccione el tab getnextrecord y en este lugar pegue el siguiente grupo de sentencias: record.setvalueto(supplier); supplier.dofetch(); Recuerde que estas sentencias indican que por cada reglón del informe se haga Fetch en la posición equivalente dentro del archivo Supplier.

18 Siguiendo los pasos indicados con anterioridad vea el resultado de las modificaciones. Creación de las Fórmulas de Reglones Los componentes del tipo fórmulas de reglones únicamente pueden ser agregadas en la sección RptLine y contienen expresiones de campos pertenecientes al archivo principal del informe. A continuación veremos un ejemplo que le permitirá entender cómo se define y como trabaja este tipo de componente. Ejecute el listado Tab by Sale y luego acceda al Report Editor definitions. Para crear una fórmula de reglón usted debe presionar el botón y luego con el ratón ubicar el cursor en la posición en la cual se insertará el componente (sección RptLine). Clic

19 En el formulario efectué la definición de la fórmula y luego confirme con el botón Ok. Doble Clic El último paso que nos falta es agregar un componente del tipo función de campos, el cual tendrá como finalidad acumular los valores de la fórmula de nombre Iva. Con el ratón ubique el cursor en el lugar dentro de la sección RptTotal donde se va agregar el nuevo componente. Luego presione right Clic y elija las opciones que se muestran en la Figura. Desde el formulario presione en la opción RowFormula. righ Clic

20 Por último grabe los cambios efectuados y observe el resultado. right Clic