myappgen Usted Construye la aplicación mientras la ejecuta http://www.myappgen.com info@myappgen.com
Tutorial 8 - Process En este tutorial le mostraremos como utilizar el modelo de programa del tipo Process, con este modelo podemos crear un proceso con varias sentencias de actualización de la base de datos. Estas sentencias serán ejecutadas consecutivamente dentro de una única transacción para garantizar la integridad de toda la operación. Si bien es cierto que con la definición de campos del tipo fórmula se puede resolver muchas de las necesidades de cálculo de la aplicación, existen algunas excepciones tales como los procesos de cierre o reapertura. Estos procesos involucran operaciones masivas de actualizaciones, copia de datos a otras tablas, etc. Las sentencias de los procesos pueden ser del tipo: - Sql Insert - Sql Update - Sql Delete - Sql Free Write (Escritura manual de sentencias SQLs) - Recalculate Formula (re cálculo de los campos del tipo fórmula) En este Tutorial desarrollaremos dos ejemplos de procesos en los que podrá observar cómo se utilizan los diversos tipos de sentencia. El primero es el cierre mensual del stock y el segundo es un proceso de re cálculo que se efectúa sobre el archivo de Totales por Cliente y Tipo de Venta. 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 Process.Dct, para acceder a este diccionario abra en forma sucesiva las carpetas de Tutorials, Tutor y Tutorial 8 - Process.
Cierre mensual del Stock El proceso de cierre mensual del stock tiene una doble función, por un lado deja cerrado el stock del mes anterior, y por otro lado abre el nuevo mes. El proceso consta de los siguientes pasos: Cierre del periodo anterior. Creación del nuevo periodo, este quedará como periodo activo. Creación de registros en la ficha de stock para el nuevo periodo. Desde la pantalla principal del myappgen ejecute la aplicación y abra el Application Builder Wizard., pase al modo edición Ubíquese en el menú Process (el pattern Process se elije automáticamente), en el panel de la izquierda seleccione el archivo Stock y en el panel de la derecha oprima Build Process. En el formulario de creación del proceso complete los títulos indicados en la Figura y elija el tipo de proceso Sql Free Write. Confirme con el botón Ok. Para modificar el Menu Text del proceso, presione doble clic sobre el Menú Item Stock, en el formulario de definición de propiedades escriba Cierre Stock como el nuevo Menu Text, confirme con el botón Ok.
Doble clic Ubíquese sobre el proceso StockProcess y presione el botón Change, observe en el formulario de Definición de Procesos que se creó un primer ítem del tipo Sql Free Write. Seleccione la definición del primer proceso y luego presione el botón. Desde la interface gráfica que aparece en la Figura derecha especificaremos las sentencias que componen el proceso de cierre del periodo anterior y de creación del nuevo periodo. Recuerde que en el Manual de la Aplicación le hemos mencionado que los procesos del tipo Free Code se utilizan para escribir sentencias Sql que sean complejas y que no puedan ser escritas utilizando la interface visual; y que además con este modelo se pueden escribir pedazos de programa en lenguaje Java que ejecutan diversas sentencias. A continuación veremos paso a paso como podemos utilizar este tipo de proceso en el cierre mensual del stock.
1. Seleccione el archivo TUTOR.Period y desde Options elija Child Entity. Presione clic en Select Option. Desde la interface gráfica de la Figura derecha escribiremos un filtro para el proceso Child Entity. Escriba el filtro que se muestra en la Figura, con este filtro se indica que quede disponible únicamente el periodo activo, confirme con el botón Ok. Usted no necesita escribir el campo per.current, ubíquese sobre el mismo y presione Select Field. 2. Complete las sentencias que irán al interior del ciclo while (child.gonext()) { }, así como la declaración e inicialización de variables que serán necesitadas. 3. Primero insertaremos la siguientes líneas de código String curperiod; int curyear; int curmonth; String[] monthtxt = {"Enero","Febrero","Marzo","Abril","Mayo","Junio","Julio","Agosto","Septiembre","Octubre","Noviembre","Diciembre"};
java.text.decimalformat df = new java.text.decimalformat("00"); Para crear dos líneas en blanco, ubíquese en la posición que indica la Figura y presione dos veces enter, luego inserte el pedazo de código mencionado, utilice copiar y pegar. Presione dos veces enter 4. Dentro del ciclo while (child.gonext()) { } insertaremos las siguientes líneas de código, estas sentencias son las que realizan el cierre del periodo anterior y la creación del nuevo periodo. Para insertar las siguientes líneas de código utilice copiar y pegar. /* Ubicarse en el periodo actual e inicializar el Entity period */ con = database.getconnection(period); period = (Period) child.getentity(); curperiod = per.period; per.clear(); per.period = curperiod; try { if (period.dofetch()) { /* Marcar como Closed el periodo Actual */ database.begintransaction(con); per.current = "C"; /* Actualizar el periodo actual */ period.doupdate(con); /* Crear el nuevo periodo, el mismo se convertirá en el periodo Activo */ curyear = Integer.parseInt(curPeriod.substring(0, 4)); curmonth = Integer.parseInt(curPeriod.substring(4, 6)); curmonth += 1; if (curmonth == 13) { curmonth = 1; curyear += 1; } per.clear(); per.period = curyear + df.format(curmonth); per.description = monthtxt[curmonth - 1] + " / " + curyear; per.current = "A"; per.priorperiod = curperiod; /* Insertar el nuevo periodo */ period.doinsert(con); database.commit(con); } } catch (Exception ex) { if (con!= null) database.rollback(con); }
5. Verifique la sintaxis del código insertado (utilice Check) y luego confirme el proceso con el botón Ok. Para completar nuestro proceso de cierre mensual del stock nos queda pendiente crear los registros en la ficha de stock para el nuevo periodo. Esto lo haremos por medio de la sentencia Sql Insert que se muestra en la siguiente Figura. Esta sentencia insert sql se ejecuta una vez que se creó el nuevo periodo, el cual quedó como periodo activo. Con esta sentencia se insertan registros en el archivo Stock; utilizando el nuevo periodo se crea un registro por cada producto del stock del periodo anterior (cerrado), y para cada registro se efectúan las siguientes asignaciones: sto.period = per.period sto.product = sto.product sto.quantitypreviousavailable = IfNull(sto.quantityCurrentAvailable, 0) sto.quantitycurrentavailable = IfNull( sto.quantitypreviousavailable, 0) + IfNull( sto.quantitypurchases, 0) IfNull( sto.quantitysales, 0) sto.previousavailable = IfNull(sto.currentAvailable, 0) sto.currentavailable = IfNull(sto.previousAvailable, 0) + IfNull(sto.purchases, 0) - IfNull(sto.sales, 0)
Donde IfNull(campo, 0) es una función de MySQL que reemplaza por 0 los valares nulos cargados en el campo Para crear la sentencia sql insert siga los siguientes pasos. 1. Desde el formulario de definición de procesos presione el botón Add insert process. 2. En el Tab Fields del formulario de definición del proceso insert, complete el mensaje del proceso, y luego indique las asignaciones que se harán en los campos del archivo Stock. Agregue los archivos Stock y Period. Ubíquese sobre Process y presione agregar y confirme con Ok., en la lista de archivos elija el archivo que desea Observe en la Figura de abajo que hemos agregado los archivos Stock y Period como archivos independientes, de modo a que no se asigne automáticamente la relación que existe entre los mismos, debido a que en nuestro ejemplo la relación se efectúa a través de sto.period = per.priorperiod. Para efectuar la primera asignación de campos, seleccione en el archivo Period el campo per.period y presione el botón Add. En el formulario Formula Editor, elija el campo sto.period y confirme con el botón Ok.
Para asignar el campo sto.product, seleccione el archivo Stock y luego presione doble clic sobre el campo. Doble clic Nuestro siguiente paso consiste en efectuar las siguientes asignaciones. sto.quantitypreviousavailable = IfNull(sto.quantityCurrentAvailable, 0) sto.quantitycurrentavailable = IfNull( sto.quantitypreviousavailable, 0) + IfNull( sto.quantitypurchases, 0) - IfNull( sto.quantitysales, 0) Seleccione los campos que se indican en la Figura derecha y presione el botón Add. Ubíquese en cada uno de los campos insertados y con el botón Change efectúe las siguientes modificaciones.
Luego seleccione los campos indicados en la Figura y a continuación presione Add. Ubíquese en cada uno de los campos insertados y con Change efectúe las siguientes modificaciones. sto.previousavailable = IfNull(sto.currentAvailable, 0) sto.currentavailable = IfNull(sto.previousAvailable, 0) + IfNull(sto.purchases, 0) - IfNull(sto.sales, 0) 3. Presione clic en el Tab Filter y complete el filtro sto.period = per.priorperiod AND per.current = 'A', el cual indica los campos de relacionamiento y la condición de utilizar el periodo activo. 4. Presione el botón Ok para confirmar la creación de la sentencia sql insert.
Observe la Figura del formulario de definición de procesos, ahora muestra los dos procesos que componen el proceso de cierre mensual del stock. Debido a que el proceso de cierre mensual del stock contiene un proceso del tipo free write, el mismo solo puede ser ejecutado desde el programa generado. La ejecución de este proceso se efectúa en la parte final del Tutorial por motivos didácticos. A continuación veremos cómo realizar la definición del proceso de re cálculo del archivo de Totales por Cliente y Tipo de Venta.
Re cálculo del archivo de Totales por Cliente y Tipo de Venta El proceso re cálculo del archivo de Totales por Cliente y Tipo de Venta tiene como objetivo crear los registros del archivo SaleTypeTotal, el cual es un archivo auxiliar que se utiliza para la emisión de la consulta que se muestra en la siguiente Figura. El proceso consta de los siguientes pasos: Borrado de los registros anteriores del archivo SaleTypeTotal. Creación de los registros de clientes que se encuentren en situación de clientes activos en el periodo del mes abierto (activo). Para cada registro de clientes el cálculo de los totales de ventas por tipo (SMALL, MEDIUM, LARGE), así como del total general (TOTAL). El proceso anterior consta básicamente de una sentencia sql delete, una sentencia sql insert y por último de una sentencia sql update. Ubíquese en el ítem de menú Cierre Stock (el pattern Process se elije automáticamente), en el panel de la izquierda oprima doble clic sobre el archivo SaleTypeTotal. Doble clic Desde el formulario de definición de procesos complete los títulos que se muestran en la Figura, elija el tipo Sql Delete y confirme con el botón Ok.
Una vez creado el proceso cambiaremos el Menu Text del mismo, ubíquese sobre el proceso SaleTypeTotal y presione el botón. En el formulario de propiedades del Menú Item escriba el nuevo Menu Text y confirme con Ok. A continuación editaremos la definición del proceso creado, seleccione el proceso SaleTypeTotalProcess y presione doble clic sobre el mismo. Observe en el formulario de definición de procesos que el primer proceso creado es una sentencia sql delete, esta sentencia necesita ser modificada de modo a que la misma borre todos los registros de la tabla SaleTypeTotal. En el formulario de definición de procesos, ubíquese sobre el proceso creado y presione el botón. Doble clic Desde el formulario de definición de la sentencia sql delete, deje en blanco el filtro existente, presione clic sobre el Tab Data para verificar todos los registros que serán borrados, y por último confirme la modificación de la sentencia presionando Ok.
El siguiente proceso que debemos crear es una sentencia sql insert que crea los registros de clientes que se encuentren en situación de clientes activos en el periodo del mes abierto (activo). Desde el formulario de definición de procesos presione Add insert process. En el formulario de definición del proceso sql insert (Figura derecha), agregue el archivo Invoice, utilice el botón. Ubíquese en el archivo Invoice y agregue los archivos relacionados: Period y Customer, utilice el botón. Ahora que disponemos de todos los archivos intervinientes en la sentencia sql insert, procederemos a efectuar las siguientes asignaciones de campos. typtot.period = inv.period typtot.customer = cus.customer typtot.name = cus.name En Insert File seleccione el archivo SaleTypeTotal, luego elija en el archivo Invoice el campo inv.period. Presione doble clic sobre este campo.
Desde el formulario Formula Editor seleccione el campo typtot.period y confime con el botón Ok. Doble clic Para asignar los campos del archivo Customer, seleccione los campos que se muestra en la Figura de la izquierda y presione el botón Add. Desde el formulario Formula Editor elija en forma sucesiva los campos typtot.customer y typtot.name. Confirme con Ok. A continuación presionamos clic en el Tab Filter con el objeto de escribir una condición que limite el conjunto de registros que serán insertados en el archivo SaleTypeTotal. Escriba el siguiente filtro per.current = 'A' AND cus.situation = 'A', con el fin de que se inserten solo los clientes que se encuentren activos en el periodo abierto (Activo).
Presione clic en el Tab Data y vea los registros que serán incorporados al archivo SaleTypeTotal. Para confirmar la creación de la sentencia sql insert presione Ok. Nos queda pendiente crear la definición de una sentencia sql update que nos permita calcular para cada uno de los clientes, los totales de ventas acumulados en el periodo abierto (activo). La sentencia sql update que definiremos efectuará las siguientes asignaciones de campos en el archivo SaleTypeTotal : typtot.small = SELECT Sum(inv.total) FROM Invoice inv, Period per WHERE ( inv.period = per.period ) AND (per.current = 'A' AND typtot.customer = inv.customer AND inv.total >= 1 AND inv.total <= 10000) typtot.medium = SELECT Sum(inv.total) FROM Invoice inv, Period per WHERE ( inv.period = per.period ) AND (per.current = 'A' AND typtot.customer = inv.customer AND inv.total >= 10001 AND inv.total <= 100000) typtot.large = SELECT Sum(inv.total) FROM Invoice inv, Period per WHERE ( inv.period = per.period ) AND (per.current = 'A' AND typtot.customer = inv.customer AND inv.total >= 100001 AND inv.total <= 99999999) typtot.total = IfNull( typtot.small, 0) + IfNull( typtot.medium, 0) + IfNull( typtot.large, 0) Presione Add update process para editar el formulario de definición de sql update.
Seleccione en Update File: SaleTypeTotal, complete el message del proceso y luego presione doble clic en el campo typtot.small. Doble clic Acceso al Select Editor Desde el formulario Formula Editor borre la formula existente y presione el botón Sql para crear una nueva fórmula. El Select Editor nos permitirá crear la sentencia select que será asignada al campo typtot.small. Agregue los archivos Invoice y Period, utilice el botón. Para crear la expresión del select, en el Tab Expression ubíquese en el campo inv.total y presione el Sum (Figura izquierda). Presione clic en el Tab Filter escriba la siguiente condición de filtro per.current = 'A' AND typtot.customer = inv.customer AND inv.total >= 1 AND inv.total <= 10000. Confirme con el botón Ok. Verifique el contenido de la formula, presione Check. Confirme con el botón Ok.
A continuación seleccione los campos que se muestra en la Figura y luego presione Select. Utilizando el procedimiento que le hemos explicado, efectúe las siguientes asignaciones. typtot.medium = SELECT Sum(inv.total) FROM Invoice inv, Period per WHERE ( inv.period = per.period ) AND (per.current = 'A' AND typtot.customer = inv.customer AND inv.total >= 10001 AND inv.total <= 100000) typtot.large = SELECT Sum(inv.total) FROM Invoice inv, Period per WHERE ( inv.period = per.period ) AND (per.current = 'A' AND typtot.customer = inv.customer AND inv.total >= 100001 AND inv.total <= 99999999) Nos queda pendiente asignar la fórmula para typtot.total. typtot.total = IfNull( typtot.small, 0) + IfNull( typtot.medium, 0) + IfNull( typtot.large, 0) Seleccione el campo typtot.total y luego presione Select. Desde el formulario Formula Editor complete la Formula indicada en la Figura de abajo. Verifique el contenido de la fórmula ( Check), confirme con Ok.
En el Tab Data podemos observar los valores que quedarán en los campos al ejecutar la sentencia sql update. Para confirmar la creación de la sentencia presione Ok. Como podemos observar en la Figura, con la creación del proceso anterior hemos finalizado la definición del proceso de re cálculo del archivo de Totales por Cliente y Tipo de Venta. Cierre el formulario de definición de procesos y pase al modo ejecución. Para ejecutar el proceso creado seleccione las opciones que se muestran en la Figura y confirme con Ok en el formulario Process Manager.
Ahora que hemos re cálculado SaleTypeTotal podemos ejecutar la consulta que se muestra en la siguiente Figura. Recalculate Formula (re cálculo de los campos del tipo fórmula) Existen ocasiones en que al actualizar los archivos por medio de sentencias sql, los campos del tipo fórmula pueden quedar desactualizados. Para resolver este problema, podemos agregar el re cálculo de los campos del tipo fórmula para los archivos necesarios. Debido a que este tipo de proceso no se utiliza en este tutorial, lea en el Manual de la Aplicación el detalle referente al mismo. El último punto que nos queda pendiente es ejecutar el proceso de cierre mensual del stock. Antes de ejecutar este proceso necesitamos generar la aplicación. Desde la pantalla principal de myappgen grabe la aplicación. Presione el botón, genere el código fuente y luego compile y cree los archivos de distribución
Para ejecutar la aplicación presione doble clic sobre el archivo Process.jar. Ingrese User: Process y Password adminadmin. Para ejecutar el proceso de cierre mensual del stock, seleccione las opciones que se muestran en la Figura y confirme con Ok en el formulario Process Manager.
Desde el formulario de actualización del periodo, observe que ahora el periodo activo es Septiembre / 2009. Para observar la ficha de control de stock que se ha creado para el mes de Septiembre / 2009, ubíquese en este periodo y presione el botón Stock.