Tutorial Design Studio - Pentaho

Créer ses requêtes avec Pentaho Design Studio

Pentaho Design Studio est un Eclipse modifié pour créer des fichiers .xactions. Ces derniers contiennent les paramètres d'une source de données et des instructions (génération de rapport, envoie de mail, etc.), sous un format XML, qui sont destinés au moteur de Pentaho pour être exécuter. Un minimum de connaissances en SQL est indispensable pour écrire des requêtes. Toutefois, le XML et le JAVA ne sont pas requis obligatoirement.

Installation et configuration de Pentaho Design Studio

Il faut d’abord configurer le Design Studio grâce au fichier preferences.ini (à l'aide d'un simple éditeur de texte). Ce fichier est dans le répertoire \pentaho design studio\plugins\org.pentaho.designstudio.editors.actionsequence.

Modifiez la ligne ci-dessous pour qu'elle corresponde à votre installation de Pentaho:

actionsequence.server.url=http://localhost:8080/pentaho

Avec Internet Explorer, il faudra toutefois taper l’URL suivante : http://127.0.0.1:8080/pentaho

Une fois cette préférence donnée, quittez et retournez dans Démarrer, Tous les Programmes, Pentaho, Pentaho Open BI Suite puis double-cliquez sur PentahoDesignStudio.exe. N’oubliez pas de lancer le serveur (fichier start-pentaho.bat) !

Introduction à Pentaho Design Studio

Initiation : découverte des requêtes SQL dans Design Studio

Une fois Design Studio lance, faîtes Fichier / New Project

ProjectName = ce que vous voulez (moi je prend TDN°1 par défaut)

Décochez la croix par défaut et allez sélectionner le dossier suivant (samples).

Puis appuyez sur Finish.

Le but de ce premier exercice dans cette partie est d’afficher l’évolution des différences de prix entre le prix d’achat et le prix de vente (conseillé). Cet affichage se fera selon différentes possibilités graphiques qui seront données à l’utilisateur via une liste déroulante.

La première tâche consiste à paramétrer et créer des fichiers. La mission consiste seulement à paramétrer le fichier .xaction responsable de ce qui est affiché à l’écran de l’utilisateur.

Ces derniers contiennent les paramètres d'une source de données et des instructions (génération de rapport, envoie de mail, etc.), sous un format XML, qui sont destinés au moteur de Pentaho pour être exécutés.

Déplacez-vous jusqu’au dossier charts et cliquez sur le petit plus pour « développer » l’explorateur. Ici sont concentrés tous les fichiers nécessaires à l’affichage d’une page avec un navigateur. Le fichier ChartComponent_ChartTypes.xaction contient la requête et les propriétés d’affichage que nous allons créer ensemble.

Une fois que vous avez ouvert le fichier ChartComponent_ChartTypes.xaction, sur la droite de l’écran apparaît une nouvelle fenêtre avec 4 onglets situés en bas.

L’onglet général réfère aux propriétés du fichier.

L’onglet suivant (Define process) permet la création de requêtes et la notification des inputs / outputs.

Le troisième onglet (XML Source) contient du code XML qui est généré automatiquement selon les deux premiers onglets.

Enfin, le dernier onglet vous servira à tester vos actions.

Commençons par paramétrer l’adresse du serveur, ce sera le seul élément à paramétrer mais il faudra le refaire souvent..

Allez dans le dernier onglet (Test)

Dans Pentaho Server URL, notez l’adresse suivante : http://127.0.0.1:8080/pentaho puis appuyer sur le bouton Test Server. Cette adresse URL est seulement valide pour Internet Explorer. Si vous utilisez Mozilla, l’adresse devient : http://localhost:8080/pentaho.

Après quelques instants de patience, la page d’ouverture de Pentaho s’affiche, sélectionnez Joe[Admin] pour vous logger. Votre serveur est désormais prêt. Il est en attente d’un ordre.

C’est ce que nous allons faire en lui donnant une requête.

Nous souhaitons, je vous le rappelle, afficher l’évolution des différences entre les prix de vente et prix d’achat dans une période donnée (entre 1970 et 1980).

Il faut pour cela revenir au deuxième onglet (Define Process). Sur la gauche de cette page se trouvent trois encarts. Nous nous occuperons seulement de celui du milieu, les autres étant déjà configurés. En effet, l’encart Process Actions contient toutes les actions que Pentaho doit faire. Avec un simple clic gauche sur le nom d’une action, à droite s’affiche les éléments qui la composent.

Votre mission consiste à trouver la requête qui permettra l’affichage de l’évolution des différences entre les prix de vente (msrp) et prix d’achat (buyprice) (disponibles dans la table PRODUCTS) dans une période donnée (entre 1960 et 1970).

La requête est donc la suivante :

select buyprice, msrp from PRODUCTS where productname like '197%' order by productname

Recopiez cette requête dans l’encart Query (ovale noire):

Testez votre action en allant sur le quatrième onglet, en retapant si nécessaire l’adresse URL du serveur puis tester le serveur. Une fois connecté avec le login Joe, appuyez sur le bouton Generate Url puis Run.

Grâce à la liste déroulante, vous pouvez choisir sous quel format graphique vous souhaitez afficher votre résultat (sélection puis Run Report). Si nous prenons en ligne (line) par exemple, pouvez-vous nous donner sur la feuille des réponses le prix de vente (msrp) le plus élevé, le prix d’achat (buyprice) le plus élevé et si ils correspondent au même produit.

Faites clic droit, Précédent puis essayez d’autres types graphiques. Première mission réussie !

Exemple simple de création d'un fichier .xaction

Dans Package Explorer, faites un clic-droit sur le projet pentaho_solutions, New, Folder et nommez ce nouveau dossier.

Dans Package Explorer, faites un clic-droit sur le nouveau dossier, New et Other... .

Dans le dossier Pentaho, choisissez New Action Sequence Wizard.

Nommez votre fichier .xaction et cliquez sur Finish.

Double-cliquez sur votre xaction. Ce dernier s'ouvre dans la fenêtre droite.

Cliquez sur l'onglet Define Process. La colonne de gauche montre les différentes parties de votre xaction. Dans la partie Process Actions, faites un clic-droit, Add, Get Data From et Relational.

Sur la partie droite s'affiche les caractéristiques de cette action. Cliquez sur JNDI et inscrivez le nom de votre JNDI configuré précédemment (par défaut SampleData).

En dessous dans la partie Query, inscrivez "SELECT SYSDATE FROM DUAL".

Dans Process Actions, faites glisser query_result vers ouputs qui se trouve en bas dans la section Process Outputs.

Sauvegardez le fichier avec Ctrl-S.

Cliquez sur l'onglet Test et sur le bouton Run.

Votre application est valide. Ce dernier exercice vous a paru simple ? Cela tombe bien car rassurez-vous, nous n’avons utilisé que 1% des possibilités offertes par Pentaho !