jasper-reports Tutoriel
Démarrer avec les rapports Jasper

Remarques

Versions

Installation ou configuration

Bibliothèque JasperReports

JasperReports est un outil de reporting basé sur Java open source. La bibliothèque JasperReports peut être téléchargée depuis la communauté Jaspersoft pour la dernière version .

Dans les versions récentes, les pom.xml tiers dans le dossier lib ne sont pas distribués, ils doivent être téléchargés à partir de référentiels publics, voir pom.xml distribué pour les dépendances. Maven peut être utilisé pour récupérer toutes les dépendances, y compris celles qui sont transitoires dans le dossier cible / dépendance.

mvn dependency:copy-dependencies

Jaspersoft Studio (IDE)

Jaspersoft Studio est le client de conception officiel de JasperReports - construit sur la plateforme Eclipse - pour remplacer iReport Designer.

iReport Designer (IDE)

iReport Designer est le concepteur de rapports précédent pour JasperReports. La version 5.6.0 (sortie en mai 2014) était la dernière version officielle; le support fournisseur a pris fin fin 2015.

Ressources de JasperReport Commuity

FAQ de la bibliothèque JasperReports

• FAQ

Code source

• Code source de la bibliothèque JasperReports

Des tutoriels

• Point de tutoriels
• JasperReports Ultimate Guide

Des échantillons

• Référence de l'échantillon

Les références

• Documentation officielle
• Wiki de la communauté

Bug Tracker Officiel

• Bug Tracker

Flux de travail

Le flux de travail dans jasper-reports est:

1. Concevez le rapport, créez le fichier jrxml qui définit la présentation du rapport. Le jrxml peut être créé en utilisant un simple éditeur de texte, mais normalement, un IDE (JasperSoft Studio ou iReport) est utilisé à la fois pour accélérer le développement de rapports mais aussi pour avoir une vue visuelle de la mise en page.

2. Compilez le rapport (le jrxml) pour obtenir un fichier .jasper ou un objet JasperReport . Ce processus peut être comparé à un fichier .java en cours de compilation en .class .

3. Remplissez le rapport , transmettez les paramètres et une source de données au rapport pour générer l'objet d'impression JasperPrint pouvant également être enregistré dans un fichier .jprint .

4. Affichez, imprimez et / ou exportez le JasperPrint. Les formats d’exportation les plus courants sont les suivants: pdf, excel, word, html, cvs, etc.

Comprendre les différents groupes de rapports

Titre

Ce groupe est montré une fois au début du rapport. Il peut être utilisé comme première page en définissant l'attribut isTitleNewPage="true"

En-tête de page

Cela apparaît au début de chaque page en excluant la première page si la bande de titre est utilisée et la dernière page si la bande de résumé est utilisée avec le paramètre isSummaryWithPageHeaderAndFooter="false"

En-tête de colonne

Cela apparaît avant la bande de détails sur chaque page.

Détail

Cette section est itérée pour chaque enregistrement dans la source de données fournie. Il est permis d'avoir plusieurs bandes de détails (détail 1, détail 2 .. détail n), les sont itérés comme suit

Row 1
    detail 1
    detail 2
    detail n
Row 2
    detail 1
    detail 2
    detail n

Pied de colonne

Cela apparaît sous la bande de détails sur chaque page où la bande de détail est présente. Le paramètre par défaut est la fin de la page (avant le pied de page), mais vous pouvez basculer vers la dernière bande de détails (dernier enregistrement) en définissant l'attribut isFloatColumnFooter="true"

Pied de page

Cela apparaît au bas de chaque page, à l'exclusion de la bande de titre, de la bande de résumé (sans le pied de page) et de la dernière bande non récapitulative si le pied de page de dernière page est utilisé.

Dernier pied de page

Cela apparaît sur la dernière page (si ce n'est pas la bande récapitulative sans le pied de page) au lieu du pied de page normal

Résumé

Cela apparaît à la fin du rapport dans la nouvelle page si isSummaryNewPage="true" est défini et avec l'en-tête et le pied de page si isSummaryWithPageHeaderAndFooter="true"

En-tête de groupe

Cette section apparaît si un groupe est défini chaque fois que l'expression du groupe change, avant la bande de détail.

Group Footer

Cette section apparaît si un groupe est défini chaque fois avant que l'expression de groupe ne change, après la bande de détail.

Contexte

Ce groupe est affiché sur chaque page en arrière-plan de toutes les autres bandes.

Pas de données

Cela apparaît uniquement si aucune source de données n'a été transmise ou si la source de données est vide (0 enregistrement) et que whenNoDataType="NoDataSection" est défini.

Formats de fichiers de rapport Jasper

• .jrxml est le fichier de conception de rapport, son format est en XML lisible par l'homme, il peut être intégré dans un objet JasperReport et enregistré en tant que .jasper

• .jasper est la version compilée du .jrxml et peut être chargé directement dans un objet JasperReport prêt à être rempli avec des données.

• .jrprint est l'objet JasperPrint sérialisé, un rapport qui a déjà été rempli de données et peut être chargé pour être imprimé, affiché et / ou exporté au format souhaité.

• .jrpxml est le rappresentativo XML d'un objet JasperPrint , il peut être modifié puis désarchivé pour récupérer l'objet JasperPrint