Informes

Los informes se crean en la herramienta.jaspe suave e incorporado al sistema utilizando los campos y opciones disponibles en la Plataforma senior X. Para su correcto funcionamiento, deben crearse siguiendo las pautas:

• Los parámetros utilizados deben ser de tipo Java estándar: Number, String, Boolean, java.sql.Date, java.sql.Timestamp, java.util.List, java.util.Map (en el caso de MAP solo será utilizado para crear informes a través de parámetros);
• Los parámetros que tienen la opción "Es para solicitar" son obligatorios y siempre deben ser informados durante su generación;
• La fuente de datos predeterminada para presentar datos de servicios es JDBC, también es posible crear un informe sin una fuente de datos, simplemente pasando parámetros y generando el informe sobre esta información, pero para eso es necesarioconfigurar Jaspersoft;
• El archivo debe tener extensión .jrxml o .zip, cuando se trate de imágenes y/o scripts java.

Una vez que el modelo se crea en Jaspersoft Studio y senior X Platform, recuerde establecer los permisos de acceso al mismo, indicando qué usuarios podrán ejecutar/ver el informe.

Después de crear el informe en Jaspersoft Studio, publíquelo en la plataforma X senior.

Antes de cargar un informe en la plataforma, cree el informe utilizando JasperReport de antemano y configure los parámetros para este informe:

1. Vaya a Tecnología > Personalización > Informes > Nuevo informe;
2. Complete los parámetros para crear un informe normalmente;
3. Cargue el archivo de informe creado anteriormente. Un listado de parámetros definidos dentro del archivo del informe será exhibido en la sección Informaciones del Archivo > Parámetros;
4. Elija cualquiera de los parámetros existentes, vaya a la columnaServicio de búsqueda y haga clicañadir/+;
5. Elija el dominio o el servicio de destino que será responsable por retornar el listado de valores para el parámetro en cuestión (podrá ser utilizado cualquier dominio/servicio existente);
6. Elija la primitiva que será utilizada para retornar los valores. Solamente serán exhibidas las primitivas que retornan los valores en el formato correcto. De ese modo, todas son válidas sintácticamente, siendo necesario elegir la que posee la semántica correcta, por ejemplo, una que retorne el listado de empresas de hecho, y no el listado de productos;
7. Haga clic en Guardar.

Cree informes usando campos personalizados, aplicando filtros y usando los campos como parámetros:

1. Descargar yconfigurar la biblioteca senior-jasperreports-functions-XXXjar;
2. Cree el informe según sea necesario:
   1. Acceda a Jaspersoft Studio, en Archivo > Nuevo > Informe Jasper;;
   2. Seleccione Blank A4 Horizontal y haga clic enpróximo y de nuevo en próximo;
   3. Seleccione Teiid - Conexión JDBC de la base de datos y haga clic en próximo ;
   4. Vaya a Mesa, seleccione la mesa deseada y haga clic en próximo ;
   5. En Campos, seleccione todos los campos y haga clic en el botónagregar;
   6. clickea en próximo y luego enfinalizar.

3. Extraiga el campo personalizado utilizando la función disponible en CustomFields. Estos métodos reciben como parámetros el valor del campo personalizado (XML) y el nombre de la columna a extraer;
4. Utilice la variable de informe y el campo de expresión para extraer la información y mostrarla en el informe;
   
   Ejemplo:

   CustomFields.getInteger("<xml><ext><codigoNcm>123</codigoNcm></ext>", "codigoNcm") == 123

5. Incluya la variable en el documento y guarde el proyecto de Jaspersoft Studio;

6. Finalmente, publique el informe para que se ejecute en la plataforma.

Cree un menú para acceder a la pantalla de informe:

1. Vaya a Tecnología > Personalización > Nuevo informe;
2. En Menús de informes, haga clic enJoven;
3. Determine dónde se mostrará:
   • en el menú principal
   : le permite seleccionar solo menús de agrupación;
   • En el contexto de una pantalla.: No es posible seleccionar menús que sean agrupadores de submenús.
   Ejemplo:

   • Desde el menú principal: Tecnología > Personalización > Informe Principal
   • En el contexto de una pantalla: Tecnología > Personalización > Módulos > Informe Principal
4. informar enEtiqueta el nombre de este menú;
5. Seleccione un menú y se mostrará. Cuando no sea posible seleccionar uno de los menús en la ubicación previamente determinada, se mostrará un icono de acceso denegado;
6. clickea enAgregar.

Algunas funcionalidades son de gran ayuda en el manejo de los reportes, como por ejemplo, la creación de etiquetas para facilitar la búsqueda, cuando existe una gran cantidad de reportes en el ambiente. Otra opción es hacer que el informe esté disponible solo por un período predeterminado de días y elegir un buen lugar para verlo, recordando que el nombre informado en su creación es el que se mostrará, y no el nombre del archivo en sí.

1. Vaya a Tecnología > Personalización > Informes > Nuevo informe;
2. clickea enCrear reporte, introduzca el nombre y adjunte la plantilla de informe. Otros campos son opcionales;
3. Haga clic en Guardar.

Si el informe consta de varios archivos, estos archivos deben agregarse a un archivo comprimido (.zip). Es importante que el nombre del archivo comprimido (.zip) sea el mismo que el nombre del archivo del informe (.jrxml). Cuando el informe consta de un solo archivo, normalmente se puede agregar, solo el archivo con la extensión .jrxml.

Para programar un informe, primero necesita permisos de edición y visualización para el recurso res://senior.com.br/platform/scheduler/job. Después de obtener el permiso, continúe con la programación:

1. Vaya a Tecnología > Personalización > Informe > Informes;
2. Seleccione un informe y haga clic enComportamiento >Detalles;
3. Haga clic en el botónprogramar informe;
4. Si el informe tiene parámetros, estos deben ser llenados. Informar el formato ya quién enviar. El usuario será redirigido a la pantalla de agendamiento, donde ya estarán diligenciados todos los campos requeridos para el reporte;
5. Rellene la secciónEjecución, eligiendo la fecha de inicio, periodicidad, horario, entre otros.

1. Acceda al informe a través del menú donde estuvo disponible o a través de Tecnología > Personalización > Informes;
2. Seleccione el informe que desea imprimir o busque el informe creado;
3. clickea enPara ver. Se mostrarán los parámetros del informe;
4. Compruebe los parámetros de búsqueda y, si lo desea, edítelos. La lista de búsqueda obedece al ámbito del usuario en cuestión. Por lo tanto, solo se mostrarán los valores que el usuario tiene permiso;
5. Elija si el informe se enviará a alguien;
6. clickea enVista del informe y espere la notificación de que el informe está listo.

1. Vaya a Tecnología > Personalización > Informes;
2. Ver una lista de todos los informes ya creados para dominios y servicios existentes;
3. clickea enComportamiento, En la opciónDetalles , del informe que desea editar;
4. Con su permiso, edite la información.