Créer des rapports personnalisés avec JasperSoft Studio

Ce guide vous accompagne dans la configuration de JasperSoft Studio pour créer des rapports personnalisés à partir de la base de données de RAC/M Identity. Les rapports personnalisés utilisent le format JasperReport et peuvent être intégrés dans l'interface de RAC/M Identity.

Prérequis

• Connaissance de base de SQL et de la syntaxe des requêtes
• Accès à la base de données de RAC/M Identity (voir Obtenir les informations de connexion à la base de données ci-dessous)

Étape 1 — Installer JasperSoft Studio

Téléchargez et installez JasperSoft Studio à partir de la page TIBCO Community Edition.

JasperSoft Studio est l'outil de conception actuel pour créer des rapports au format JasperReport. Il remplace l'ancien iReport Designer.

Étape 2 — Télécharger le pilote JDBC MS SQL Server

1. Téléchargez le dernier pilote Microsoft JDBC pour SQL Server depuis la page de téléchargement Microsoft.
2. Extrayez l'archive et notez le chemin complet vers le fichier .jar (p. ex. mssql-jdbc-<version>.jre11.jar). Vous aurez besoin de ce chemin lors de la configuration du classpath du pilote dans JasperSoft Studio.

Étape 3 — Obtenir les informations de connexion à la base de données

Clients sur site (on-premises)

Rassemblez les informations suivantes auprès de votre administrateur de base de données :

Paramètre	Description
Nom du serveur	Le nom d'hôte ou l'adresse IP de l'instance SQL Server
Port	Le port TCP (par défaut 1433)
Nom de la base	Le nom de la base de données RAC/M (généralement RACM)
Nom d'utilisateur	Un identifiant SQL Server avec accès en lecture à la base de données
Mot de passe	Le mot de passe associé à l'identifiant ci-dessus

Recommandation

OKIOK recommande de créer un utilisateur de base de données dédié en lecture seule pour les besoins de production de rapports. Cela limite le risque de modification accidentelle des données et respecte le principe du moindre privilège.

Exemples courants d'URL JDBC

Connexion standard avec port :

jdbc:sqlserver://nomserveur:1433;databaseName=RACM;encrypt=true;trustServerCertificate=true

Instance nommée (sans port explicite) :

jdbc:sqlserver://nomserveur\nominstance;databaseName=RACM

Instance nommée avec port explicite :

jdbc:sqlserver://nomserveur:1433;instanceName=MONINSTANCE;databaseName=RACM;encrypt=true;trustServerCertificate=true

Clients SaaS

Si vous êtes un client SaaS hébergé par OKIOK, l'accès à la base de données doit être demandé via le portail de support.

1. Un utilisateur autorisé du portail de support OKIOK (JIRA) doit soumettre une demande pour obtenir l'accès à la base de données de production de rapports.
2. Le support OKIOK va ensuite :
   1. Demander les informations nécessaires pour accorder l'accès (p. ex. les adresses IP sources pour les règles de pare-feu).
   2. Fournir les paramètres de connexion (serveur, port, nom de la base, identifiants) nécessaires à la configuration de JasperSoft Studio.

Étape 4 — Configurer un adaptateur de données dans JasperSoft Studio

1. Dans JasperSoft Studio, ouvrez le panneau Repository Explorer.

2. Faites un clic droit sur Data Adapters et sélectionnez Create Data Adapter.

3. Choisissez Database JDBC Connection puis cliquez sur Next.

4. Remplissez les paramètres de connexion :

   Champ	Valeur
   Name	Un nom descriptif, p. ex. RACM Production
   JDBC Driver	com.microsoft.sqlserver.jdbc.SQLServerDriver
   JDBC URL	L'URL de l'étape 3 ou fournie par OKIOK
   Username	Votre nom d'utilisateur de base de données
   Password	Votre mot de passe de base de données

5. Cliquez sur l'onglet Driver Classpath, puis cliquez sur Add et naviguez jusqu'au fichier .jar du pilote JDBC Microsoft téléchargé à l'étape 2.

6. Cliquez sur Test pour vérifier la connexion, puis cliquez sur Finish.

Étape 5 — Créer un nouveau rapport

1. Sélectionnez File > New > Jasper Report.
2. Choisissez un modèle ou commencez avec un rapport vierge.
3. Lorsque demandé, sélectionnez l'adaptateur de données créé à l'étape 4.

Soyez patient

Le chargement des métadonnées de la base de données RAC/M peut prendre un temps considérable car la base de données contient un grand nombre de tables et de relations. C'est normal — attendez que le processus se termine avant de continuer.

4. Construisez la requête SQL qui récupère les données nécessaires pour votre rapport. Vous pouvez utiliser l'éditeur de requêtes ou saisir le SQL directement.
5. Associez les champs du résultat de la requête au rapport et concevez votre mise en page à l'aide de bandes, champs texte, graphiques et autres composants.
6. Prévisualisez le rapport en cliquant sur l'onglet Preview pour vérifier le résultat.

Astuces avancées — Utiliser des sous-rapports

Pour des besoins de rapports complexes, envisagez d'utiliser des sous-rapports. OKIOK utilise fréquemment des sous-rapports pour construire des rapports avancés qui extraient des données de différentes requêtes ou tables.

Les sous-rapports vous permettent de :

• Combiner des données provenant de plusieurs requêtes SQL dans un seul rapport
• Réutiliser des sections de rapport communes à travers différents rapports
• Garder les composants individuels du rapport plus faciles à gérer

Pour ajouter un sous-rapport, faites glisser un élément Subreport depuis la palette vers votre rapport, puis configurez-le avec sa propre source de données et sa requête.

Voir aussi

• Rapports — Générer des rapports standards et personnalisés dans RAC/M Identity
• Objets et tables de BD — Référence du modèle de données de RAC/M Identity