Créer un environnement de developpement

Créer un espace de travail ( Workspace)

Au démarrage d’Eclipse, il est nécessaire de créer un espace de travail qui pourra contenir par la suite (si nécessaire) plusieurs projets de rapport BIRT. Il est conseillé de sélectionner un espace de travail différent du répertoire d’installation de Eclipse BIRT. Cette configuration permettra de changer plus facilement de version logiciel de BIRT tout en conservant les projets déjà créés.

Une fois l’espace de travail créé et avant de commencer la création du rapport, un projet de type « BIRT project » doit être créé. Il doit également contenir les deux répertoires suivants :

  • « reports » : contiendra tous les rapports (fichiers .rptdesign)
  • « Ressources » : contiendra tous les fichiers et composants qui seront partagés à vos rapports en spécifiant un chemin d’accès relatif depuis ce répertoire.

Créer un nouveau projet

Pour créer un projet BIRT, sélectionnez « File > New > Other projects », puis, dans l’assistant, sélectionnez « report project ».

../_images/100000000000030C0000029D554D9D2B.png

Une fois le projet créé, ajoutez les deux dossiers principaux via un clic droit sur le projet dans l’onglet « navigator » :

../_images/1000000000000565000001F097833544.png

Copier mainteant le contenu des répertoires reports (/usr/share/centreon-bi/reports) et resources (/usr/share/centreon-bi/Resources) de votre serveur de reporting dans les 2 répertoires qui viennent d’être créés dans le projet.

Le dossier de ressources

Pour chaque projet BIRT créé dans cet espace de travail, il sera nécessaire de définir dans les propriétés du projet la localisation du dossier « Resources » associé

../_images/10000000000003340000018F33DF4032.png

La spécification de ce dossier dans les propriétés du projet permet l’accès aux composants partagés. Ces composants (data sources, data sets, paramètres de rapports, composant graphique, composant des bibliothèques BIRT, mais aussi modèles et images ou fichiers plats stockés dans ce répertoire), seront instanciés dans les rapports (.rptdesign) via le panneau « Ressource Explorer » :

Chaque composant importé dans un rapport (.rtpdesign) depuis les ressources partagées sera référencé par un chemin relatif. Ainsi, il sera possible de migrer le projet vers un autre espace de travail ou sur un serveur de reporting Centreon MBI sans se préoccuper des chemins d’accès. Par exemple, le fait que l’espace de travail soit situé dans « mes documents/MonProjet » n’a pas d’importance. Seuls les sous-dossiers et fichiers du projet doivent être figés.

Pour définir le dossier contenant les ressources partagés dans un projet, faites clic-droit sur votre projet dans le panneau « Navigator » puis cliquez sur « properties ». Définissez l’accès au dossier par : “<Current Project Folder>/Resources/”. La variable “<Current Project Folder>“ est initialisée automatiquement par Eclipse en fonction du projet courant.

../_images/10000000000003600000025556C97DB4.png

Note

Cette manipulation devra être réalisée à chaque fois :

  • qu’un nouveau projet est créé
  • qu’un projet existant est important dans un nouvel espace de travail (« workspace »)

Connexion aux bases de données

Introduction

Les informations de connexion aux bases de données sont définis dans les fichiers :

  • /etc/centreon-bi/cbis-profile.xml
  • /etc/centreon-bi/reports-profile.xml

Récupérez ces 2 fichiers et copiez-les sur votre poste de travail.

Modifiez les adresses IPs des 2 fichiers. Dans chaque fichier, il faut mettre à jour l’adresse à 2 endoits: une pour la base de centreon, et une pour la base centreon_storage.

  • Le fichier cbis-profile.xml doit contenir les adresses IPs du serveur de base de données de supervision
  • Le fichier reports-profile doit contenir les IPs du serveur de base de données de reporting

Modifiez les noms d’utilisateurs et mots de passe présents dans le fichier si necessaire.

Autorisez la connexions aux serveurs définis dans les 2 fichiers de profile depuis votre poste de travail.

Configuration de la bibliothèque L2_datasources

Warning

Ne remplacer jamais le fichier L2_datasources sur le serveur de reporting par celui sur votre poste. Vous écraseriez la configuration vers les bases et rendrai Centreon MBI non fonctionnel (génération de rapports, ETL).

Tous les rapports utilisent la bibliothèque L2_datasources pour se connecter aux données. Il suffit donc de faire pointer cette bibliothèque vers les bons serveurs ( bases de données du serveur de supervision et bases de données du serveur de reporting).

Nous lions ensuite la bibliothèque L2_datasources aux fichiers de profile récupérés dans votre poste de travail et édités.

Pour cela, double cliquez sur la bibliothèque L2_datasource. Cette dernière s’ouvre dans l’espace de travail.

../_images/db_conn_1.png ../_images/db_conn_2.png

Cliquez sur “outline”, et dérouler les Data Sources

../_images/db_conn_3.png

Il s’agit ici de tous les datasources utilisés dans les rapports standard MBI.*

Double cliquez sur le data source Centreon, la pop-up suivante s’ouvre:

../_images/db_conn_4.png

Dans “Connection Profile Store” Selectionnez le chemin du fichier report-profile.xml de votre poste de travail et validez.

La popo-up suivante s’ouvre:

../_images/db_conn_5.png

Dans la zone texte, l’ensemble des sources de données présentes dans le fichier sont listés.

Dans ce cas, 2 sources de données sont listées: - Censtorage - Centreon

Selectionnez Centreon puis cliquez sur “BIRT JDBC Data Source”

../_images/db_conn_6.png

Les informations présentes dans le fichier XML seront reprises.

Cliquez sur Test Connection pour vérifier la connexion à la base centreon.

Vous derriez avoir un message de connexion réussie:

../_images/db_conn_7.png

Note

en cas de message d’erreur faisant réference au Driver manquant, pensez à rajouter le driver MariaDB (.jar) dans menu manage driver.

../_images/db_conn_8.png ../_images/db_conn_9.png

Cette action est à effectuer une seule fois dans le projet.

Refaire la même chose pour les datasources: centreon_storage, centreon_live et centreon_storage_live

datasource fichier de profile profil à selectionner
Censtorage reports-profile.xml Censtorage
Centreon_Live cbis-profile.xml Centreon
Censtorage_Live cbis-profile.xml Censtorage

Générer un rapport standard

Pour générer un rapport standard depuis l’environnement de développement, il suffit d’ouvrir le rapport en question en double cliquant dessus.

../_images/gen_report_1.png

Maintenant que le rapport est ouvert, cliquez sur le button “View report” et selectionnez le format de sortie:

../_images/gen_report_2.png

Une pop-up demandant de renseigner les paramètres du rapport

../_images/gen_report_3.png

Le rapport sera donc généré sur le parimètre choisi (paramètres renseignés) au format de sortie selectionné.

../_images/gen_report_4.png