- Para iniciar se debe tener instalado el JasperSoft Studios. Si no lo tiene instalado dar click en el link y descargarlo de acuerdo a la versión y/o sistema operativo que utilice. https://community.jaspersoft.com/project/jaspersoft-studio/releases
- Para avanzar con el reporte de forma más eficiente, se recomienda contar con la Query lista previamente.
- Se recomienda ya contar con un usuario que permita ingresar a JasperSoft.
CREAR CONEXIÓN CON EL JASPERSERVER.
Se debe crear la conexión con el servidor de la siguiente manera:
Se procede a crear un nuevo proyecto. Se debe seguir la siguiente ruta:
File => New => Jasper Report.
Una vez abierto el nuevo reporte, en la ventana de nombre Repository Explorer(ver recuadros rojos), se procederá a iniciar la configuración del servidor.
Se abrirá la siguiente pestaña que permitira la configuración del Servidor. Se debe dar doble click en Servers (resaltado en azul).
Esto abrirá (delimitado en rojo), el Server profile Wizard, que permitira suministrar la informacion de la conexion al servidor.
Información para ingresar en los campos del Server profile Wizard.
Name: JasperReport Server
URL: https://192.168.100.191/jasperserver/ (IP del JasperServer en producción) https://wiki.aldeamo.com/mediawiki/index.php/Plataforma_de_Produccion)
Organization: Se deja en Blanco
User: user (Es un usuario administrador) // usuario propio. (Ej. Ricardo.pabon)
Password: Solicitarla al coordinador NOC. // Clave creada usuario. (Ej. Aldeamo2014*)
* Tambien se puede solicitar la creación de un usuario de JasperSoft.
Una vez se conecta con el JasperServer, esta conexión va a permitir ver todos los reportes creados en dicho servidor. Tal como se muestran en la siguiente imagen. (Ver campo delimitado en rojo)
REALIZAR CONEXIÓN A LA BASE DE DATOS.
El siguiente paso es conectarnos a la Base de datos para que se pueda traer la información de la base y que los Queries creados, tenga información que alimente los reportes.
En la pestaña de Repository Explorer, vamos a crear un Data Adapters, en nuestro equipo local, para poder trabajar con la configuración que está en remoto. (delimitada en rojo)
Una vez conectados al ServerJasper, se debe seguir la siguiente ruta para buscar una de las bases configuradas.
Ruta: Repository Explorer => JasperReportsServer => Aldeamo => DataSources
Dar click derecho en la base seleccionada (Se recomienda Utilizar DeliveryCore), se abrirá una nueva pestaña, donde se le da en Import Data Source
Para corroborar que el paso anterior fue éxitoso, el DataSource elegido debe Cargarse de forma correcta en DataAdapters, como se ve en la imagen. (ver recuadro rojo)
La base tambien se debe configurar. Se debe dar doble click en la base seleccionada en el DataAdapter.
Se deben configurar los campos de dicha pestaña como se relaciona a continuación. (El Password solicitarlo al coordinador NOC o equipo de Operaciones)
Una vez configurada la base se procede a realizar el test, si quedo bien configurada la base, dando click en el boton TEST.
Debe salir un aviso de Succesful.
EJEMPLO VISUALIZACIÓN REPORTES EN JASPER
Cada carpeta cuenta con el archivo *.jrxml, que es la extensión de Jasper en la que se puede ver como esta creado el reporte.
En este ejemplo, se está revisando el reporte del cliente ELTIEMPO. (delimitado en rojo)
Los campos Design, Source, Preview delimitados en rojo en la imagen superior, nos permitirán realizar el trabajo sobre nuestro reporte.
A continuación se explicarán los campos, su vista y funciones.
Design: En este campo, es donde se realiza el diseño de como se quiere visualizar la plantilla, además de los campos que tendrá. Enmarcado en rojo, en el lado izquierdo, se encuentran las herramientas con las cuales se pueden realizar los diferentes diseños de vista de acuerdo a los que se quiere generar.
Source: En la pestaña Source (delimitada en rojo), se puede visualizar el código fuente que se está generando para dicho reporte, adicional se puede ver la Query (resaltado en azul) que realiza la búsqueda en las bases de datos.
Preview: En la pestaña Preview, permite realizar un “vistazo” de cómo quedará visualmente organizado el reporte, además si está arrojando la información esperada. Importante validar en esta pestaña que lo que nos están solicitando sea realmente lo que se visualiza.
En el momento de previsualizar un reporte garantizar que se esta conectado a una de las bases elegidas, de la siguiente manera. En el recuadro rojo, donde se ve el One Empty Record, desplegar las opciones.
Resultado sin cargar Base de datos(One Empty Record):
Resultado cargando Base de datos (Core-DB-2*):
CREAR REPORTES EN JASPER
Se procede a crear un nuevo proyecto. Se debe seguir la siguiente ruta:
File => New => Jasper Report.
Se abre la ventana de Report Templates.
(El template a pesar, que no está estandarizado el de uso generalizado es el Simple Blue Table Based)
Presionar Next > para continuar con el proceso, se solicitara la carpeta donde se van a grabar los documentos. (Se deben guardar en la carpeta de MyReports, en alguna de las carpetas que esten en dicho directorio, como se aprecia abajo)
Elegir el DataAdapter. (Si no ha realizado la configuración del DataAdapter, en la sección REALIZAR CONEXION A LA BASE DE DATOS, se documenta como realizarlo)
Debe cargar de esta manera si quedo bien configurado.
En este punto es cuando debemos ingresar la Query (ver recuadro rojo), que previamente se había y como sugerencia inicial el usuario debio haber generado para trabajar el reporte.
Si la Query esta bien creada, el programa nos permitira continuar, sino esta bien creada, el programa nos informará que se presenta un error y es necesario corregirla.
En el caso que este bien creada, danos en Next >, y nos deben cargar los campos que se utilizaran en el reporte.
Seleccionamos todos los campos y los cambiamos de “columna” como se muestra en la figura. Se deben seleccionar todos y usar el >, para pasar la info de una columna a la otra.
Damos Next > y nos sale la alternativa de GROUP (ver imagen abajo), que es para agrupar campos, que no se van a usar por el momento. Asi que se da Next > => Finish
Una vez finalizado el proceso, el programa nos creara una vista de nuestra Query, con los campos seleccionados y el formato de Template seleccionado.
*Nota las modificaciones/ediciones/ esteticas y/o visuales del reporte, no harán parte inicialmente de este documento.
Una vez el documento este editado y en la pestaña preview cargue la información de manera correcta, como en la imagen adjunta, se puede proceder a publicar el documento.
PUBLICAR REPORTES DE JASPER
Para publicar un reporte en un servidor Jasper, en la pestaña Design (ver recuadro en rojo), en el Boton que señala la flecha y en recuadro rojo llamado “Publish Report To JasperReports Server”
Nos permitira ingresar a la siguiente vista, donde podremos visualizar las carpetas que están creadas en el JasperReports Server. (Se elige una carpeta, sino existe una carpeta idonea para guardar el reporte, ir abajo de esta imagen para realizar el paso a paso de creación de una carpeta)
En caso de no tener una carpeta idonea donde guardar el reporte continuar con este paso a paso, sino omitir los pasos de creación de una carpeta.
---------------------------------------------------------------------------------------------------------------------------
- Ingresar a https://jasper.aldeamo.com/jasperserver/login.html (Si no tiene usuario para ingresar, solicitarlo al NOC)
---------------------------------------------------------------------------------------------------------------------------
Una vez realizado el paso de la definición de la carpeta donde se va a grabar se procede a definir el nombre del nombre del Reporte y le damos Next >
Nos genera una nueva vista donde nos indicara de donde vamos a traer la data con la que se trabajo el reporte. Se elige la opción del recuadro rojo (Data Source from Repository) y se da doble click en la pestaña con los 3 puntos (...), que tambien se puede ver en el recuadro rojo.
Una nueva vista, nos permitira visualizar los DataSources que podemos elegir (Se recomienda elegir el que se uso desde el principio de la guia - DeliveryCore)
Danos en el primero en el recuadro rojo de Refresh, una vez carguen los DataSources, damos click en la pestaña List, y elegimos la DataSource que hemos trabajado; en este caso la DeliveryCore, como se puede ver en el recuadro rojo, que sus letras estan resaltadas en azul y damos FINISH.
Se generara una vista que confirme la ruta de donde se trabajara el DataSource.
Visualización reporte en https://jasper.aldeamo.com/, se debe buscar el nombre de la carpeta donde se creo el reporte(ver recuadro rojo) y posteriormente darle doble click en el nombre del reporte (señalado en rojo)
Vista Final Reporte Jasper
