MAD-AA-Installation BIRT Designer

INSTALLATION DE BIRT DESIGNER 4.
4
CARL Software
Version du document : 02-03-2018 15:21:57
TABLE DES MATIÈRES
1. Objet du document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
2. Tableau de correspondance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2.1. Création d’un compte de lecture sur le SGBD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2.1.1. Avec SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2.1.2. Avec Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2.1.3. Avec PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. Installation de BIRT Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.1. Installation de l’application BIRT Designer sur un poste local. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.2. Lancement de BIRT Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.3. Paramétrage de BIRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.3.1. Configuration des pilotes JDBC ou ODBC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.3.2. Connexion sur une base Oracle et SQL Server depuis BIRT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.3.3. Configuration du Preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.3.4. Test de lancement d’un rapport depuis BIRT Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.3.5. Test de lancement d’un rapport spécifique depuis CARL Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Installation de BIRT Designer 4.4
1. OBJET DU DOCUMENT
Ce document vise à donner les éléments à installer et à paramétrer pour faire fonctionner l’outil de reporting BIRT Designer avec le logiciel CARL
Source sur un poste client.
© CARL Software 1/9

2. TABLEAU DE CORRESPONDANCE
Les rapports de CARL Source sont créés avec l’outil Open Source BIRT Designer, complément à l’environnement de développement Eclipse.
Actuellement, il existe plusieurs versions de BIRT Designer. Dans le cadre de l’utilisation de CARL Source 5.0.1, vous devrez utiliser une version 4.4
de BIRT Designer.
Toutefois, veuillez trouver ci-dessous les correspondances entre les versions précédentes de CARL Source et de BIRT Designer.
Version BIRT Version CARL Source Commentaire

4.2
4.4.0 4.4 Il est nécessaire de réaliser la configuration de BIRT manuellement.
5.0
Le programme d’installation de CARL Source ne prépare plus le programme destiné au
4.0
3.7.2 poste client BIRT Designer. Il faut réaliser la distribution de BIRT Designer
4.1
manuellement.
2.5.2 3.1.1 La distribution CARL Source embarque une version 2.5.2 de BIRT.
Attention, la distribution embarque une version 2.5.0 de BIRT.
2.5.2 3.1.0
Une version BIRT 2.5.2 zippée se trouve dans le répertoire MISC.
3.0.0 Selon les rapports à modifier, il est nécessaire d’utiliser une version 2.5.0 ou 2.5.1 de
2.5.0 ou 2.5.1
3.0.3 BIRT Designer.
2.5.0 2.1.0
1.1.0
2.3.0 1.1.1 Attention, il est possible de rencontrer plusieurs modes de déploiements des librairies.
2.0.0
2.1.3 1.0.0
L’enregistrement d’un rapport BIRT Designer avec une version différente de celle compatible avec CARL Source le rendra
inutilisable.
Il est important de se référer au tableau ci-dessus.
2.1. Création d’un compte de lecture sur le SGBD

2.1.1. Avec SQL Server
Pour créer un compte de lecture avec SQL Server, il vous faudra connaitre le nom de la base de données (‘CARL_CS02' dans l’exemple ci-après) ainsi
que le nom du schéma de données (‘CS' dans l’exemple ci-après).
En se connectant en tant qu’utilisateur ‘sa', exécuter les requêtes suivantes :
USE [CARL_CS02]

GO
CREATE LOGIN [CS02_READ] WITH PASSWORD = 'MyPassword'
GO
CREATE USER [CS02READ] FOR LOGIN [CS02_READ] WITH DEFAULT_SCHEMA=[CS]
GO
EXECUTE sp_addrolemember 'db_datareader', 'CS02READ'
GO
2.1.2. Avec Oracle

Pour créer un compte de lecture avec Oracle, il vous faudra connaitre le nom du schéma de données (‘CS02' dans l’exemple ci-après), le nom du
tablespace de données (‘TBLS_CS02' dans l’exemple ci-près), ainsi que le nom du tablespace de données (‘TEMP' dans l’exemple ci-après).
En se connectant avec un utilisateur ‘dba', exécuter les requêtes suivantes :
2/9 © CARL Software

CREATE USER CS02_READ IDENTIFIED BY MyPassword DEFAULT TABLESPACE TBLS_CS02 TEMPORARY
TABLESPACE TEMP; 
GRANT CREATE SESSION to CS02_READ;
BEGIN 
FOR x IN (SELECT * FROM dba_tables WHERE owner='CS02') 
LOOP 
EXECUTE IMMEDIATE 'GRANT SELECT ON CS02.' || x.table_name || ' TO
CS02_READ'; 
EXECUTE IMMEDIATE 'CREATE SYNONYM CS02_READ.' || x.TABLE_NAME || ' FOR
CS02.' || x.TABLE_NAME; 
END LOOP; 
END; 
/
2.1.3. Avec PostgreSQL

En se connectant en tant qu’utilisateur postgres, positionnez-vous sur la base de données système « postgres », puis exécutez la requête
suivante :
CREATE ROLE "CS02_READ" LOGIN PASSWORD 'MyPassword';
En se positionnant sur la base de données sur laquelle on souhaite fournir le droit de lecture :
GRANT SELECT on ALL TABLES IN SCHEMA public to "CS02_READ";

3. INSTALLATION DE BIRT DESIGNER

Sur un poste client, il vous faut utiliser le fichier birt440.zip présent sur le cd-rom de CARL Source 5.0.1 sous \Sources\MaD\BIRT Designer
3.1. Installation de l’application BIRT Designer sur un poste local

Récupérer le fichier birt440.zip qui se trouve dans votre cd-rom CARL Source 5.0.1 sous \Sources\MaD\BIRT Designer.
Dézipper ce fichier sur votre poste client.
3.2. Lancement de BIRT Designer

Pour lancer l’application, il suffit d’exécuter le fichier suivant (présent dans le répertoire) :
Birt440\BIRT.exe
3.3. Paramétrage de BIRT

3.3.1. Configuration des pilotes JDBC ou ODBC
Les pilotes JDBC par défaut sont déjà présents. Toutefois, si un driver particulier est utilisé, il faut installer le bon pilote dans le répertoire
suivant :
Lecteur:\Birt440\plugins\org.eclipse.birt.report.data.oda.jdbc_4.4.0v201405191524\drivers\
3.3.2. Connexion sur une base Oracle et SQL Server depuis BIRT
Pour modifier ou visualiser le résultat d’un rapport, il est important d’avoir une connexion à la base de données. Pour cela, veuillez suivre la
procédure ci-dessous :
1. Lancer BIRT Designer.

2. Depuis le menu « File/Open File », ouvrir le fichier « rpt_common.rptlibrary ».
Celui-ci est situé dans votre Workspace.
(Ex : Birt440\workspace\report\lib).
Attention, il faut modifier l’extension des fichiers en *.rptlibrary pour les visualiser.
3. Dans l’arborescence, accéder via un double-clic (ou context menu Edit) au détail de la Data Source. Dans celle-ci, vous devez adapter les
paramètres de connexion à la base de données.
4. Effectuer un test de connexion afin de vérifier que le logiciel se connecte bien à votre base de données (voir copies d’écran ci-dessous).
5. Valider le message de confirmation.
6. Enregistrer les modifications du fichier ‘rpt_common.rptlibrary'.
Data Source Oracle :

Data Source SQL Server :
Data Source PostgreSQL :

3.3.3. Configuration du Preview

1. Accédez au menu des préférences : Windows / Preferences
2. Dans l’arborescence sélectionnez : Report Design / Preview
3. Cochez : Always use external browsers
3.3.4. Test de lancement d’un rapport depuis BIRT Designer

1. Lancer BIRT Designer.
2. Ouvrir en passant par le menu « Open files », le rapport user_list.rptdesign situé dans Birt440\workspace\report\system.
3. Accéder au menu « Run / View Report / As HTML » :

4. Contrôler que des données apparaissent dans votre navigateur Internet (qui s’est ouvert automatiquement).
Si le « preview » est vide ou s’il fait apparaitre une erreur différente de « Grid report_footer… ou function ()… » , merci de
prendre contact avec la hotline de CARL Software (http://support.carl-software.com).
3.3.5. Test de lancement d’un rapport spécifique depuis CARL Source

1. Lancer CARL Source.
2. Depuis la fonctionnalité Rapports, dupliquer le rapport USER_LIST.
Cliquez sur « Système » puis « Rapports ».
On obtient ainsi la fenêtre de tous les rapports disponibles dans CARL Source.

On recherche le rapport USER_LIST puis on double-clique dessus :
3. Renseigner les informations suivantes :

Dupliquer ce rapport. Puis modifier les valeurs pour que le rapport apparaisse comme un test.
4. Puis télécharger le rapport « user_list(1).rptdesign » en local en cliquant sur le lien « Accès au rapport ». L’enregistrer sous
Birt440\workspace\report\system\..
5. Ouvrir ce rapport depuis BIRT Designer et faire une modification mineure (modifier un libellé par exemple).
6. Enregistrer le rapport.
7. Déployer le rapport sur le serveur d’application.
Pour cela, accéder au rapport depuis CARL Source, et cliquer sur parcourir afin de sélectionner le fichier local modifié dans votre répertoire
BIRT Designer (user_list(1).rptdesign).
Puis cliquer sur « Envoyer ».
8. Valider le formulaire.
9. Lancer l’impression du rapport depuis la fonctionnalité « Utilisateur ».
10. Contrôler que des données apparaissent.
Si le preview est vide ou qu’il fait apparaitre une erreur, merci de prendre contact avec la hotline de CARL Software
(http://support.carl-software.com).

MAD-AA-Installation BIRT Designer

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

MAD-AA-Installation BIRT Designer

Transféré par

Droits d'auteur :

Formats disponibles

INSTALLATION DE BIRT DESIGNER 4.

2.1. Création d’un compte de lecture sur le SGBD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2.1.1. Avec SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2.1.2. Avec Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2.1.3. Avec PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3. Installation de BIRT Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3.1. Installation de l’application BIRT Designer sur un poste local. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3.2. Lancement de BIRT Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3.3. Paramétrage de BIRT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3.3.1. Configuration des pilotes JDBC ou ODBC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3.3.3. Configuration du Preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.3.4. Test de lancement d’un rapport depuis BIRT Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.3.5. Test de lancement d’un rapport spécifique depuis CARL Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

© CARL Software 1/9

Version BIRT Version CARL Source Commentaire

2.1. Création d’un compte de lecture sur le SGBD

USE [<strong><span class="green">CARL_CS02</span></strong>]

2.1.2. Avec Oracle

2/9 © CARL Software

CREATE USER <strong><span class="green">CS02_READ</span></strong> IDENTIFIED BY <strong><span class=

2.1.3. Avec PostgreSQL

CREATE ROLE "<strong>CS02_READ</strong>" LOGIN PASSWORD '<strong>MyPassword</strong>';

GRANT SELECT on ALL TABLES IN SCHEMA public to "<strong>CS02_READ</strong>";

© CARL Software 3/9

3. INSTALLATION DE BIRT DESIGNER

3.1. Installation de l’application BIRT Designer sur un poste local

3.2. Lancement de BIRT Designer

3.3. Paramétrage de BIRT

1. Lancer BIRT Designer.

Data Source Oracle :

4/9 © CARL Software

Data Source SQL Server :

Data Source PostgreSQL :

© CARL Software 5/9

3.3.3. Configuration du Preview

3.3.4. Test de lancement d’un rapport depuis BIRT Designer

6/9 © CARL Software

3.3.5. Test de lancement d’un rapport spécifique depuis CARL Source

© CARL Software 7/9

On recherche le rapport USER_LIST puis on double-clique dessus :

3. Renseigner les informations suivantes :

8/9 © CARL Software

© CARL Software 9/9

Vous aimerez peut-être aussi