myappgen Usted Construye la aplicación mientras la ejecuta

Transcripción

1 myappgen Usted Construye la aplicación mientras la ejecuta copyright Carlos Leggio

2 myapplicationgenerator Introducción: "myappgen", es un generador de aplicaciones sumamente innovador, intuitivo, fácil de utilizar, pensado y diseñado para producir increíbles beneficios tanto al desarrollador de la aplicación como al usuario final de la misma. Importar de la base de datos Conectar con base de datos Crear database, table, key, relations Crear files, fields, keys, relations Ejecutar/construir aplicación Reconstruir aplicación Generar código fuente, compilar y distribuir Formulas El desarrollador podrá construir una aplicación completa, con todos los programas de carga de datos, consultas, informes, consultas de totales por grupo, informes de totales por grupos, procesos de cierre, etc. Pero al decir completa, no nos quedamos solamente con estos programas, vamos mucho más lejos y agregamos los módulos de seguridad, auditoría, ayuda, multi-idioma, anexo de documentos, , suscripción para que la aplicación le envíe por correo periódicamente cualquier informe de la aplicación, suscripción para que la aplicación avise por correo cuando se cumpla alguna condición u ocurra algún evento, consola de administración de los usuarios que utilizan la aplicación, mecanismo de distribución de nuevas versiones, etc. Construir una aplicación con estas características con las herramientas convencionales llevaría mucho tiempo y sería muy costoso; sin embargo, con myappgen es sólo cuestión de habilitar estos módulos y las funcionalidades estarán disponibles en todos los programas de cualquier aplicación.

3 Otro aspecto importante para el desarrollador es que el trabajo debe ser lo más fácil posible para que pueda ser realizado lo más rápido posible. Hacer que el desarrollo de aplicaciones sea fácil y rápido, es una tarea bastante difícil, y sin lugar a dudas, ésta ha sido la meta de casi todas las herramientas de desarrollo, pero precisamente en este punto myappgen presenta las más grandes innovaciones que le dan otra perspectiva al desarrollo y produce increíbles ventajas. Para que no queden dudas, me voy a referir solamente a cuatro características que son las responsables del mayor cambio en el paradigma de desarrollo. La primera, es que la aplicación se construye progresivamente mientras se está ejecutando. Con este nuevo paradigma, en vez de escribir el programa, simplemente se le pide al generador que prepare una propuesta del programa que se está necesitando; el generador construye la propuesta y la ejecuta inmediatamente; entonces, al verla en funcionamiento, se puede pasar al modo edición, modificar sus propiedades, agregar nuevos componentes, e incluso agregar botones que llamen a nuevos programas; luego se pasa al modo ejecución y se sigue ejecutando la misma aplicación, ahora con sus nuevos componentes y sus nuevos programas, que a su vez al ser ejecutados, podrán ser editados y así sucesivamente. Evidentemente, así el trabajo de desarrollo se vuelve mucho más simple, fácil e intuitivo, disminuyéndose drásticamente el tiempo y los costos correspondientes; es más, es tan fácil construir las aplicaciones, que usted podrá encarar el desarrollo por medio de la construcción de prototipos sucesivos. La segunda, es la posibilidad de definir campos del tipo fórmula en el diccionario de datos; estos campos se calculan automáticamente de forma similar a las planillas de cálculo, pero con la diferencia que en este caso se refieren a campos de las tablas de la base de datos. Esto es, cuando se ingresa, modifica o borra un dato, automáticamente se calculan todas las fórmulas que son afectadas por ese dato. Esta simple definición, produce un gran beneficio y hace que los programas de registro de datos sean solamente eso, programas de registro de datos y no complejos algoritmos de actualización de archivos. A partir de esta definición, todos los programas de registro de datos se vuelven simples, siendo igualmente simple el registro de clientes que el registro de compras, ventas, pagos, etc. Todos ellos solamente cargan los datos del registro y los procesos de cálculo se realizan automáticamente de acuerdo a las fórmulas definidas en el diccionario de datos. La tercera, existen varias funcionalidades muy importantes que no llevan ningún trabajo implementarlas, basta con habilitarlas al crear la aplicación para que sean incorporados a todos los programas y funcionen totalmente integrados como si hubiesen sido programados especialmente para ellos. Como ejemplo podríamos mencionar los módulo de seguridad, auditoria, ayuda, multi idioma, administrador de documentos, correo electrónico, suscripción para recibir informes periódicamente por , suscripción para recibir alertas por cuando ocurre algún evento, agendar la ejecución automática de procesos, consola de administración de usuario, control y distribución de nuevas versiones, etc. Estas funcionalidades sólo se encuentran disponibles en algunas aplicaciones muy costosas, sin embargo con myappgen, basta con habilitarlas para que estén incluidas en todos los programas de cualquier aplicación. La cuarta, en el trabajo de desarrollo de aplicaciones la mayor dificultad no está precisamente en desarrollar la aplicación sino más bien en el mantenimiento que se debe realizar durante toda la vida útil de la aplicación. Este problema en myappgen se resuelve gracias al mecanismo de sincronismo que existe entre las definiciones del

4 diccionario de datos y las aplicaciones construidas. Gracias a esta funcionalidad cualquier cambio en el modelo lógico de datos se refleja automáticamente en todos los programas de todas las aplicaciones definidas en el diccionario. Así, si usted modifica el nombre de un campo, su prompt, título, tipo de dato, longitud, validación, valor inicial, fórmula, etc., estos cambios serán aplicados en todos los programas de todas las aplicaciones construidas en el diccionario. Incluso si se realizan cambios más radicales como borrar un campo o aún más, como borrar un archivo o borrar un relacionamiento, también se mantendrá la integridad, modificándose también radicalmente las aplicaciones de acuerdo al nuevo modelo de datos. Con respecto al usuario final de la aplicación, myappgen sabe que el destinatario de todo el esfuerzo de desarrollo es el usuario final, por eso genera aplicaciones que son agradables, fáciles de utilizar, con muchas funcionalidades y sumamente configurables, dando al usuario final autonomía para hacer consultas y obtener informes no previstos. Las principales funcionalidades que tendrá el usuario son: - Todas las listas de la aplicación son configurables: se pueden reordenar las columnas, agregar filtros, totales, etc. - Todas las listas tienen el botón de impresión: el informe puede ser reconfigurado por el usuario, definiendo columnas, filtro, orden, corte, subtotales, totales, etc. Estas definiciones pueden ser grabadas para ser utilizadas en el futuro. - Si se habilitaron los módulos externos, todas las listas tienen la posibilidad de anexar documentos, ver el histórico de auditoría, enviar por . - Todos los informes son configurables por el usuario, definiendo las columnas, orden, filtro, subtotales, totales, etc.; incluso se pueden definir nuevos informes y grabarlos para utilizarlos cuando sea necesario. - Los usuarios se pueden suscribir para que la aplicación les envíe cualquier informe periódicamente por . - Los usuarios se pueden suscribir para que la aplicación les avise por , cuando ocurre algún evento o se cumple alguna condición. - Las consultas e informes de grupos/expresiones pueden ser configuradas por el usuario, creando nuevos grupos, nuevas expresiones, filtros, etc. y grabarlas para que sean utilizadas cuando sea necesario. - En cualquier lista que contenga el , los usuarios pueden crear cartas personalizadas, con variables de sustitución y emitirlas a todos los registros que cumplan cierta condición; las cartas son emitidas en una bandeja temporal para que sean verificadas, corregidas, seleccionadas y finalmente enviadas. - Mediante la consola de administración de usuarios se puede ver la lista de usuarios que están utilizando la aplicación, a qué hora ingresaron y que programa están utilizando en este momento. Se les pueden enviar mensajes, sacarles fuera de la aplicación, impedirles que vuelvan a ingresar, etc. La Aplicación generada tendrá las siguientes características: - Arquitectura Cliente/Servidor en dos capas. - Interfase Windows (componentes swing) - Funciona con cualquier base de datos (mysql, Oracle, SqlServer, Db2, Informix) - Procesamiento de transacciones y control de concurrencia a nivel de campos - Consultas Gerenciales (totales por grupo de expresiones)

5 - Informes configurables por el usuario, definición de columnas, totales, subtotales, filtros, etc. - Informes Gerenciales (totales por grupo de expresiones) - Seguridad (restricciones en componentes visuales, filtros en listas, filtros en informes) - Auditoría (Histórico de quién, cuándo y qué datos fueron modificados) - Ayuda - Multi-Idioma - Correo electrónico (suscribirse para recibir periódicamente informes, notificaciones de eventos, mailing list, etc.) - Anexo de Documentos - Importación y Exportación de datos - Consola de administración de Usuarios. Principales Componentes de myappgen: - Diccionario de Datos o Definición lógica de Base de Datos, Tablas, Campos, Claves, Relaciones o Creación física de Base de Datos, Tablas, Campos, Claves, Relaciones o Importación de la Base de Datos física a la definición lógica o Sincronización entre la definición lógica y física de la Base de Datos. o Definición de campos del tipo FORMULA (se calculan automáticamente) o Interfase para agregar, modificar, borrar, registros en las tablas definidas. o Impresión de registros de las tablas o Impresión de la estructura lógica del diccionario de datos o Exportación de datos o Importación de datos - Runtime Application Builder o Runtime Menu Builder o Runtime Browse Builder, child Browse Builder o Runtime Form Builder, lookup parent file, Tab child Browse o Runtime Query Builder o Runtime Report Builder o Runtime Report Total Builder o Runtime Query Total Builder o Runtime Process Builder o Application Wizard o Default Application Components

6 - Módulos Integrados o Seguridad o Auditoría o Ayuda o Multi-Idioma o Anexo de Documentos o Comunicación ( ) Interface visual para envío y recepción de s Envío de pantallas o informes de la aplicación Suscripción para recepción periódica de informes Suscripción para avisos por evento o condición Correos con formatos definibles para listas que contengan s entre sus datos o Consola de Administración de Usuarios Visualizar usuarios activos y en qué programa se encuentran Enviar mensajes a usuarios activos Sacar del sistema a usuarios, bloquear el acceso al sistema Distribuir la nueva versión de la aplicación a las estaciones - Generación de Código Fuente en lenguaje Java o Creación del Proyecto Java para NetBeans - Compilación y creación del archivo Jar y de las carpetas para distribución.

7 Construcción de la Aplicación El proceso de construcción de la aplicación es sumamente simple, todas las tareas necesarias han sido pensadas para que myappgen las pueda realizar o en su defecto, tenga herramientas que faciliten el trabajo. Para tener una visión de contexto, ahora vamos a hacer un breve resumen de los pasos que se deben realizar para construir una aplicación, más adelante se tratará detalladamente cada uno de estos temas. 1. Creación del Diccionario de Datos Presionando el botón del toolbar se crea el diccionario de datos que es un único archivo con extensión dct que contiene el modelo lógico de datos (tablas, campos, claves, relaciones, fórmulas), así como también el modelo lógico de las aplicaciones (menú, browse, form, query, querytotals, report, reporttotal, process) 2. Creación del Modelo Lógico de Datos Consiste en la definición lógica de las tablas, con sus campos, tipos de datos, validaciones, fórmulas, clave primaria, relaciones entre archivos, etc. El generador utiliza el modelo de datos relacional para la construcción de la aplicación, por ese motivo es fundamental tener una correcta y completa definición de la estructura de datos y sus relaciones. Todas estas estructuras de datos pueden ser registradas manualmente, pero si ya existen las tablas en la base de datos, es mucho más fácil y rápido importarlas y luego hacer las correcciones necesarias. 3. Creación del Modelo Físico de Datos A partir del modelo lógico de datos se generan y luego se ejecutan las sentencias SQL que crean las tablas, campos, índices y restricciones en la base de datos (mysql, Oracle, Db2, SqlServer, Informix, etc). 4. Construcción de la Aplicación Con seguridad, la innovación más grande de myappgen es que la aplicación se construye progresivamente mientras se está ejecutando. Con este nuevo paradigma, en vez de escribir el programa, simplemente se le pide al generador que prepare una propuesta del programa que se está necesitando; el generador construye la propuesta y la ejecuta inmediatamente; entonces, al verla en funcionamiento, se puede pasar al modo edición, modificar sus propiedades, agregar nuevos componentes, e incluso agregar botones que llamen a nuevos programas; luego se pasa al modo ejecución y se sigue ejecutando la aplicación, ahora con sus nuevos componentes y sus nuevos programas, que a su vez podrán ser editados y así sucesivamente. Evidentemente, así el trabajo de desarrollo se vuelve mucho más simple e intuitivo, disminuyéndose drásticamente el tiempo y los costos correspondientes; es más, es tan fácil construir las aplicaciones, que usted podrá encarar el desarrollo por medio de la construcción de prototipos sucesivos. Entonces, para construir la aplicación se empieza ejecutando la aplicación. Al principio, está compuesta por el menú principal y los módulos habilitados. En la figura de abajo, se muestra la aplicación en ejecución; para modificarla, simplemente se pasa del modo ejecución al modo edición.

8 Cambio del modo de ejecución a edición. El menú contiene los módulos habilitados. En el modo edición, se pueden agregar, modificar o borrar componentes de la pantalla. Para hacer esto, se selecciona el componente, se aprieta rightclic y se selecciona la opción deseada; las opciones cambian de acuerdo al componente seleccionado; por ejemplo, si se selecciona el item de menú Update, se podrá agregar Menu Item, Menu y Separador, sin embargo, si se selecciona el panel principal, se podrá agregar Label, Button, Panel, SplitPanel. Seleccionar Update y apretar rightclic Ejecutar Wizard que construye Browse, Update, Report, Query, Process, etc. Salir del modo edición y pasar a ejecución. Al agregar un Menú Ítem, además de definir sus características visuales, también se definen las características del programa que se ejecutará al seleccionar este ítem. El nombre del programa que será ejecutado. El archivo sobre el cual actuará el programa. El tipo de programa que se construirá. En este caso, seleccionamos el Pattern Browse y el archivo Customer y con solo estas definiciones, myappgen construye una propuesta del programa Browse, de Customer, el Form de Customer, con el lookup para los archivos padres (Country, City), el Informe de Customer, la auditoría, el correo, etc. La propuesta de Browse es construida con los botones de agrega, modifica, borra, busca, filtra, exporta, imprime y sale. Además, dependiendo de los módulos habilitados, se agregan los botones de auditoría, correo y documentos anexos. Los campos Memos son definidos como showfields y son desplegados en la parte inferior de la pantalla al

9 seleccionar cada registro; si existen campos del tipo fórmula se los define como Sum Column, lo que hace que se agregue el renglón de Total. Auditoria Agrega, modifica y borra registros. Correo Anexar documentos Impresión, configurable por el usuario. Campos memos. Se muestran al seleccionar cada renglón Agrega el renglón de total para los campos del tipo formula Por supuesto que este Browse es sólo una propuesta, que puede ser modificada; basta con pasar del modo ejecución al modo edición, donde con doble clic, podemos modificar las propiedades de cualquier componente (en la figura, clic en el header)

10 Se pueden hacer cambios más estructurales editando y reconfigurando el template o presionando doble clic sobre los datos de la lista. Tabs, con las opciones de configuración. Archivo primario y sus archivos padres relacionados Campos disponibles para incluir en el Browse. Columnas del Browse Edición de la columna Reordenar columnas La propuesta de Form, es construida con los campos entry con sus validaciones respectivas, los campos memos en Tabs independientes, los campos Foreign Key con su botón de lookup y los campos del tipo fórmula como texto (no modificable). Despliega lista lookupprocedure Display field Campos tipo Formula

11 Este Formulario es sólo una propuesta que puede ser modificada, basta con pasar del modo ejecución al modo edición, donde podemos seleccionar y modificar las propiedades de cualquier componente (figura muestra, doble clic en el nombre) Modo Edición Doble clic, edita las propiedades. Se pueden hacer cambios más estructurales, editando las propiedades del Template. Tabs, con las opciones de configuración. Select/Unselect, campos del Formulario de actualización Modifica propiedades del campo Reordena campos

12 Para demostrar la flexibilidad que nos permite la configuración del template, hemos pasado los campos memos al Tab General, los reordenamos y agregamos el child Order; el resultado se muestra en la figura de abajo: el formulario de carga de datos ahora permite actualizar los datos del cliente y registrar sus órdenes. 5. Generación del Código Fuente, Compilación y Distribución. Con un simple clic en el botón el generador crea el código fuente en lenguaje JAVA, compila y crea la carpeta de distribución donde se copian todos los archivos necesarios para la ejecución de la aplicación. Para llevar la aplicación a otro computador, simplemente se copia todo el contenido de la carpeta "dist" al otro computador y se ejecuta la aplicación. 6. Creación de Security, Help y Translate No es necesario hacer ningún trabajo de programación de estos módulos, basta con sólo habilitarlos al crear la aplicación para que sean incorporados a todos los programas. La definición de los valores específicos salen del ámbito de desarrollo y pasan al ámbito de producción de la aplicación donde un usuario con perfil de administrador ejecutando la versión compilada de la aplicación puede definir la seguridad, crear las pantallas de help y traducir la aplicación a cualquier idioma Security: El manejo de restricciones de seguridad permite que la aplicación en ejecución cambie sus características de acceso, dependiendo del usuario que ingresó a la misma. Así evitamos por ejemplo, que los empleados de ventas puedan hacer asientos contables o emitir informes de contabilidad. Esta funcionalidad se obtiene haciendo que determinados elementos de la aplicación estén inhabilitados o incluso invisibles para todos los usuarios del grupo con restricción; existen también otros casos en los que se necesita ocultar columnas en las listas, o limitar el acceso a un subconjunto de datos, o restringir la cantidad de registros en un informe. Para realizar esta tarea, basta que algún usuario con perfil de administrador ejecute la aplicación y defina las restricciones de acceso mientras está ejecutando la aplicación; así, en cualquier ventana puede entrar al modo de edición de seguridad, seleccionar el grupo de usuarios al que se aplicarán las restricciones y definir

13 restricciones para cualquier componente de esa ventana; luego puede seguir ejecutando la aplicación y ver inmediatamente como quedará la ventana cuando ingrese cualquier usuario de ese grupo Ayuda (Help): Disponer de la tecla F1 Help es un estándar en las aplicaciones de hoy en día; todos nosotros, cuando estamos empezando a utilizar una nueva aplicación y tenemos alguna duda casi automáticamente recurrimos a la tecla F1. Al construir myappgen, he pensado mucho como podría hacer que el generador nos ayude en la construcción del Help; a primera vista parece imposible que un software pueda hacer este trabajo, pero también parecía imposible construir una aplicación mientras se la ejecutara; entonces, no puede ser que no podamos encontrar ningún mecanismo más eficiente y que tengamos que seguir redactando todos los manuales y conectándolos en cada programa. La solución que encontré se basa en el mismo principio que utilicé para construir la aplicación; así como ella se va construyendo a sí misma y nosotros solamente la modificamos, también la propia aplicación debe construir su propio Help y nosotros simplemente lo modificamos. Profundicemos un poco más en esta idea; realmente lo que queremos explicar en el Help es precisamente lo que ya está haciendo la aplicación, y si ella ya lo está haciendo, entonces ella debería poder explicarlo. Aquí podríamos decir que la aplicación debería conocerse a sí misma y así, poder explicarnos qué hace y porqué lo está haciendo. Lastimosamente no llegamos tan lejos, pero todavía les tengo alguna sorpresa. Imagínese que usted pueda desarrollar toda la aplicación sin tener que preocuparse completamente del Help. Y que con la aplicación ya terminada, simplemente la ejecuta y en el menú principal le pide a la propia aplicación que ella misma vaya construyendo su módulo Help mientras usted recorre cada una de las pantallas de la aplicación. De hecho, si cada pantalla se conoce a sí misma, entonces ella puede redactar su propia página Help. Como mínimo, de las pantallas podemos obtener su propia imagen y a todos los botones que se ven en esa imagen podemos aplicarles el hiperlink que nos lleve a su página Help correspondiente; así, con sólo las imágenes de las ventanas podremos construir un Help dinámico en el que se puede navegar de página a página como si fuese la propia aplicación navegando de ventana en ventana!!!! Es increíble, como con tan poco, podemos hacer tanto, pero no solamente podemos utilizar las imágenes, además las ventanas nos pueden dar muchos datos sobre su contenido, pudiendo ser utilizados para escribir un pequeño texto explicativo en cada página de Help. Por otro lado, las páginas de Help construidas por la aplicación son sólo una propuesta que usted puede editar y agregar toda la explicación que considere necesaria. Es más, como este trabajo es totalmente independiente del desarrollo de la aplicación, también el propio usuario administrador del sistema puede complementar las páginas de Help, editando y agregando las explicaciones que considere necesarias para el correcto uso de la aplicación en los procesos administrativos de la empresa.

14 Así, no sólo podemos automatizar la construcción de las páginas de Help, también podemos pasar la responsabilidad de mejorar su redacción a la propia empresa que utiliza la aplicación Multi-Idioma: Al desarrollar una aplicación cada vez es más frecuente la necesidad de tenerla disponible en varios idiomas. Existen varias maneras de encarar este problema, pero en la mayoría de ellas requieren de bastante trabajo, no sólo para implementarla sino principalmente para mantenerla actualizada durante los mantenimientos sucesivos de la aplicación. El generador "myappgen" resuelve el problema de una forma sumamente simple, de hecho el desarrollo de la aplicación se hace en el idioma que usted habla sin preocuparse de los otros idiomas. Después de haber terminado el desarrollo de la aplicación e incluso cuando ya se está utilizando se pueden crear tantos glosarios de idiomas como fuesen necesarios y la aplicación funcionará indistintamente en cualquiera de ellos sin tener que hacer ningún tipo de mantenimiento. Esto es posible porque al generar la aplicación se crea un diccionario que contiene todas las palabras o textos que se utilizan en la aplicación. De esta manera, en cualquier momento, incluso cuando la aplicación ya se encuentra en producción, se puede editar este diccionario, crear un glosario para el nuevo idioma, traducir todas las palabras, y a partir de ese momento la misma aplicación funcionará indistintamente en cualquiera de los dos idiomas sin necesidad de hacer ningún tipo de mantenimiento. Es más, como no se necesita hacer mantenimiento, este trabajo no necesita ser hecho por el analista sino que simplemente lo puede hacer el usuario administrador de la aplicación. 7. Auditoría, DocumentMgr, , Importación/Exportación, Consola de Usuarios No es necesario hacer ningún trabajo de programación de estos módulos, basta con habilitarlos al crear la aplicación para que sean incorporados a todos los programas y funcionen totalmente integrados como si hubiesen sido programados especialmente para ellos. Espero que con esta explicación resumida, usted haya podido tener una visión de contexto del funcionamiento del generador en todo el proceso de construcción, compilación y distribución de una aplicación. Ahora trataremos detalladamente cada una de las funciones que describimos anteriormente.

15 myapplicationgenerator, explicación detallada En la figura de abajo, mostramos la pantalla principal de myappgen, donde se pueden ver las funciones que nos permiten construir sofisticadas aplicaciones orientadas al manejo de base de datos; con esta única interfase se realiza todo el trabajo; no es necesario ejecutar ningún otro programa, inclusive la compilación y copia de todos los archivos necesarios para la distribución se hace con esta única interfase. A continuación explicamos detalladamente el funcionamiento de "myappgen", mostrando cada pantalla y describiendo sus funciones. Crear aplicación Importar de la base de datos Conectar con base de datos Crear database, table, key, relations Crear files, fields, keys, relations Ejecutar/construir aplicación Reconstruir aplicación Generar código fuente, compilar y distribuir Formulas El proceso de construcción de la aplicación empieza con la creación del diccionario; el diccionario es el repositorio que contiene el modelo lógico de datos (tablas, campos, claves, relaciones, fórmulas), así como también el modelo lógico de las aplicaciones (menú, browse, form, query, querytotal, report, reporttotal, process). Es importante aclarar que con un modelo lógico de datos se pueden definir varias aplicaciones y todo este conjunto se encuentra en un único archivo.dct.

16 A continuación describimos algunas características importantes del generador: - Integridad/Sincronismo (modelo de datos aplicaciones) Gracias a esta funcionalidad cualquier cambio en el modelo lógico de datos se refleja automáticamente en todos los programas de todas las aplicaciones definidas en el diccionario. Así, si usted modifica el nombre de un campo, su prompt, título, tipo de dato, longitud, validación, valor inicial, fórmula, etc., estos cambios serán aplicados en todos los programas de todas las aplicaciones construidas en el diccionario. Incluso si se realizan cambios más radicales como borrar un campo o aún más, como borrar un archivo o borrar un relacionamiento, también se mantendrá la integridad, modificándose también radicalmente las aplicaciones de acuerdo al nuevo modelo de datos. Observación: Este mecanismo es muy útil cuando se está abordando el desarrollo de la aplicación por medio de la construcción de prototipos sucesivos. En este caso, hacer modificaciones de este tipo no constituye ningún riesgo ya que los programas no tienen ninguna importancia más que la de aproximarnos a las necesidades del usuario. Sin embargo, no es recomendable utilizarlo con aplicaciones ya terminadas que se encuentran en producción; en este caso si fuese necesario, tome las medidas de seguridad y guarde una copia de la aplicación antes de hacer ningún cambio. - Crash Recovery Si el sistema cae mientras está trabajando, usted sólo corre el riesgo de perder los cambios que realizó en los últimos 30 segundos, ya que el resto es recuperado automáticamente al volver a ejecutar el diccionario. Esto ocurre gracias a que myappgen cuenta con un agente que está vigilando todas las modificaciones que se realizan y si es necesario, cada 30 segundos las graba en un archivo de recuperación. - Backup Todos las definiciones necesarias para la generación de la aplicación, se encuentran en un único archivo *.dct; haciendo backup de este archivo, podemos volver a generar todas las aplicaciones definidas en el diccionario. Por otro lado, el sistema nos ayuda haciendo backup automáticamente utilizando el siguiente procedimiento: En la carpeta donde se crea el diccionario, el sistema crea una subcarpeta con el nombre de Backup; en esta carpeta, se guardan automáticamente las diez últimas versiones del diccionario, que corresponden a las diez últimas veces que usted grabó el diccionario. Además, dentro de esta carpeta, se encuentra otra subcarpeta con el nombre de Daily, en donde se tiene la última versión de cada día.

17 Creación del diccionario de datos Se selecciona la carpeta y se define el nombre del diccionario de datos. Dentro de esta carpeta, el generador creará una carpeta para cada aplicación definida en ese diccionario y dentro de esa carpeta, se crearán todas las subcarpetas necesarias para la construcción, generación de los programas fuentes, compilación y distribución de la aplicación. Una vez creado el diccionario, lo primero que se debe definir es la conexión con la base de datos. Sin embargo, establecer la conexión con la base de datos no suele ser muy simple, ya que tenemos que instalar varios softwares y configurarlos para que todos funcionen integradamente. Para evitar estas complicaciones, al instalar myappgen, también se instala una versión de desarrollo de la base de datos mysql con su driver JDBC, totalmente configurado para que funcionen en forma integrada. Así, al crear un nuevo diccionario, ya está definida esta conexión y usted podrá trabajar sin más trámites en el desarrollo de la nueva aplicación. En caso necesario, puede utilizar la interfase que se muestra en la figura de abajo, para modificar la conexión o crear otras conexiones con otras bases de datos (mysql, Oracle, Db2, Informix, SqlServer, etc). De hecho, el diccionario puede tener varias conexiones activas, incluso con distintas bases de datos. Es más, podemos construir aplicaciones que funcionen con varias bases de datos a la vez. Sin embargo, es recomendable que la aplicación actualice tablas de una sola conexión, ya que no se cuenta con procesamiento de transacciones entre distintas bases de datos. Conexión con la Base de Datos Para establecer la conexión, la base de datos debe estar instalada y en funcionamiento, además se debe conocer el valor de los parámetros de conexión, tales como el Host, Port, Database, User, Password. Si usted instaló la base de datos, por favor tome nota de estos valores, en caso contrario, consulte con el administrador.

18 - Host: Es el nombre del servidor donde está funcionando la base de datos. - Port: Es el puerto donde la base de datos escucha los pedidos de información. - Database: Es el nombre de una Database y/o Schema definido en la base de datos. Dentro de la base de datos se crean particiones llamadas Database y/o Schema y dentro de estas particiones se crean las tablas, campos, claves, etc. Cuando nos conectamos a la base de datos debemos especificar con cual partición deseamos conectarnos. Esto no quiere decir que no tengamos acceso a los datos que se encuentran en otras particiones, ya que el acceso esta definido por el perfil del usuario. - User: Es un usuario definido en la base de datos. Si no se trata de la base de datos de producción, es deseable que el usuario tenga accesos para creación, modificación o borrado de Database, Schema, Tablas, Campos, Indices, Restricciones. - Password: Es el password del usuario creado en la base de datos. Driver JDBC: Para conectarse con la base de datos es imprescindible contar con el driver correspondiente. El driver es un archivo con extensión jar y es proporcionado por el fabricante de la base de datos. Normalmente, se encuentra disponible al instalar la base de datos en alguna subcarpeta relacionada a java o jdbc. Si no lo encuentra puede hacer download del sitio del fabricante. El driver (*.jar) se debe copiar en la carpeta /myappgen/ rt/lib/ext Para las Bases de Datos (mysql, Oracle, SqlServer, DB2, Informix), podemos seleccionar el driver de la lista que nos propone los valores estándar de los parámetros de conexión, pero lastimosamente, esto no garantiza que se pueda establecer la conexión, ya que el valor de estos parámetros depende de lo que fue especificado en el momento de la instalación de la base de datos. Si no consigue establecer la conexión, asegúrese de que el driver (archivo jar) esté copiado en la carpeta /myappgen/rt/lib/ext, lea la documentación del driver y asegúrese que está utilizando los parámetros correctos: Driver, Host, Port, Database, Url, User, Password. El DatabaseUrl, puede ser modificado presionando ; además, usted puede escribir en forma genérica utilizando las etiquetas <HOST>, <PORT>, <DB> como variables de sustitución. Observación: Establecer la conexión con alguna base de datos es imprescindible para iniciar la construcción de la aplicación. Si no consigue hacerlo, consulte con el profesional encargado de la administración de la Base de Datos. De todos modos, puede iniciar el desarrollo utilizando la conexión con la base de datos mysql que trae por default cuando se crea el diccionario.

19 Definición del Modelo Lógico de Datos Después de crear un nuevo diccionario, se despliega la pantalla que se muestra en la figura de abajo. Para continuar con el desarrollo, debemos definir el modelo lógico de datos (tablas, campos, claves, relacionamientos). Esto podemos hacerlo de tres maneras distintas: registro manual, importación de la base de datos y por último copiar de otro diccionario y pegar en el diccionario actual. A continuación describimos estos tres mecanismos: 1. Registro Manual Se utilizan las interfases visuales del sistema para el registro de las propiedades de Database, Files, Fields, Keys y Relations. Para registrar estos elementos debemos seleccionar el Tab correspondiente y oprimir los botones,,. Database: En las Bases de Datos, las tablas, campos, claves y relacionamientos se encuentran dentro de particiones llamadas Schemas y/o Database; por lo tanto, para registrar estos elementos, primero debemos crear la definición lógica de estas particiones. Para hacerlo, seleccionar el nombre del diccionario en el panel de la izquierda y presionar El nombre de esta partición es agregado automáticamente al nombre físico de las tablas. Para modificarlo se selecciona la partición y se oprime el botón ; modificado el nombre de la partición, se modifica también el prefijo del nombre físico de todas las tablas de esa partición; sin embargo, para borrar la partición, primero se deben borrar todas las tablas de esa partición.

20 Definición de Tablas Para registrar manualmente una nueva tabla, debemos seleccionar la base de datos en el panel de la izquierda, el tab Files en el panel de la derecha y luego oprimir el botón, desplegándose la pantalla que se muestra en la figura de abajo. A continuación pasamos a describir los atributos: Para todos los elementos de la base de datos (Files, Fields, Keys), el sistema maneja dos nombres, el nombre físico y el nombre lógico. El nombre físico es el nombre que tiene el elemento en la base de datos, mientras que el nombre lógico es el nombre con el que nos referimos a ellos en los programas de la aplicación. Se crea esta dualidad porque muchas veces los administradores de las bases de datos utilizan convenciones técnicas que hacen que el nombre físico sea complejo y sobre todo inexpresivo. - Table Name: Es el nombre lógico de la tabla, el que utilizamos en todos los programas de la aplicación para referirnos a ella, e incluso lo utilizamos al escribir las sentencias SQL. Existen algunas reglas para escribir el nombre lógico, tales como: no puede haber nombres lógicos repetidos en el diccionario; ellos deben empezar con minúsculas y no deben tener espacios o caracteres especiales. (Usted no necesita preocuparse en memorizar estas reglas, ya que el sistema se encargará de avisarle si no se cumplen.) - Prefix: Es el alias de la tabla. En las sentencias SQL, cuando se manejan varias tablas, es necesario cualificar a los campos para aclarar la tabla a la que pertenecen. Esto se hace utilizando el Prefix. En myappgen, todos los campos están compuestos por el Prefix de la tabla seguido del nombre del campo; ejemplo: cus.name, es el campo name de la tabla Customer cuyo Prefix es cus. - Database Table Name: Es el nombre físico de la tabla definido en la base de datos, siguiendo reglas del administrador de la base de datos. Como en los programas se utiliza el nombre lógico, y la base de datos solo entiende el nombre físico, el sistema traduce las sentencias SQL, pasando de nombre lógico a nombre físico. - Database Driver: Indica la Base de Datos (mysql, Oracle, SqlServer, Db2, Informix, etc) en la que se encuentra la tabla. Específicamente, es la conexión con la base de datos.

21 - Entity Package: Es buena práctica agrupar los programas por funcionalidad, tales como, Contabilidad, Compras, Ventas, DatosMaestros, etc. El Package, asociado a las tablas, nos permite agrupar los programas creados con esas tablas en subcarpetas o Packages. - Config Table (one record, global data): Resulta muy útil cuando se necesitan variables globales que deben estar disponibles en toda la aplicación. Además tiene la ventaja que sus valores pueden ser grabados. Se trata de una tabla con un solo registro en donde las variables globales son los campos de la tabla. - Embed code enabled: Habilitando esta propiedad podemos insertar códigos fuentes Embed Code en diversos puntos dentro del objeto Entity que representa a la tabla así como también en todos los Browse(s) y Form(s) construidos con esa tabla como archivo principal. Si el código fuente no es aplicable en algún Browse o Form, se podrá deshabilitarlo específicamente en ese programa editando sus propiedades. - Cancel instead of delete record: Al habilitar esta opción, la operación de borrar el registro se transforma en anulación. Esto es especialmente útil en el caso de facturas y otros documentos emitidos que por disposiciones legales no pueden ser borrados; estos documentos sólo pueden ser anulados. El proceso de anulación aplica todas las reglas de negocio correspondientes al borrado, dejando el registro marcado como anulado. Con esta propiedad usted automatiza el proceso de anulación de registros y se evita todo el costo de programación. Para la implementación, es imprescindible la definición de un campo con validación del tipo true/false. El valor true, significará que el registro fue anulado. - Record change locked: Indica que deseamos inhibir la modificación de un registro. Por ejemplo: si la factura fue emitida, entonces ya no puede ser modificada. Es imprescindible la definición de un campo con validación del tipo true/false. El valor true, significará que el registro no puede ser modificado. - Record delete locked: Semejante al atributo anterior, permite inhibir el borrado de un registro; en el caso de la factura emitida la misma queda llaveada y ya no puede borrarse. Es imprescindible la definición de un campo con validación del tipo true/false. El valor true, significará que el registro no puede ser borrado. - Enable Export Data to txt file: permite habilitar que los datos de esta tabla puedan ser exportados. - Enable Import Data to txt file: habilita la importación de datos a esta tabla. Si al crear la aplicación se habilita en "Extension modules" la opción de Exportación/Importación, entonces el generador construirá los programas necesarios para exportar/importar todos los archivos que hayan sido habilitados. - Menu Text: Cuando desde el menú se llama a un programa que tiene como archivo principal a esta tabla, el generador utilizará este texto para crear el menú Item. Lo recomendable es simplemente utilizar el nombre de la Entity (Cliente, Producto, Vendedor, Factura, Stock, etc.) - Button Icon: Es el ícono que tendrá el botón de navegación hacia los programas que tengan esta tabla como archivo primario (Browse, Report). - Button Text: Es idéntico a Menú Text, pero aplicado a botones de navegación. - Button ToolTips: Es el tip que se despliega al poner el mouse sobre el botón. En realidad, al digitar el nombre lógico, el sistema propone el valor de todas las otras propiedades, por lo que usted puede simplemente aceptar o corregir las que fuesen necesarias.

22 Al presionar tab se completan los demás atributos Al oprimir Ok se registra la tabla y automáticamente el sistema selecciona el tab Fields y pasa al registro de los campos de la tabla. Definición de Campos A continuación pasamos a describir los atributos. Al igual que las tablas, también los campos tienen nombre lógico y nombre físico. El nombre lógico es el utilizado en la aplicación y el físico es el verdadero nombre del campo en la base de datos. - Field Name: Es el nombre lógico del campo utilizado en toda la aplicación, incluso al escribir las sentencias SQL. Existen algunas reglas, tales como: el nombre lógico debe empezar con minúscula, no puede tener espacios en blanco o caracteres especiales y no puede estar repetido en la misma tabla.

23 - Db Field Name: Es el nombre físico del campo en la base de datos, que debe seguir las reglas de la base de datos que está siendo utilizada. El mayor cuidado que debemos tener es el de evitar utilizar nombres que podrían ser palabras reservadas en la base de datos, tales como SUM, Date, Time, Select, etc. Aunque el sistema hace estas verificaciones, no se puede garantizar que todas las palabras reservadas de todas las bases de datos estén contempladas. Si utiliza alguna palabra reservada, ocurrirá un error al crear físicamente la base de datos. - Prompt Text: Es el título del campo que se utiliza al construir las pantallas de entrada de datos. Aunque puede estar compuesto por varias palabras, debe ser corto y conciso. Recuerde que cuanto más largo sea el prompt, menos longitud podrá tener el campo de entrada de datos. - Column Heading: Es el título del campo que se utiliza en las columnas de las listas y en las columnas de los informes. Si el dato es corto, trate de utilizar un título corto, ya que el ancho de la columna es el mayor valor entre el ancho del título y el ancho del dato. - Tips: Es el mensaje que se despliega al poner el Mouse sobre el campo. - Data Type: Es el tipo de datos que puede ser: String, Number, Date-Time, Date, Time, Memo, Image. Cuando se crea el campo en la base de datos, se reduce al tipo de dato más conveniente; cuando se importa de la base de datos, siempre se reduce a uno de los siete tipos mencionados. - Data Size: Es la longitud del dato; la longitud máxima varía de acuerdo a la base de datos que se está utilizando. La máxima longitud del campo numérico en una base de datos puede ser de 17, en otras de 30 y en otras de 38. En el caso de Date-Time, Date, Time, no es necesario indicar la longitud. - Dec.: Es la cantidad de decimales que tendrá el campo numérico. Data Size es la longitud total e incluye los decimales. Así, en un campo numérico con Data Size = 4 y Dec.=1, podrá tener tres enteros y un decimal. - Picture: Es el formato de impresión/display del campo. Para campos del tipo fecha, es recomendable dejar el valor estándar, entonces el sistema utiliza el formato definido en la configuración regional del computador. - Include as Browse Column: Si se desmarca, el campo no será incluido como columna en la propuesta de Browse construida por el generador. Usted tendrá que agregarlo explícitamente en la pantalla que lo necesite. - Include as Form Field: Si se desmarca, el campo no será incluido en la propuesta de Form construida por el generador, a no ser que el campo sea requerido o sea un componente de la clave foránea de otro archivo. En estos casos, de todos modos será incluido en el Form de actualización de datos. - Validity Check: Las validaciones pueden ser: No Check, sin validación; No Blank, no permite dejar el campo sin cargar algún valor; Range, el valor debe estar dentro del rango definido; True/False, puede tener sólo dos valores y el componente visual utilizado al generar la aplicación es el CheckBox; List Values, el valor debe ser uno de los definidos en la lista y el componente visual es el ComboBox. - Type: Es el tipo de componente visual que será utilizado al generar la aplicación. Dependiendo de la validación puede ser Entry, CheckBox, ComboBox o del tipo formula. Las fórmulas pueden ser del tipo: o formulacurrent: expresión de campos del mismo registro. o formulaup: expresión de campos de su archivo hijo (con cada operación en el archivo hijo, se actualiza la fórmula en el archivo padre)

24 o formuladown: expresión de campos de su archivo padre (con cada operación en el archivo padre se actualiza la fórmula en todos sus registros hijos) o formulaentry: conjunto de expresiones que pueden utilizar indistintamente campos del mismo registro o de otros archivos (padres o de configuración). El contenido de la formulaentry se ejecuta cada vez que el campo que posee la fórmula gana o pierde foco. De esta manera, usted puede definir el modelo lógico de datos con campos del tipo formula y obtener el mismo comportamiento que una planilla de cálculo. Los programas sólo se encargarán de actualizar los registros, y todas las operaciones entre archivos se realizarán automáticamente. - Caps: Puede ser Normal, Uppercase, Lowercase - Type: Puede ser Normal, ReadOnly - Initial Value: Es el valor con que es inicializado este campo en el formulario de carga de datos al crear un nuevo registro. Después de haber digitado el nombre lógico del campo, el sistema carga automáticamente todas las demás propiedades. Al oprimir el botón OK, se agrega el campo a la tabla y se vuelve a desplegar la misma pantalla para seguir agregando otros campos. Si desea dejar de agregar campos, presione el botón Cancel. Para continuar agregando campos a una tabla, seleccione la tabla en el panel de la izquierda, luego seleccione el Tab Fields, y oprima el botón correspondiente. Al definir campos de la clave foránea, o campos que deben ser idénticos a otros ya definidos en otras tablas, se puede crear una referencia al campo de la tabla original. En este caso, los atributos se cargan automáticamente. La ventaja no es solamente la carga de los atributos, sino principalmente la garantía que al modificar el campo original, se modifiquen los campos referenciados en las demás tablas. Para crear una referencia a un campo, se oprime el botón que se indica en la figura y se selecciona el campo original. Para sincronizar las modificaciones podemos utilizar las funciones de Distribute y Refresh. La función Distribute toma las propiedades del campo y las distribuye a todos los campos referenciados, mientras que la función Refresh trae las propiedades al campo seleccionado.

25 Las funciones Distribute y Refresh pueden ser aplicadas a nivel de archivos o campos. Por ejemplo, se selecciona el archivo Country, se oprime right clic y se selecciona Distribute. En este caso, el archivo Country distribuye los atributos de los campos referenciados a otros archivos. Antes de distribuir se despliega la pantalla que se muestra en la figura, donde se pueden seleccionar los atributos que se desean distribuir, e incluso campo a campo se puede decidir si se aplica la distribución o se pasa al siguiente campo.

26 Definición de Claves Para definir las claves, en el panel de la izquierda se selecciona el archivo, en el panel de la derecha se selecciona el Tab Keys y luego se oprime el botón, desplegándose la pantalla que se muestra en la figura de abajo. Para que los archivos puedan ser utilizados, deben obligatoriamente tener definida su clave primaria, en caso contrario, no se podrá construir la aplicación. Si el último componente de la clave primaria es numérico, la clave podrá ser definida como Auto Number; en este caso, la aplicación agregará el algoritmo necesario para auto numerar este campo, cada vez que se agreguen registros a la tabla. Definición de Relaciones Para definir las relaciones, en el panel de la izquierda se selecciona el archivo, en el panel de la derecha se selecciona el Tab Relations y luego se oprime el botón, desplegándose la pantalla que se muestra en la figura de abajo. Cardinalidad del relacionamiento Archivo destino Select Country Fields Select City Fields

27 Observación: Para poder construir las aplicaciones con myappgen, es fundamental la definición correcta y completa de los relacionamientos; myappgen utiliza el modelo relacional para que sus templates puedan construir la aplicación. La definición incorrecta o incompleta llevará necesariamente a la construcción incorrecta o incompleta de la aplicación. Es importante aclarar que no es obligatorio crear los relacionamientos físicamente en la base de datos, pero sí deben estar definidos en el diccionario. Definición de Fórmulas Los campos tipo fórmula se calculan automáticamente a medida que se cargan, modifican o borran los datos en las tablas. De esta manera, los programas sólo se encargarán de actualizar los registros, y todas las operaciones entre archivos se realizarán automáticamente. Una fórmula puede ser escrita en función al resultado de otra fórmula; en este caso, debemos tener el cuidado de ordenar los campos en el orden en que deben ejecutarse las fórmulas. Las fórmulas se escriben siguiendo la sintaxis del lenguaje JAVA; es más, se puede escribir todo un algoritmo en lenguaje JAVA para evaluar su resultado. FormulaCurrent: expresión de campos del mismo registro deben ser del tipo (campo = expresión); no puede ser acumulativa (campo += expresión), (campo -= expresión). Por medio de una formulacurrent también podemos cambiar las siguientes propiedades de los campos: Enabled, Editable, Focusable, Foreground, Background, Font, Icon. O inclusive indicar la inhabilitación de las acciones de Add, Change, Delete en el formulario en el cual opera esta fórmula. A veces es necesario que el campo sigua permitiendo la entrada de datos y utilizar la fórmula para modificar otras propiedades de ese campo o de otros campos del registro. En este caso simplemente se desmarca la opción de Display only y se escribe la fórmula correspondiente.

28 FormulaUp: Es una expresión de campos de su archivo hijo (con cada operación en el archivo hijo, se actualiza la fórmula en el archivo padre); deben ser del tipo acumulativo (campo += expresión) (campo -= expresión). En este caso se debe escribir la fórmula para Insert y la operación inversa que se utilizará para Delete: si por Insert, sumamos, por Delete, debemos restar. Cuando se escribe la fórmula que se aplicará por Insert, el generador deduce la fórmula por Delete, y la escribe automáticamente. En casos complejos, esto no es posible y usted tendrá que escribir ambas expresiones. Para esto, en el combo box seleccione Free. formuladown: expresión de campos de su archivo padre (con cada operación en el archivo padre, se actualiza la fórmula en todos sus registros hijos); debe ser del tipo (campo = expresión) y no puede ser acumulativa (campo += expresión), (campo -= expresión). formulaentry: conjunto de expresiones que pueden utilizar indistintamente campos del mismo registro o de otros archivos (padres o de configuración). El contenido de la formulaentry se ejecuta cada vez que el campo que posee la fórmula gana o pierde foco. También podemos cambiar las siguientes propiedades de los campos: Enabled, Editable, Focusable, Foreground, Background, Font, Icon.

29 Funcionamiento de Campos Fórmulas En la figura de abajo se muestra como funciona el proceso automático de actualización de los campos fórmulas. En general, podemos decir que al actualizar una tabla, se produce una cadena de actualizaciones en las otras que dependen de ella. Así, si actualizamos Item, se actualizan Order y Stock. Pero, por el hecho de actualizar Order, se actualizan Customer y Vendor. Todo este proceso se realiza automáticamente, cubriendo todas las variaciones que podrían surgir al agregar, modificar o borrar registros de cualquier tabla. Imagínese el complejo proceso de actualizaciones necesario al editar un ítem y modificar el código del producto, la cantidad, y el precio; pues bien, todo el proceso para recalcular estos valores se realizará automáticamente. Country City ProductGrp Vendor Customer Product Order Stock Item Formula Up: Al agregar, modificar o borrar Item, se actualizan Order y Stock. Al actualizar Order, se actualizan Customer y Vendor. Formula Current: Al agregar Item, calcula otros campos Item. Formula Down: Al modificar en Order el campo de fórmula Down, se actualizan todos sus Ítems, y por cada item se vuelven a actualizar Order y Stock y a su vez, al actualizar Order se actualizan Customer y Vendor. Evidentemente, cuando el modelo de datos tiene muchas fórmulas, podría ser difícil saber como se calcula un campo; sin embargo, es muy fácil gracias a la información disponible en el Tab View Formulas. En esta pantalla se muestran todos los archivos que tienen campos fórmulas y para cada uno de ellos, toda la cadena de actualización. Así, al seleccionar Customer, podemos ver que OrderItem, actualiza a Order y Order actualiza a Customer. Al seleccionar el archivo, en el panel de abajo se muestran los campos fórmulas y el archivo que los actualiza; a su vez, para cada campo fórmula, en el panel de abajo se muestra la fórmula. Secuencia de actualización Campos fórmulas del archivo seleccionado Fórmula del campo seleccionado

30 2. Importación de la Base de Datos La segunda manera de construir el modelo lógico de datos es mucho más rápida y consiste en la importación de la base de datos. En este caso, el generador lee los metadatos de la base de datos y con esta información, crea la definición lógica de las tablas, campos, claves y relaciones. Entonces solamente tenemos que verificar el modelo lógico, y si es necesario, corregir los atributos, agregar validaciones y probablemente los campos del tipo fórmulas, ya que estos no se encuentran definidos en la base de datos. Para importar se presiona el botón. Tablas seleccionadas Conexión con la base de datos Tablas disponibles en la conexión elegida Tablas Importadas

31 3. Copia de otro Diccionario (External Copy) También se puede definir el modelo lógico de datos copiando las definiciones de otros diccionarios definidos anteriormente. Aquí la ventaja es que los campos tienen correctamente definidos sus atributos, validaciones y fórmulas. Ya tenemos definidos los archivos Country y City, y ahora vamos a agregar el resto. Como se puede ver en la figura de arriba, se seleccionan los archivos y luego se presiona el botón copy. Por último, se selecciona el Tab Files y se presiona el botón paste.

32 Al copiar los archivos, también se copian los campos, las claves y las relaciones; incluso, las relaciones con los archivos que ya existían, en este caso, Country con Customer. Siguiendo un procedimiento similar, también se pueden copiar las definiciones de los campos. Observación: Como se puede ver en la figura de arriba, al copiar los campos, se copian todos sus atributos, inclusive las fórmulas. Usted debe verificar y eventualmente corregir o borrar las fórmulas, ya que pueden contener referencias a campos o archivos que no existen en su diccionario.

33 Definición del Modelo Físico de Datos A partir del modelo lógico de datos se generan y luego se ejecutan las sentencias SQL que crean las tablas, campos, índices y restricciones en la base de datos (mysql, Oracle, Db2, SqlServer, Informix, etc). El botón crea una nueva estructura vacía de datos. Si ya existe, borra la estructura anterior con todos sus datos y luego la vuelve a crear con la nueva definición. El botón actualiza la estructura. Para establecer la sincronización entre los datos del diccionario y la base de datos, se utiliza el nombre físico del componente; entonces, si se lo encuentra en la base de datos, se lo modifica, dejándolo igual al del diccionario; si no se lo encuentra, se crea el componente con la definición contenida en el diccionario. Con este proceso no se borran los campos que existen en la base de datos y no existen en el diccionario; tampoco se borran los datos que se encuentran en la base de datos, sino simplemente se modifica la estructura, haciendo que contenga la definición del diccionario. El botón borra la estructura en la base de datos con todo su contenido. Con los botones Select y UnSelect, puede seleccionar las sentencias SQL que desea ejecutar. Si no tiene los permisos necesarios en la base de datos para ejecutar estas sentencias, puede exportarlas a un archivo y enviar éste para que lo ejecute el administrador de la base de datos. Observación: Las sentencias SQL no son tan estándar como deberían; las bases de datos tienen distintos tipos de datos, distintas palabras reservadas e incluso distintas sintaxis para escribir la misma sentencia; myappgen ha sido probado con mysql, Oracle, Db2, SqlServer, Informix y se han ajustado estas diferencias. Para otras bases de datos, se generan las sentencias con la sintaxis estándar, por lo que estamos expuestos a pequeñas diferencias que podrían ocasionar errores de sintaxis al ejecutar las sentencias. En este caso, exporte la definición, edite el archivo, haga las correcciones necesarias y luego ejecute desde la consola de administración de la base de datos.

34 Tablas del Sistema Las aplicaciones construidas con myappgen, podrán estar integradas con los módulos de seguridad, auditoría, correo, anexo de documentos, consola de administración de usuarios, etc. Para que esto ocurra, usted no tendrá que construir estos módulos, ni siquiera tendrá que diseñar sus archivos. Simplemente los habilitará y ellos estarán totalmente integrados a su aplicación, con todas las funcionalidades, como si hubiesen sido construidos especialmente para su aplicación. Para que esto sea posible, el generador necesita la definición de varias tablas, campos y relaciones. Cuando se crea un nuevo diccionario de datos, aparentemente se encuentra vacío, pero no es así, ya que el diccionario tiene la definición de todas las tablas del sistema necesarias para la implementación de estos módulos. En System, tenemos varias tablas, campos Aparentemente vacío, sin tablas, campos, etc Las tablas del sistema están disponibles en el diccionario, se puede acceder a su definición seleccionando System Tables. Pero no sólo deben estar disponibles en el modelo lógico, además deben estar creadas físicamente en la base de datos utilizada. Creación física de las tablas en la base de datos Observación: Si usted está utilizando la versión de desarrollo de la base de datos mysql instalada por myappgen, entonces ya están creadas todas las tablas y además están cargados los datos para configurar los módulos. En este caso, no debe crear las tablas, porque borrará todos los datos y tendrá que configurar de nuevo todos los módulos.

35 Tratamiento de Datos Siempre es útil ver el contenido e incluso poder agregar, modificar o borrar datos en las tablas. Para esto podemos utilizar el Tab Data, en donde, al seleccionar la tabla en el panel de la izquierda, se despliega la lista de los datos de la tabla en el panel de la derecha. Además, tenemos disponibles los botones para agregar, modificar y borrar registros, así como también para emitir informes. Como estamos trabajando con un generador de aplicaciones, entonces no nos debe extrañar que las pantallas de carga de datos sean mucho más sofisticadas que las que habitualmente encontramos en los utilitarios que nos permiten acceder a los datos de la base de datos. Así, en estas pantallas las validaciones están activas, los botones de lookup despliegan la lista correspondiente para seleccionar el registro, los campos fórmulas están en funcionamiento y los campos memos se encuentran disponibles en Tabs independientes. Memos Lookup button Formulas El nivel de sofisticación de las pantallas de carga de datos es tal que incluso las funcionalidades más complejas definidas para una tabla se encuentran disponibles. Así tenemos las opciones de cancelación y llaveo de registros, cálculo de las fórmulas e incluso la ejecución del código fuente asociado a las Entitys, Browse, Form y Reports, funcionan exactamente igual que en las aplicaciones generadas.

36

37 Por otra parte en el ejemplo de la siguiente figura podemos observar que una tabla definida como de configuración de parámetros de la aplicación puede ser actualizada directamente desde el diccionario, igual que cualquier otra tabla. En el Tab Data las funciones de configuración e impresión, son semejantes a las que se utilizan en el proceso de definición de la aplicación, por lo que las veremos detalladamente más adelante. Por ahora, lo que sabemos es que podemos imprimir informes y configurarlos para seleccionar las columnas, definir filtros, cortes de control, con subtotales y total general.

38 Exportación de Datos Muchas veces es útil exportar los datos de las tablas para utilizarlos externamente, o para volver a importarlos en otra base de datos. El proceso de exportación es sumamente simple: se marcan todos los archivos que se desean exportar y luego se presiona el botón Export de la parte inferior de la pantalla. Los campos normales se exportan en archivos de texto, con extensión txt. En el archivo txt, el primer renglón corresponde al nombre lógico de los campos y los siguientes renglones son los datos; los campos se encuentran separados por el caracter TAB. Los campos memos y binarios, se encuentran agrupados en carpetas con el nombre del archivo al que pertenecen y dentro de las carpetas, cada campo memo se encuentra en archivos independientes. El nombre del archivo es el nombre del campo, seguido de la clave primaria del registro. Los campos memos tienen extensión html, mientras que los campos binarios tienen extensión binary. Campos memos y binarios Campos normales en archivos txt

39 Importación de Datos La importación toma como fuente de datos a los archivos exportados o archivos con las mismas características que los utilizados en la exportación; esto es, los campos normales se encuentran en archivos con el nombre lógico de la tabla y extensión txt, el primer renglón corresponde al nombre lógico de los campos y en los siguientes renglones se encuentran los datos separados por el caracter TAB. Los campos memos y binarios, se encuentran agrupados en carpetas con el nombre del archivo al que pertenecen y dentro de estas carpetas, cada campo memo se encuentra en archivos independientes. El nombre del archivo es el nombre del campo, seguido de la clave primaria del registro. Los campos memos tienen extensión html, mientras que los campos binarios tienen extensión binary. El proceso de importación es sumamente simple, se marcan todos los archivos que se desean importar y luego se presiona el botón Import de la parte inferior de la pantalla. Para importar se tienen tres opciones, que pueden marcarse independientemente. Esto nos permite: Borrar, borrar e insertar, insertar, insertar y actualizar, y sólo actualizar. Al realizar la importación, el sistema tiene en cuenta las relaciones entre los archivos, así, cuando borra los registros, primero lo hace en las tablas hijos y luego en las tablas padres, mientras que al insertar, primero lo hace en las tablas padres y después en las tablas hijos. Si ocurre algún error durante la importación, el sistema revierte toda la transacción y deja los archivos como se encontraban antes de iniciar la importación. El proceso de exportación e importación de datos es especialmente útil cuando se necesita migrar datos entre bases de datos distintas. Supongamos que tenemos los datos en mysql y necesitamos crear las mismas tablas, con los mismos datos en DB2. Entonces podemos proceder de la siguiente manera: 1. En mysql exportamos todos los datos. 2. Creamos la conexión con la base de datos DB2. 3. Modificamos todas las tablas asignando el driver DB2. 4. Creamos el modelo físico de datos en DB2 5. Importamos los datos. A continuación mostraremos detalladamente como se realiza este proceso.

40 1. En mysql exportamos todos los datos. 2. Creación de la Conexión con la Base de Datos DB2

41 3. Modificamos todas las tablas asignando el driver DB2. Seleccionar todas las tablas, presionar, seleccionar el checkbox Database, seleccionar IBM_DB2 4. Crear Modelo Físico de Datos en DB2

42 5. Importar los Datos Se marcan todas las tablas y se oprime el botón Import. Observación: En DB2, los caracteres acentuados consumen dos caracteres. Esto puede ocasionar el error que se muestra en la figura. Tal vez se pueda corregir esta anomalía, eligiendo otro caracter set al configurar la base de datos DB2. Para ver los datos importados, podemos seleccionar la tabla y seleccionar el tab Data.