¿Cómo generar informes?

El Generador de informes está disponible en Conceptos | Recursos | Generador de informes y permite crear informes gráficos avanzados seleccionando campos, estableciendo criterios de selección, ordenación y expresiones. Genera sentencias SQL y JScript (archivados como .QDF para recuperación o XJS para ejecución. Incluye cabecera (título, tabla principal), panel principal con pestañas (Campos, Selección, Ordenar, Varios) y barra de botones para ejecutar, guardar en carpetas JavaScript o previsualizar en Sigrid.

Los pasos que se deben seguir para generar un informe son los siguientes:

1. Ir a Conceptos.
2. En Recursos, hacer clic sobre Generador de informes.
3. Indicar el título del Informe, por defecto se visualiza el nombre de la tabla principal.
4. En Tabla principal seleccionar todas las tablas accesibles en la base de datos.
5. A continuación, gestionar archivos de formato mediante los botones correspondientes:
   • Nueva consulta (query) para crear un nuevo informe y restaurar los valores por defecto de todos los campos. Muestra un aviso si hay cambios sin guardar en el informe actual.
   • Abrir formato de consulta (query) para recuperar consultas previas guardadas como ficheros QDF.
   • Guardar formato de consulta (query) para guardar como QDF tanto los datos relativos a la sentencia SQL como los de formato.
6. Ir al panel principal y cumplimentar los datos necesarios para definir el informe. El panel se divide en dos paneles redimensionables y los campos están repartidos en las siguientes pestañas.
   • Campos: seleccionar campos disponibles (izquierda) y añadir a seleccionados (derecha).
   • Selección: definir criterios de filtrado.
   • Ordenar: establecer ordenación.
   • Varios: configurar formato del informe (tipos de letra, rupturas, totales, saltos de página).

Además, dispone de los siguientes botones:

• Ejecutar consulta para visualizar resultados en la lista de Conceptos de la ventana principal.
• Nueva carpeta JavaScript para crear carpeta de búsqueda SQL:
  1. Seleccionar carpeta contenedora en el árbol de búsqueda de la ventana principal.
  2. Introducir código y descripción en Concepto nuevo.
  3. La carpeta ejecuta la consulta (parámetros en Selección abren diálogo al ejecutarse; editable como JavaScript).
• Preliminar para ejecutar en Imprime - Preliminar y generar automáticamente query_defecto.xjs en la carpeta Temporal del usuario.

Campos

La pestaña Campos del Generador de informes divide el panel en dos secciones Tablas y columnas, ubicado a la izquierda y que ofrece los campos disponibles de la tabla principal, y Campos impresos, a la derecha y que contiene los campos seleccionados para el informe. Permite selección múltiple, creación de columnas calculadas con expresiones, configuración de sumas, rupturas, saltos de línea (CR), ancho y alineación. Automatiza inserción de ide y tip para funcionalidad completa en la lista de conceptos de la ventana principal, ajustable para impresión.

Tablas y columnas contiene la lista de todos los campos de la tabla principal con descripción, nombre (NombreDeTabla.NombreDeCampo) e icono, que es diferente en función del campo.

Los pasos que se deben seguir para seleccionar los campos del informe son los siguientes:

1. Seleccionar los campos que se van a imprimir en el informe. La selección se puede realizar de manera múltiple con la tecla de mayúsculas para seleccionar campos consecutivos o Ctrl para campos salteados. También se pueden seleccionar campos consecutivos seleccionando el primero y arrastrando con el botón secundario del ratón.
2. Añadir los campos a Campos impresos. Cuando se añade un campo de una tabla a la lista, queda resaltado en color azul en la izquierda y si se añade otra vez, queda resaltado en color rojo. El proceso se puede realizar de las siguientes maneras:
   • Haciendo doble clic en el campo en Tablas y columnas para añadirlo al final.
   • Pulsando Añadir para agregar los campos seleccionados al final, en el orden de la selección.
   • Pulsando Insertar para ubicarlo en una posición específica.
3. En Campos impresos se visualiza el icono tipo de campo y el nombre del campo. Es el nombre de la cabecera del listado. Al añadir un elemento de la lista de la izquierda, por defecto toma el nombre del campo de la tabla, pero se puede cambiar usando el campo de edición al pie de la columna. Haciendo doble clic sobre este, se selecciona la línea del campo origen en la lista de la izquierda. Para eliminar campos, seleccionar y pulsar Eliminar o la tecla Suprimir.
4. Indicar ✓ en la casilla Suma para que se visualice con el valor 1 y al final del informe muestre el total de la columna. Si se ha realizado una ruptura por este campo, también aparecen los subtotales correspondientes al final del grupo. Esta opción solo es para campos numéricos. La casilla se muestra marcada con X por defecto y con valor 0 en su campo de edición
5. Marcar la casilla para activar el salto de línea a partir de ese campo. El campo con la casilla marcada y lo siguientes aparecen en el informe en una nueva línea.
6. Indicar el ancho y alineación de las columnas en el informe.
7. Pulsar Expresión para crear una nueva columna en la consulta. En el caso de que la columna seleccionada sea un campo de una tabla, se abre Añadir/Insertar. Si está seleccionada una columna calculada por una expresión, se abre el menú Añadir/Insertar/Editar. Realizada la selección, Editar expresión, para indicar el nombre de la nueva columna y el tipo de dato que devuelve la expresión. Pulsar Editar el texto de la expresión para abrir el Editor de expresiones. Para más información consultar la sección correspondiente en este artículo.
8. Una vez indicados los datos realizar una de las siguientes acciones, según el caso y mediante los botones ubicados en la parte superior derecha Ejecutar consulta o Nueva carpeta que, en realidad, contiene el mismo código que se ejecutaría con la opción anterior. La única diferencia es que, en este caso, se guarda el código. En ambos casos se debe tener en cuenta que la primera columna debe ser el ide del registro. Si contiene el ide del concepto, al hacer doble clic sobre él en la lista de conceptos, se abre su ventana de propiedades. La segunda columna se interpreta como la columna de Tipo. Si su valor coincide con un número de tipo de concepto, se reemplaza por el icono correspondiente a este tipo. Al hacer doble clic sobre él, se abre la ventana de propiedades y, al hacer clic con el botón secundario, se abre el menú Concepto actual.

Ejemplo:

Si la consulta se limita a mostrar el campo Razón social (prv.raz) de todos los Proveedores, la consulta debería ser

select raz as 'Razón social' from prv

select con.ide as 'Ide__o6', con.tip as 'Tipo', prv.raz as 'Razón social'

from con, prv

where con.ide = prv.ide

Si ahora se ejecuta la vista preliminar del informe, se ve que también se muestran las columnas Ide y Tipo cuyo contenido no tiene sentido para el usuario ya que Ide es la clave primaria subrogada de la tabla CON y Tipo es un número que maneja internamente la aplicación para identificar el tipo de concepto. Por lo tanto, para generar el informe impreso, es conveniente eliminar estos dos campos de la lista Campos impresos y guardarlo como QDF.

Editor de expresiones

El Editor de expresiones auxilia en la construcción de campos nuevos, criterios de selección y expresiones SQL desde las pestañas Campos y Selección del Generador de informes. El panel superior contiene el editor en el que se visualiza la sentencia SQL que se va a ejecutar y el inferior contiene tres subpaneles: Tablas y columnas, Operadores, Funciones con plantillas. Estos paneles se pueden redimensionar arrastrando la línea divisoria vertical.Doble clic añade elementos al cursor; clic derecho despliega menú de edición. Facilita alias dinámicos y plantillas para sentencias complejas en Sigrid.

1. Pulsar el botón Expresión del Generador de informes.
2. Cumplimentar los campos que se solicitan en Crear expresión.
3. Pulsar Editar el texto de la expresión.
4. En Tablas y columnas hacer doble clic sobre un campo para añadirlo. Los campos se agrupan en dos árboles:
   • Tabla principal: lista de todos los campos de la tabla principal y de los campos de las tablas relacionadas con ella.
   • Tablas de la base de datos: lista de todas las tablas de la base de datos a las que tiene acceso el usuario.
5. Añadir los operadores necesarios haciendo doble clic. Estos pueden ser lógicos, de comparación y los predicados.
6. Incorporar, mediante doble clic, las funciones, que pueden ser de manejo de cadenas de caracteres y plantillas.
7. Construir la expresión compleja, por ejemplo, NOT EXISTS(select ide from dcf where entide=prv.ide):
   • Hacer doble clic en NOT EXISTS para plantilla base.
   • Seleccionar texto genérico entre paréntesis.
   • Hacer doble clic en plantilla de consulta básica para sustituir.
   • Repetir selección/sustitución para tablas/campos hasta completar.
8. Validar sintaxis SQL antes de cerrar ya que los errores provocan fallos en ejecución.

Criterios de selección

Los criterios de selección se cumplimentan en la pestaña Selección del Generador de informes. Construye la cláusula WHERE mediante paneles Tablas y Columnas (izquierda: campos disponibles) y Condiciones (derecha: expresiones añadidas). Permite selección simple de campos, operadores relacionales y valores por defecto (concatenados con AND), o expresiones complejas vía Editor de Expresiones. Al ejecutar en la ventana principal, abre diálogo editable con valores por defecto para filtrado dinámico en Sigrid.

Los pasos que se deben seguir para indicar los criterios de selección son los siguientes:

1. Acceder a la pestaña Selección en el Generador de informes.
2. Revisar panel izquierdo Tablas y Columnas: lista idéntica a pestaña Campos (campos de tabla principal y relacionadas), pero selección simple (sin múltiple).
3. Añadir condición básica:
   • Hacer doble clic en campo o seleccionarlo y pulsar Añadir/Insertar.
   • Seleccionar operador relacional en la lista (construye ).
   • Pulsar Valor por defecto para abrir diálogo e introducir valor (ej. '%s.%' para LIKE).
4. Verificar en lista Condiciones: campo, operador y valor añadidos; múltiples se concatenan con AND.
5. Configurar valores por defecto múltiples:
   • Pulsar Adjudicar valor por defecto para diálogo con campos editables de todas las condiciones.
   • Al ejecutar Ejecutar consulta en la ventana principal, diálogo muestra valores por defecto editables.
6. Añadir condición compleja:
   • Pulsar Expresión (menú Añadir / Insertar / Editar).
   • Abrir Editor de Expresiones para crear expresión (ej. not exists(select ide from dcf where entide=prv.ide)).
   • Confirmar: se añade línea con icono calculado (ƒ); nombre dinámico, columnas Tipo/Valor sin significado.
   • Doble clic en línea para reabrir Editor de Expresiones.
7. Probar: ejecutar Preliminar para validar cláusula WHERE generada (ej. where raz like '%s.%' limita proveedores).

Ordenación y rupturas

La pestaña Ordenar del Generador de informes permite definir el orden ascendente/descendente por columnas y establecer rupturas para agrupar líneas. El panel izquierdo lista campos de la tabla principal, tablas relacionadas y expresiones de la pestaña Campos; el derecho muestra la lista Ordenado por... con opciones de ruptura (agrupación con cabeceras/subtotales). Los campos de ordenación se incluyen automáticamente en la cláusula SELECT para ORDER BY en Sigrid.

1. Seleccionar los campos que se van a imprimir en el informe. La selección se puede realizar de manera múltiple con la tecla de mayúsculas para seleccionar campos consecutivos o Ctrl para campos salteados. También se pueden seleccionar campos consecutivos seleccionando el primero y arrastrando con el botón secundario del ratón.
2. Añadir los campos a Ordenado por... El proceso se puede realizar de las siguientes maneras:
   • Haciendo doble clic en el campo en Tablas y columnas para añadirlo al final.
   • Pulsando Añadir para agregar los campos seleccionados al final, en el orden de la selección.
   • Pulsando Insertar para ubicarlo en una posición específica.
3. Indicar ✓ en la casilla Ruptura para que se visualice con el valor 1 y se agrupen líneas por valores iguales. Si se ha realizado una ruptura por este campo, su nombre y contenido se visualizan como cabecera de cada grupo, pero, si el campo está incluido también en la lista Campos impresos, sale repetido en cada línea de su grupo, por lo tanto, si se realiza una ruptura del listado por un campo, es conveniente quitarlo de la lista Campos impresos. La casilla se muestra marcada con X por defecto y con valor 0 en su campo de edición. Si está activada la casilla Suma de un campo en la lista Campos impresos, además de aparecer un total general al final del listado, también aparecen subtotales al final de cada grupo de ruptura.
4. Desmarcar la casilla Ascendente, marcada por defecto, para que el informe se ordene de manera descendente.
5. Marcar la casilla para activar el salto de línea a partir de ese campo. El campo con la casilla marcada y lo siguientes aparecen en el informe en una nueva línea.

Los campos que figuran en la lista Ordenado por... también se incluyen en la sentencia SELECT para poder usar la cláusula ORDER BY.

Opciones de listado

En la pestaña Varios del Generador de informes se configura el aspecto final del informe en el panel Opciones del listado, incluyendo orientación del papel, tipos de letra, decimales para variables de doble precisión y propiedades de rupturas: salto de página, reinicio contador. Permite incluir criterios de selección y optar por imprimir sólo totales: sin líneas detalle, con subtotales si hay rupturas. Las configuraciones se basan en las realizadas en Configuración de la impresora en Sigrid.

Los pasos que se deben seguir para indicar las opciones de listado son los siguientes:

1. Seleccionar en la lista desplegable la configuración del informe . Por defecto se visualiza de Configuración de la impresora. Si se utiliza otra configuración bloquea los cambios hasta reactivar .
2. Indicar la precisión en Número de decimales para las variables de doble precisión: 0 para redondeo al entero más próximo, hasta 10-8).
3. Seleccionar el tipo de letra para las líneas de detalle. Los tipos de letra se definen en Configuración de la impresora.
4. A continuación, definir propiedades por ruptura marcando la casilla Salto de página para salto tras cada ruptura y/o Contador de páginas a cero para reiniciar numeración por ruptura.
5. Marcar Incluir criterios de selección en el informe para imprimir criterios usados y número de registros al final.
6. Para omitir líneas detalle y que solo se impriman cabeceras de grupos, subtotales por ruptura y total general; solo total si no hay rupturas, marcar la casilla Imprimir sólo totales.