Advertencia

Si no se respeta las recomendaciones anteriores, podría ejecutar procesos de incorrectos de consultas y en su eventual caso, bloquear la base de datos o poner lento el acceso al sistema durante su ejecución. 

AKTEK, NO se hace responsable por el uso que se le dé a la funcionalidad de por datos:

• Problemas de rendimiento por la afectación que pueda hacer alguna consulta creada de forma incorrecta
• Problema en los datos que pueda generarse por un uso indebido de la programación consulta a la base de datos.
• Problema de confidencialidad de la información que pueda generarse por un uso indebido de la información que extraigan los usuarios autorizado a ingresar, extraer datos de la consulta.

Introducción

Este proceso indica los pasos que se deben realizar para crear un reporte dinámico en el sistema AVATAR.

Prerrequisitos

• Conocer el modelo de base de datos del sistema AVATAR.

• Manejar el lenguaje SQL para crear las consultas según la necesidad por cubrir.

• Para generar un reporte con más formato y presentación, hay que hacerlo con el sistema iReport versión 3.75 que sirve para para crear y editar reportes, el cual es la versión que soporta AVATAR, adicionalmente contar las librerías de Java 7. 

https://sourceforge.net/projects/ireport/files/iReport/iReport-3.7.5/

• Existen tutoriales de la como generar y configurar la herramienta, se recomienda ver este como ejemplo para iniciar.

https://www.youtube.com/watch?v=VZ1Y7cxQFFY

Cómo crear un Reporte Dinámico

1. Ingrese en el módulo de Seguridad -> Desarrollo-> Exportar Datos.

2. Presionar en el botón de AGREGAR

3. Los pasos que se deben ejecutar son los siguientes:

4. Indicar el Descripción
   • Esta descripción será la que se utilizara para colocar el nombre del submenú, por tanto, se recomienda que se han breves e intuitivas.
   • NO se puede incluir tildes o caracteres
5. Consulta del Reporte, aquí se debe digitar la consulta SQL que se desea realizar para la generación de la extracción de datos a mostrar.
6. Incluir en Menú, este campo es que permite seleccionar donde se ubicará la consulta (después de incluido NO se permite cambiar, por tanto, hay que estar seguro en cual módulo de va a incluir)
7. Presionar clic el botón de AGREGAR

Después de eso el sistema activara cuatro cejillas, de las cuales el sistema llenara de forma automática la cejilla de campos siempre y cuando la consulta ejecutada devuelva resultados con datos encontrados en la base de datos.

Al agregar la consulta, ésta se validará contra la base de datos. Si tuviera algún error de sintaxis, éste se presentará y la consulta no podrá ser registrada en el sistema.

Cómo generar el menú y el permiso

Los pasos que se deben ejecutar son los siguientes:

1. El botón de GENERAR ÍTEM MENÚ, ejecuta el proceso de creación de la opción una nueva opción de menú EXPORTAR DATOS en el modulo seleccionado e incluye la opción de submenú que será la descripción de la consulta.

2. El botón de GENERAR CÓDIGO SEGURIDAD, ejecuta el proceso de creación del permiso de acceso, que luego debe ser asignado al grupo de seguridad o al permiso individual.

3. El botón de ACTUALIZAR guarda los cambios realizados en los campos de descripción y la consulta del reporte

   1. Si se modifica la consulta del reportes el sistema actualiza los campos de la cejilla de Campos.

4. El botón de ELIMINAR elimina la consulta y la opción de menú y submenú previamente generados.

Cómo Editar los campos

La cejilla de campos se llenará de forma automática la siempre y cuando la consulta ejecutada devuelva resultados con datos encontrados en la base de datos.

1. Estos campos son los que se muestran después de realizar la consulta a la base de datos. Por lo general en primera instancia se mostrarán con el nombre técnico que se encuentra registrado en la diccionario de datos.

2. Esta sección está habilitada para que el usuario técnico filtre y modifique lo sugerido por el sistema para dar formato o mejorar la visualización de la consulta:

Los campos dispuestos en esta sección tiene la siguiente funcional:

1. Nombre de la columna (No puede ser modificado)

2. Tipo de columna, sugerido que se usen:

   1. Cadena: textos o número que no se desean dar formato

   2. Fecha: fechas, el sistema dará formato a la visualización con formato dd/mm/aaa

   3. Numero: montos, el sistema dará formato a la visualización con formato ###,###,##

3. Descripción de la Columna, se puede modificar los nombres de los campos y cambiarlos por otros que sean de mejor interpretación para el usuario final

4. Tipo de filtro. El cual es importante cuando hay consultas que no pueden quedar abierta y se requiere definir campos que son obligatorios.

   1. Opcional

   2. Obligatoria

   3. No filtra

5. Visible, este campo permite configurar en donde se desea que se genere y visualice el campo:

   1. Visible en pantalla y Exportar

   2. Visible solo en Exporta

   3. Visible solo en Pantalla

   4. Oculto

6. Ordenar Datos, este campo permite definir la posición en la tabla y el reporte de 14 campos.

7. El botón de ACTUALIZAR está habilitado para guardar los cambios cuando se modifican el nombre un campo o el tipo de filtro.

8. El botón de ELIMINAR se habilita por aquello que el usuario defina que el campo no es requerido en la consulta. Para ello debe seleccionar el campo y luego presionar un clic en el botón indicado.

Generar el menú y asignar el permiso.

1. Ingrese en el módulo de Seguridad -> Desarrollo-> Exportar Datos.

2. Seleccione el exportar datos que cree anteriormente y presione un clic para que pueda visualizar la cejilla de Reporte Dinámicos

3. Presione un clic en el botón de el botón de GENERAR ÍTEM MENÚ, para que se ejecuta el proceso de creación de la opción una nueva opción de menú EXPORTAR DATOS en el modulo seleccionado e incluye la opción de submenú que será la descripción de la consulta.

4. Presione un clic en el botón de GENERAR CÓDIGO SEGURIDAD, para que se ejecuta el proceso de creación del permiso de acceso, que luego debe ser asignado al grupo de seguridad o al permiso individual, cierre la ventana.

5. Seleccione la forma de asignar el permiso:

   • Permiso Grupal: Ingrese al módulo de Seguridad -> Parámetros-> Grupos de Usuarios, seleccione al Grupos de Usuarios e ingrese a la cejilla de Derechos y proceda con la inclusión del permiso.

   • Permiso Individual:  ingrese al módulo de Seguridad -> Parámetros-> Usuarios, seleccione al usuario e ingrese a la cejilla de Individuales y proceda con la asignación del permiso.

6. Indícale al usuario que proceda a validar que ya puede ver la opción del exportar datos en el modulo seleccionado y en la nueva opción de menú EXPORTAR DATOS.

ACTUALIZA EL EXPORTAR DATOS

1. El botón de ACTUALIZAR guarda los cambios realizados en los campos de descripción y la consulta del reporte

   1. Si se modifica la consulta del reportes el sistema actualiza los campos de la cejilla de Campos.

2. El botón de ELIMINAR elimina la consulta y la opción de menú y submenú previamente generados.

Recomendaciones

Se recomienda de forma idónea para hacer generaciones de consultas que cumpla siempre con lo siguiente:

1. El acceso a la ventana de incluir exportar datos en el módulo de seguridad SOLO debe ser asignado únicamente a técnico especializado en base de datos, que cuente conocimientos suficientes de la estructura de la base de datos del sistema AVATAR, como también amplios conocimientos del SQL.

2. El acceso a la ventana a las ventanas de consultas de exportar datos que se incluyan en cada módulo SOLO debe ser asignado únicamente a usuarios de confianza, debido a que la misma brinda facilidades de extracción de datos que si no son manejados apropiadamente puede presentar inconsistencia en la información presentada a terceros o puede generar conflictos de confidencialidad por un mal manejo de estos.

3. Se recomienda siempre crear la consulta en un ambiente de pruebas o desarrollo para validar el rendimiento y la estructura de los datos que se desean generar.

4. Se recomienda probar por parte del técnico y solicitar al usuario que aplique unas pruebas de búsqueda para validar que la consulta responde a su necesidad antes de incluirla en el ambiente de producción.

5. Únicamente se permite ejecutar consultas de base de datos que usen el comando SELECT (la consulta NO permite ejecutar instrucciones de DELETE o UPDATE en cualquier parte de la sentencia).

6. Se recomienda probar por parte del técnico la construcción de la sentencia en algún herramienta de desarrollo (MySQL Workbench o similares) antes de incluir la sentencia de la consulta en el sistema, de forma tal que se valide y garantice que su estructura y ejecución sea la más optima posible:

   1. Se apliquen los índices que están presentes en las columnas buscadas

   2. Cuidar muy bien la aplicación JOINS y cláusulas WHERE o dividiendo una consulta grande en fragmentos más pequeños, el enfocar nuestra evaluación, prueba y proceso de control de calidad mejorará el resultado de la consulta

   3. Las consultas deben ser validadas previamente a nivel de relaciones entre tablas. Una consulta sintácticamente correcta, pero con errores en sus relaciones será aceptada por el sistema, y ésta podría "pegar" el servidor en donde se está ejecutando.