014 - Aplicación de Stock con Java. Hibernate – MySQL – JPA. iReport. Reporte para referencial Tipo.

Iniciamos la creación del reporte para “Tipo” de artículos creando un nuevo archivo, el nombre del archivo será “TipoReport”. Para entender más sobre el proceso de creación de informes se puede consultar iReport. Introducción para crear informes. La configuración de la hoja normal es el A4.

Abajo podemos ver una imagen de cómo queda el diseño del reporte completado, es bastante sencillo pero suficiente. En la imagen se indican los objetos que se agregan. Más abajo se explica de forma básica cada objeto agregado.
El reporte en si contiene estos elementos: 1) Un “Label” como descripción del reporte. 2) Una “Variable” para el número de páginas. 3) “Labels” para describir datos de columnas. 4) “Fields” o campos para la banda de detalles. Para los bordes y divisores se utiliza “Line” de la paleta. En ”iReport. Introducción para crear informes.” vimos cómo trabajar con cada elemento. Un detalle importante a tener en cuenta es el nombre para cada “Field” ya que serán iguales a las que le pasaremos desde Java; las designadas para este reporte son “id” y “des” que nos mostraran el “ID” y la “Descripción” de cada tipo de artículo que tengamos.

Una vez terminado el diseño podremos ver una vista previa del reporte o compilarla y obtener los dos archivos, en este caso “TipoReport.jasper” y “TipoReport.jrxml”. Estos archivos las copiamos en la carpeta “Informes”.

El siguiente paso es crear un método para ejecutar el reporte y llamarla desde el botón informe que está incluido en el formulario “TipoApp”.
Abajo el método “informe()” para ejecutar el reporte. Los comentarios explican que función cumple cada línea de código. Este método la llamamos desde el botón “Informe” utilizando el evento “ActionPerformed”.
Código Java
public void informe(){
//try - para controlar las excepciones.
try {
//Creamos una lista de los datos de la table "Tipo" utilizando "List".
st.beginTransaction();
List<Tipo> lista = (List<Tipo>)st.createQuery("From Tipo").list();
//Utilizamos el método siguiente para cargar el reporte "TipoReport.jasper"
//El "JRLoader.loadObject" es el cargador.
JasperReport report = (JasperReport)JRLoader.loadObject(ClassLoader.getSystemResource("com/informes/TipoReport.jasper"));
//El método siguiente nos permite pasarle los datos al reporte utilizando JRBeanCollectionDataSource y como argumento la lista que creamos más arriba.
//La lista posee dos campos por registro: "id" y "des", los nombres se corresponden con las agregadas en el reporte diseñado.
JasperPrint fillReport = JasperFillManager.fillReport(report, null,new JRBeanCollectionDataSource(lista));
//El JasperViewer para visualizar, le pasamos como argumento nuestro "fillReport" de arriba.
JasperViewer jviewer = new JasperViewer(fillReport,false);
//Le damos un título al reporte.
jviewer.setTitle("Lista de Tipos de Artículos.");
//La hacemos visible.
jviewer.setVisible(true);
} catch (Exception e) {
JOptionPane.showMessageDialog(null, "Error cargando reporte.");
}
}
En caso de que el IDE indique error de sintaxis, verificar si tenemos todas las importaciones necesarias. A continuación la lista.
Código Java
import com.entidades.Tipo;
import java.util.Iterator;
import java.util.List;
import javax.swing.JOptionPane;
import javax.swing.table.DefaultTableModel;
import net.sf.jasperreports.engine.JasperFillManager;
import net.sf.jasperreports.engine.JasperPrint;
import net.sf.jasperreports.engine.JasperReport;
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;
import net.sf.jasperreports.engine.util.JRLoader;
import net.sf.jasperreports.view.JasperViewer;
import org.hibernate.Session;
import util.HibernateUtil;
Por último el formulario en ejecución junto con el reporte. En caso que el reporte aparezca detrás del formulario, modificar la propiedad “modalityType” indicando que sea “DOCUMENT_MODAL”.

013 - Aplicación de Stock con Java. Hibernate – MySQL – JPA. iReport. Introducción para crear informes.

Antes de empezar a trabajar con reportes es necesario crear una biblioteca con los “JARs” necesarios para manejar los informes.

1).- Creando bibliotecas: Pueden ver el proceso en el enlace siguiente del blog Datos importantes antes de crear formularios. En este caso, crearemos una biblioteca para trabajar con los reportes. El nombre de la biblioteca será “JasperReports”.

2) Lista de JARs que debemos agregar para la creación de la Biblioteca “JasperReports”. Puede variar la versión dependiendo justamente de la versión del iReport. Estos JARs se pueden obtener de la carpeta de instalación del iReport.
  • commons-beanutils-1.8.0
  • commons-collections-2.1.1
  • commons-digester-2.1
  • commons-javaflow-20060411
  • commons-logging-1.1.1
  • groovy-all-1.7.5
  • iText-2.1.7
  • jasperreports-4.7.0
  • jasperreports-fonts-4.7.0
  • jasperreports-javaflow-4.7.0
  • png-encoder-1.5
  • poi-3.7-20101029
  • 3) Cargando biblioteca, será cosa de agregar la misma a la carpeta biblioteca de nuestro proyecto. El proceso en el enlace siguiente Datos importantes antes de crear formularios.
    .
    4) Datos básicos sobre el manejo de iReport. Creando nuevo archivo: Como se ve en la imagen, seleccionamos “Report”, seleccionamos tipo de hoja y orientación, por último abrimos la plantilla. Para completar especificamos el nombre y la ubicación del archivo.
    Secciones importantes de la pantalla de iReport: 1) Datasource o fuente de datos: para nuestros reportes esta tendrá que estar en “Empty datasource” pues utilizaremos listas ya filtradas. 2) Inspector de Reportes: De esta la que mayormente utilizaremos son los parámetros, campos y variables. 3) Modo diseño del iReport: En esta vemos las diferentes bandas que pueden cumplir cada cual una función específica, que detallaremos al realizar los reportes. 4) Paleta: Con los diferentes elementos que podremos agregar el reporte. 5) Propiedades: Cada elemento seleccionado despliega una serie de propiedades que pueden ser o no modificadas.
    5) Como se agregan los diferentes elementos.
    Label.
    Estas podemos utilizar para agregar títulos al reporte, descripciones de columnas. Se puede agregar seleccionándola de la paleta y arrastrando al lugar correspondiente. Se puede modificar tipo de letra, tamaño, color, alineación, etc., en “Properties” o “Propiedades” del objeto.
    Fields.
    Fields o capos; almacenan los datos que recibirá el reporte de una lista o base de datos. Se agregar en la banda correspondiente a “Detalles”. Estas se crean haciendo clic derecho sobre “Field” en el “Inspector de Reporte” a la izquierda y seleccionando “Agregar Field”. Se la puede agregar al reporte haciendo clic sobre la misma y arrastrándola al lugar correspondiente. Se pueden modificar las diferentes propiedades en el apartado “Properties” o “Propiedades” del objeto.
    Parameters.
    Parameters o parámetros; corresponden a datos individuales e independiente que se pueden agregar al reporte. Suele ser una variable que le pasa la aplicación que llama al reporte. Por ejemplo un nombre o dato específico que el usuario escribe en un campo de texto. Estas se crean haciendo clic derecho sobre “Parameters” en el “Inspector de Reporte” a la izquierda y seleccionando “Agregar Parameters”. Se la puede agregar al reporte haciendo clic sobre la misma y arrastrándola al lugar correspondiente. Se pueden modificar las diferentes propiedades en el apartado “Properties” o “Propiedades” del objeto.
    Variable.
    Como se ve en la imagen (01) una variable puede contener cálculos con condiciones, número de páginas, numero de columnas etc. El potencial de la misma está en la agregación de cálculos específicos con condiciones específicas. En la imagen (2) se puede ver el agregado de una variable para realizar sumas, el procedimiento de creación de la misma es igual a la creación de “Campos” y “Parámetros”; la parte más importante está en propiedades, la misma nos permite especificar el tipo de datos, tipo de cálculos, tipo de agrupación y el origen de los datos para el cálculo. En este caso particular el cálculo se realizar en “Pie de Grupo”.
    IMG 01

    IMG 02

    6) Para verificar nuestro trabajo podemos utilizar el botón “Preview” como se indica en la imagen, es posible especificar algunos datos de entrada para la vista previa del reporte. Por último debemos compilar el reporte haciendo clic en el botón “Compile Report”. Esta compilación nos genera dos archivos con extensión “.jasper” y “.jrxml” que se almacena en la carpeta de iReport en Documentos de usuario; debemos copiar ambas en nuestra carpeta de “informes” del Proyecto Java. Teniendo ambos archivos ya podremos utilizarlas desde el formulario correspondiente.
    7) Ejemplo de reporte: Más abajo podemos ver una imagen de la elaboración de un reporte utilizando principalmente elementos como líneas, etiquetas, rectángulos, campos, parámetros y variables. El iReport tiene la capacidad necesaria para realizarse reportes complejos y sofisticados. La información presentada más arriba es bastante básica, pero suficiente para empezar a trabajar con reportes.