JasperReports en Windows y Linux – Instalación y Configuración

App Builder
,
1

Antes de empezar

JasperReports es una herramienta de generación de reportes que permite crear, diseñar y ejecutar reportes desde diversas fuentes de datos. Este instructivo cubre la instalación en sistemas operativos Windows y Linux, así como la configuración básica de conexiones a bases de datos.

Requisitos previos:

  • Acceso a descarga de software

  • Permisos de administrador en tu equipo

  • Base de datos accesible (SQL Server, MySQL, PostgreSQL, etc.)

Descarga de JasperReports

Descarga la versión Community Edition desde el siguiente enlace:

JasperSoft Community Edition

Instalación en Windows

Paso 1: Configurar variables de entorno Java

  1. Descarga e instala el JDK (Java Development Kit) desde el sitio oficial de Oracle.

  2. Abre Variables de Entorno:

    • Presiona Windows + R y escribe sysdm.cpl

    • Selecciona la pestaña Variables de entorno

  3. Haz clic en Nueva (en Variables del sistema) y agrega:

    • Nombre: JAVA_HOME

    • Valor: C:\Program Files\Java\jdk11.0.28_6

  4. Haz clic en Aceptar y reinicia tu equipo.

    image
    image1306×623 160 KB

Paso 2: Instalar JasperSoft Studio

  1. Descarga el archivo comprimido desde el enlace indicado.

  2. Descomprime la carpeta en una ubicación accesible (por ejemplo, C:\Program Files\).

  3. Dentro de la carpeta descomprimida, localiza y ejecuta jaspersoft-studio.exe.

  4. Sigue el asistente de instalación.

    image
    image1291×131 52.5 KB

    image
    image1253×480 57.3 KB

Instalación en Linux

Paso 1: Instalar Java

  1. Abre una terminal.

  2. Ejecuta el comando para instalar Java: sudo apt-get update sudo apt-get install openjdk-11-jdk

    image

  3. Verifica la instalación: java -version

    image

Paso 2: Configurar variables de entorno

  1. Abre el archivo de configuración: sudo nano ~/.bashrc

  2. Agrega las siguientes líneas al final del archivo: export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64 export PATH=$JAVA_HOME/bin:$PATH

    image
    image1904×956 109 KB

  3. Guarda el archivo (presiona Ctrl + O, luego Enter, luego Ctrl + X).

  4. Aplica los cambios: source ~/.bashrc

    image

  5. Verifica que la configuración sea correcta: echo $JAVA_HOME

    image

Paso 3: Descomprimir e instalar JasperSoft Studio

  1. Descomprime el archivo descargado: tar -xzf jaspersoft-studio-[version].tar.gz

  2. Navega a la carpeta descomprimida y ejecuta: ./jaspersoft-studio

    image
    image1303×230 21.6 KB

Crear un nuevo reporte

Los pasos siguientes son idénticos tanto en Windows como en Linux:

  1. Abre JasperSoft Studio.

  2. Selecciona File → New → Jasper Report.

    image
    image929×850 105 KB

  3. Elige la plantilla Blank A4.

    image
    image978×765 98.8 KB

  4. Asigna un nombre al archivo (por ejemplo: reporte.jrxml).

  5. Haz clic en Finish.

    image
    image979×776 51 KB

Conectar a una base de datos

Consideraciones previas

Si utilizas SQL Server, asegúrate de habilitar el protocolo TCP/IP en el SQL Server Configuration Manager antes de proceder.

Pasos de configuración

  1. En el panel izquierdo de JasperSoft Studio, haz clic derecho en Data Adapters.

  2. Selecciona Create Data Adapter.

    image
    image907×375 72.2 KB

  3. Elige Database JDBC Connection y haz clic en Next.

    image
    image830×751 118 KB

  4. En el campo Name, ingresa un nombre identificable para tu conexión (por ejemplo: ConexionMiBase).

  5. Completa los siguientes campos con la información de tu base de datos:

    • JDBC Driver: Driver correspondiente a tu BD (ej. com.microsoft.sqlserver.jdbc.SQLServerDriver para SQL Server)

    • JDBC URL: URL de conexión (ej. jdbc:sqlserver://localhost:1433;databaseName=MiBaseDatos)

    • Username: Usuario de la base de datos

    • Password: Contraseña del usuario

      image
      image536×664 19.1 KB

  6. Haz clic en Test para validar la conexión.

  7. Si todo es correcto, verás el mensaje: Connection successful.

  8. Haz clic en Finish para guardar la conexión.

Glosario

  • JDBC: Java Database Connectivity, protocolo estándar para conectar aplicaciones Java a bases de datos.

  • JRXML: Formato de archivo XML utilizado por JasperReports para definir la estructura de reportes.

  • JDK: Java Development Kit, herramienta necesaria para compilar y ejecutar aplicaciones Java.

  • TCP/IP: Protocolo de comunicación de red requerido por SQL Server.

Próximos pasos

Una vez configurada la conexión, podrás:

  1. Crear consultas SQL para extraer datos de tu base de datos.

  2. Diseñar la estructura visual del reporte.

  3. Agregar campos, gráficos y totalizadores.

  4. Exportar el reporte en diversos formatos (PDF, Excel, HTML, etc.).