Généralités MyReport BE
La solution de Business Intelligence MyReport Business Evolution (MyReport BE) permet d’automatiser ses traitements via diverses méthodes.
Pour rappel, MyReport BE est une suite d'outils décisionnels, éditée par Report One, permettant de se connecter aux différentes bases de données de l’entreprise (exemple : ERP / CRM) afin d’en extraire les informations pertinentes.
Ces données brutes sont ensuite retravaillées (nettoyage / filtrage / règles de gestion / …).
Une fois traitées, les données peuvent être stockées dans une base de données dédiée à l’analyse des données. Il s’agit de l’entrepôt de données.
Pour finir, les outils de pilotage permettant de mettre en lumière des indicateurs clés de performance peuvent être construits.
Ces solutions d’aide à la décision, destinées à l’utilisateur final, peuvent prendre la forme de reporting et/ou de tableaux de bord.
Les traitements concernés sont notamment :
- ETL
- Diffusion d'un / de plusieurs reporting(s) Ecel ou Web
- Mise à jour d'un / de plusieurs rapport(s) / tableau(x) de bord
- Exécution d'une programmation
Une première méthode est représentée par l’utilisation des fonctionnalités de programmation intégrées à la suite MyReport BE.
Celle-ci s’exploite directement dans le produit MyReport Administrator et fait l’objet d’un article dédié dans notre Wiki que vous pouvez retrouver ici.
Une seconde méthode consiste à exploiter les fonctionnalités MyReport BE via des lignes de commandes (script) qui peuvent être automatisées par un planificateur externe tel que :
- Planificateur des tâches Windows
- Ordonnanceur tiers
C'est cette seconde méthode que nous allons traiter dans cet article.
À noter : Cet article s’applique essentiellement aux systèmes d’exploitation Windows.
Automatisation des traitements ETL MyReport BE via lignes de commandes
Cette méthode consiste à exploiter les fonctionnalités de l’outil DatarunCLI.exe via des lignes de commandes (script).
Création d'un traitement ETL
Pour accéder à l’outil, il est nécessaire d’exécuter MyReport Data :
Dans l’écran d’accueil de MyReport Data, il est indispensable de sélectionner un projet sur lequel travailler :
Une fois le projet ouvert, il est impératif de créer un élément de programmation. Cet élément sera exploitable via lignes de commandes.
Pour cela il faut :
Ouvrir le menu Gestion des ETL accessible dans le ruban de l'outil :
Sélectionner le bouton suivant :
Définir le nom de l'élément de la programmation et valider par OK :
Sélectionner le / les élément(s) à intégrer à cet élément de programmation puis valider par OK :
A partir de cet instant, l’élément de programmation ETL est exploitable soit à partir de MyReport Administrator pour constituer une programmation, soit à partir des lignes de commandes.
Création des lignes de commandes (Script)
Afin d’exploiter l’élément de programmation ETL via des lignes de commandes, il est nécessaire de créer un script faisant appel aux fonctionnalités de l’outil.
Il est recommandé de localiser ce script dans un dossier Planification stocké dans le répertoire du projet concerné, cela pour des raisons de centralisation. Bien entendu, cela peut être adapté en fonction des stratégies et contraintes du système d’information hôte.
Exemple :
Une fois le script créé, il est indispensable d’éditer le contenu de celui-ci afin d’indiquer les éléments à automatiser.
NB : Si un des éléments du script contient des caractères accentués alors une commande supplémentaire doit être utilisée en début de script. Il s’agit de la ligne de commande suivante : chcp 65001.
Les possibilités et les syntaxes à respecter sont les suivantes :
Outil à appeler :
"C:\Program Files\MyReport BE\Datarun\DatarunCLI.exe"
Commandes disponibles :
help : Affiche l'aide
version : Affiche la version du produit
execute : Lance des ETLs
Options disponibles :
--project NomProjet : Projet sur lequel on va lancer les ETLs (obligatoire)
--server NomServeur : Serveur sur lequel on va lancer les ETLs (facultatif, si l'option n'est pas renseignée, la commande se lancera sur le premier projet correspondant à l'option --Project)
--items etl1 [...] : ETLs à lancer (facultatif, si l'option est omise, la commande lancera toutes les ETLs du projet)
Exemples :
DatarunCLI.exe help
DatarunCLI.exe version
DatarunCLI.exe execute --project "MySystem Demonstration"
DatarunCLI.exe execute --server localhost --project "MySystem Demonstration"
DatarunCLI.exe execute --server localhost --project "MySystem Demonstration" --items "ETL 1" "Mon ETL 2"
Ce script peut ensuite être appelé à partir d’un outil externe tel qu’un planificateur de tâches ou un ordonnanceur.
Automatisation de la diffusion des rapports
Cette méthode consiste à exploiter les fonctionnalités de l’outil MessengerCLI.exe via des lignes de commandes (script).
Récupération du nom de la diffusion
Pour accéder à l'outil, il est nécessaire d'exécuter MyReport Messenger:
Dans l’écran d’accueil de MyReport Messenger, il est indispensable de sélectionner un projet sur lequel travailler :
Une fois le projet ouvert, il est indispensable de récupérer le nom de la / des diffusion(s) que l’on souhaite automatiser.
Pour cela, il faut parcourir l'arborescence des diffusions disponibles au sein du projet et sélectionner la diffusion concernée.
C’est ce nom, Démo, qu’il est indispensable d’utiliser dans le cadre de l’automatisation d’un traitement de diffusion via lignes de commandes.
Création des lignes de commandes (script)
Afin d’exploiter la diffusion Démo via des lignes de commandes, il est nécessaire de créer un script faisant appel aux fonctionnalités de l’outil.
Il est recommandé de localiser ce script dans un dossier Planification stocké dans le répertoire du projet concerné, cela pour des raisons de centralisation. Bien entendu, cela peut être adapté en fonction des stratégies et contraintes du système d’information hôte.
Une fois le script créé il est indispensable d’éditer le contenu de celui-ci afin d’indiquer les éléments à automatiser.
Les possibilités et les syntaxes à respecter sont les suivantes :
Outils à appeler :
"C:\Program Files\MyReport BE\Messenger\MessengerCLI.exe"
Commandes disponibles :
help : Affiche l'aide
version : Affiche la version du produit
execute : Lance des diffusions
Options disponibles :
--project NomProjet : Projet sur lequel on va lancer les diffusions (obligatoire)
--server NomServeur : Serveur sur lequel on va lancer les diffusions (facultatif, si l'option n'est pas renseignée, la commande se lancera sur le premier projet correspondant à l'option --Project)
--items diffusion1 [...] : Diffusions ou dossier à lancer (facultatif, si l'option est omise, la commande lancera toutes les diffusions du projet)
Exemples :
MessengerCLI.exe help
MessengerCLI.exe version
MessengerCLI.exe execute --project "MySystem Demonstration"
MessengerCLI.exe execute --server localhost --project "MySystem Demonstration"
MessengerCLI.exe execute --server localhost --project "MySystem Demonstration" --items "Ma diffusion 1" "Ma diffusion 2" "Mon dossier de diffusion"
NB : Dans le cas où un dossier et une diffusion portent le même nom, alors la notion de dossier prend l’ascendant sur la notion de diffusion lors de l’utilisation de lignes de commandes. Cela signifie que l’ensemble des diffusions du dossier seront diffusées. Il est donc primordial de bien nommer l’ensemble des objets utilisés (dossier / diffusion) afin de ne pas se trouver dans cette situation.
Exemple N°1 :
Seule la diffusion Démo sera diffusée.
Exemple N°2 :
Toutes les diffusions du dossier Démo seront diffusées.
Ce script peut ensuite être appelé à partir d’un outil externe tel qu’un planificateur de tâches ou un ordonnanceur.
Ainsi s'achève notre article sur l'automatisation des traitements ETL MyReport BE, n'hésitez pas à consulter régulièrement notre Wiki, nous publions régulièrement des trucs, astuces et nouveautés sur les outils décisionnels !
Vous recherchez des consultants certifiés MyReport BE? Next Decision est là ! alors Contactez-nous !