SBR Studio
SBR Studio
SBR Studio
Sage BI Reporting
Propriété & Usage
Conformité & Mise en garde
Ce logiciel et sa documentation sont protégés par le
Code de la Propriété Intellectuelle, les lois relatives au Compte tenu des contraintes inhérentes à la
copyright et les traités internationaux applicables. présentation sous forme de manuel électronique, les
spécifications visées dans la présente documentation
constituent une illustration aussi proche que possible
Toute utilisation non conforme du logiciel, et
des spécifications.
notamment toute reproduction ou distribution partielle
ou totale du logiciel ou toute utilisation au-delà des Il appartient au client, parallèlement à la
droits acquis sur le logiciel est strictement interdite. documentation, de mettre en oeuvre le progiciel pour
permettre de mesurer exactement l’adéquation de ses
besoins aux fonctionnalités.
Toute personne ne respectant pas ces dispositions se
rendra coupable de délit de contrefaçon et sera Il est important, pour une utilisation sûre et
passible des peines pénales prévues par la loi. opérationnelle du progiciel, de lire préalablement la
documentation.
©Sage 2017 3
Module 1 : Présentation Sage BI Reporting Studio
Présentation du module
Sage BI Reporting permet de créer dans Excel® des tableaux de bord à partir de données
stockées dans des moteurs de bases de données.
Les formules Sage BI Reporting placées dans Excel® vont, au travers du connecteur, traduire
les interrogations Utilisateurs en requête SQL. Le Dictionnaire ainsi que le paramétrage
général de l’application sont stockés dans une base de données Microsoft SQL Server (non
fourni par l’éditeur).
Dans certains cas, on peut avoir besoin de répliquer des données stockées dans des bases
de production ou des fichiers TXT vers des entrepôts de données spécialisés. Le module de
réplication de Sage BI Reporting Studio permet de définir et de lancer ces processus
d’alimentation.
Note : Les notions de sécurité applicative et liées aux données sont abordées dans le
Module 3 / Processus.
©Sage 2017 4
Module 2 : Connecter
Module 2 : Connecter
Présentation
L’utilisation du Connecteur se place dans la mise à disposition des données SQL vers Sage
BI Reporting XL. Le Connecteur est une couche sémantique entre la base de données et
l’application Sage BI Reporting XL.
Actions Description
©Sage 2017 5
Module 2 : Connecter
Les éléments graphiques permettent de renvoyer les informations sur le serveur SQL.
La zone de droite permet de gérer les modèles contenus dans un Connecteur. Les Modèles
permettent de paramétrer et de stocker la connexion à la source de données, la méthode
d’interrogation et le dictionnaire de données. Vous pouvez déplacer un modèle d’un
connecteur à un autre. De plus, vous pouvez réaliser les actions suivantes sur un modèle :
Actions Description
La Source d’information
Le connecteur Sage BI Reporting permet d’interroger différentes sources de données. Ces
sources sont natives (intégrées dans Sage BI Reporting) ou libres.
Actions Description
©Sage 2017 6
Module 2 : Connecter
Le Modèle
Une fois la création du modèle et la définition de la source de données réalisées, vous pouvez,
par un double-clic, afficher le paramétrage du modèle. Deux onglets permettent de naviguer
entre le Schéma et le Dictionnaire.
©Sage 2017 7
Module 2 : Connecter
Le Schéma
1 3
2
Sur chaque objet vous pouvez réaliser un clic droit pour avoir un aperçu du contenu de l’objet
ou pour donner un alias à l’objet.
Vous avez également la possibilité par un clic droit dans l’écran principal de réaliser ces
deux actions :
• Ajouter une table Dérivée : permet d’ajouter une sous-requête dans la requête
principale. Cette sous-requête va devenir une table classique dans l’écran principal.
©Sage 2017 8
Module 2 : Connecter
Cette action permet d’ajouter des contraintes de syntaxe non gérées nativement
comme l’UNION ou une clause WHERE.
• Ajouter Objet :
Cette fonction permet de créer une table dans la base de données source. Vous pouvez ainsi
définir la structure d’une table vous permettant par exemple de réaliser l'exécution de la
fonction Sage BI Reporting XL / Ecriture de données.
Lorsque l’objet arrive dans la fenêtre principale, une recherche de clé primaire/étrangère est
lancée entre la nouvelle table et les tables sélectionnées. Par défaut, les champs seront liés
par une jointure externe (Left Join). Les critères de jointure sont modifiables par un double clic.
La notion de Table Pivot est importante pour le modèle car elle indique le point de départ de
la lecture des données. On indique dans la table pivot la table des faits contenant les
enregistrements à interroger.
Le Modèle Détails permet d’indiquer vers quel modèle on souhaite basculer pour obtenir plus
de détail dans la fonction XL Détails.
La case Autoriser l’écriture de données permet d’indiquer si vous souhaitez ou non autoriser
la fonction Ecriture de données à écrire des données via le modèle.
©Sage 2017 9
Module 2 : Connecter
Le Dictionnaire
1 2
Les champs récupérés dans le modèle ont régulièrement des noms techniques et non
conviviaux.
Le Dictionnaire va permettre de gérer une correspondance entre les noms des champs issus
des tables/vues et les noms conviviaux définis par l’administrateur. On pourra également créer
de nouveaux champs.
Pour ajouter un dossier,glissez le dossier dans la droite de l’écran ou faites un clic droit Ajouter
un Dossier. Les dossiers peuvent être organisés à plat ou sous forme hiérarchique.
Pour ajouter un axe/un champ, sélectionnez la colonne qui vous intéresse et déplacez-la dans
le dossier approprié. Si le type de données identifié pour le champ ne vous convient pas, vous
pouvez le modifier par un clic droit. Les différents types disponibles sont Texte, Date,
Numérique et Hypertexte.
Si vous cochez la colonne Filtre Obligatoire (), vous rendez obligatoire l’utilisation de l’axe
comme filtre dans les formules Sage BI Reporting.
La colonne Liste Filtre () permet de paramétrer la liste des valeurs renvoyées dans XL lors
d’un double-clic sur un axe défini comme filtre.
Si vous souhaitez consulter le contenu d’un champ ou d’une table présente sur la partie de
gauche, réalisez un clic droit sur la table pour avoir accès à l’aperçu.
©Sage 2017 10
Module 2 : Connecter
Pour ajouter un axe calculé, placez le champ que vous souhaitez transformer dans le
dictionnaire et par un clic droit, Modifier le champ. Ces axes calculés supportent toutes les
syntaxes du serveur SQL interrogé. Ces axes ne peuvent pas croiser des champs de deux
tables différentes.
Chaque axe est défini par son champ SQL ainsi que son chemin de composition. Ce chemin
permet à l’application de savoir dans quelle table se trouve le champ ainsi que le chemin à
parcourir pour atteindre cette table en partant de la Table Pivot.
Pour pouvoir connaître ce chemin, faites un clic droit sur la colonne Désignation \
Personnalisation Colonnes, puis double cliquez sur la ligne Source. Cela fera apparaître la
colonne permettant de changer ce chemin de composition.
De même, si vous souhaitez masquer des champs ou des dossiers, double-cliquez sur la
ligne Visible dans Personnalisation colonnes. Cela affichera une colonne Visible dans
laquelle vous pourrez choisir si l’utilisateur verra ou non ce champ/dossier.
Si vous choisissez de ne pas afficher un dossier, vous désactivez également la visibilité des
champs contenus à l’intérieur du dossier.
©Sage 2017 11
Module 2 : Connecter
Vous pouvez afficher cette option en tirant la partie tout à droite de l’écran du dictionnaire.
Une fois le menu Dossiers virtuels affiché, il faut vous placer sur un dossier vide et définir le
code du modèle qui sera partagé ainsi que la table qui servira de lien entre les deux modèles.
Exemple
Cette table devra donc être présente dans les schémas des deux modèles concernés.
3
2
Les Variables
Un modèle peut être piloté par des variables. Le but d’une variable est de pouvoir modifier, au
travers d’informations récupérées dans Excel (contexte utilisateur ou information saisie), la
requête SQL du MCD sans manipulation de la part de l’utilisateur.
©Sage 2017 12
Module 2 : Connecter
Ces variables peuvent être placées librement dans le MCD ou dans le dictionnaire.
Pour utiliser une variable dans le dictionnaire, il faut placer un @ devant le nom de variable,
qui doit être saisi en minuscule (ex : @datesolde).
Admin
Remplace la variable par le login de
@login l’utilisateur
Exemple
Dans XL, si je me connecte avec un compte dont la langue est FR alors j’obtiens :
SELECT *
FROM Accounting.[GeneralLedger]
INNER JOIN Accounting.[Account] ON Account.AccountCode=GeneralLedger.AccountCode and
Account.AccountNameLanguage='FR'
©Sage 2017 13
Module 2 : Connecter
Exemple
Dans XL, le fait de réaliser un filtre sur le champ contenant la variable (par exemple
01/01/2014) va automatiquement initialiser la variable avec la valeur du filtre, puis remplacer
la variable par cette valeur dans la requête. On va obtenir :
Select HRTable.*
From (Select HR.EmployeeHistory.DatePay, HR.EmployeeHistory.Amount, HR.EmployeeHistory.CompanyCode
From HR.EmployeeHistory Where HR.EmployeeHistory.DatePay <= '01/01/2014') HRTable
©Sage 2017 14
Module 3 : Répliquer
Module 3 : Répliquer
Présentation
Le module Répliquer permet la réplication dans des entrepôts de données, de données SQL,
de fichiers Texte ou Office.
L’entrepôt de données
Les actions suivantes sont disponibles.
Actions Description
©Sage 2017 15
Module 3 : Répliquer
Les éléments graphiques et les logs permettent de renvoyer des informations sur le résultat
des traitements.
Cet entrepôt correspond à une base de données dans un environnement Microsoft SQL
Server. Dans cet écran, vous paramétrez la base de données source ou vous la créez si
nécessaire.
Note : Le plan de sauvegarde de cette base n’est pas pris en compte dans la gestion de
l’entrepôt de données, nous vous conseillons d’utiliser les utilitaires fournis par Microsoft
SQL Server.
Actions Description
©Sage 2017 16
Module 3 : Répliquer
Si cette case reste cochée, la base est créée selon les paramètres
par défaut du serveur SQL. Si vous souhaitez modifier ces options
Par défaut
décocher le bouton.
Une fois cet entrepôt défini, un processus par défaut est créé avec les informations de
connexion nécessaires vers l’infocentre.
Actions Description
Supprime le processus
Supprimer
Dupliquer un processus
Dupliquer
Si vous souhaitez changer les informations de connexion de tous les processus vous pouvez
utiliser le bouton Renommer de l’infocentre, et y indiquer la nouvelle chaîne de connexion.
Note : Si un processus n’est pas dans l’infocentre que vous souhaitez, vous pouvez par un
glisser déposer le mettre dans un autre infocentre.
©Sage 2017 17
Module 3 : Répliquer
Le Processus
Une fois réalisée la création du processus et la définition de la destination de l’entrepôt de
données, vous pouvez par un double clic sur le Processus, afficher son paramétrage. Le
paramétrage se définit par une série de tâches ETL qui peut être répétée selon les éléments
définis dans l’onglet Répéter Pour.
Les étapes
Pour relier une étape avec une autre afin de définir l’ordonnancement,
©Sage 2017 18
Module 3 : Répliquer
Les différentes étapes qui peuvent être reliées à la sortie SQL sont présentées ci-dessous :
Purge
2 3
L’étape de Purge permet de vider le contenu de la table alimentée par le processus. Il est
possible d’y ajouter ou non des critères de filtres.
©Sage 2017 19
Module 3 : Répliquer
Dans les deux cas, la première action consiste à définir la source d’extraction :
3
1 2
©Sage 2017 20
Module 3 : Répliquer
chaque table identique seront liés par une jointure externe (Left join). Les
critères de jointure sont modifiables par un double clic.
• En bas de l’écran , vous pouvez ajouter des critères de filtre sur les tables
sélectionnées ou réaliser des agrégations.
1
2
1. L’onglet SQL permet la saisie directe de la requête. Un aide syntaxique sur les objets
et les différentes fonctions SQL permet d’accélérer la saisie.
2. Il faut cliquer sur le bouton Rechercher pour activer la prévisualisation et l’activation
de cette aide.
3. Cliquer sur le bouton Afficher pour avoir une visualisation des données.
Note : Vous pouvez avoir le même type de saisie sur l’écran Graphique, il suffit de déplacer
le split placé en bas de l’écran.
©Sage 2017 21
Module 3 : Répliquer
Note : Pour obtenir dans un fichier les lignes non importées, vous devez cocher l’option
Enregistrer les erreurs et indiquer un répertoire de stockage.
Important ! L’emplacement ainsi que le format numérique de votre fichier peut avoir un impact
important. Si vous placez vos fichiers sur un partage réseau accessible par le service SQL et
que votre fichier respecte un certain format (séparateur de champs différent de virgule et
format numérique ####.##), vous pourrez alors bénéficier du chargement rapide.
Si ces conditions ne sont pas respectées, le produit utilise automatiquement un mode moins
rapide mais supportant tous types de contraintes de format (cf. schéma ci-dessous).
©Sage 2017 22
Module 3 : Répliquer
Paramètres Description
Grâce à l’étape préalable de définition de lecture, le bloc de gauche nous propose les
différentes colonnes récupérées par le programme. Il faut maintenant, pour chaque champ,
définir les colonnes suivantes :
©Sage 2017 23
Module 3 : Répliquer
Colonne Description
Filtre sur le contenu deune colonne, les lignes concernées ne seront pas
intégrées dans l’entrepôt de données. La syntaxe est : <,>,=,<>,>=,<=
Filtre
valeur.
Etape Libre
L’étape libre offre la possibilité aux utilisateurs avancés d’envoyer des instructions SQL
directement au serveur de destination.
Pour cela, saisissez ou collez l’instruction SQL que vous souhaitez envoyer au serveur de
base de données.
Fusion
L’étape Fusion permet de réaliser de nombreuses actions sur les données sources avant
leur intégration dans l’entrepôt de données. Cette étape offre la possibilité de :
©Sage 2017 24
Module 3 : Répliquer
Pour cela double cliquez sur les tables disponibles à droite pour pouvoir les relier dans la
fenêtre principale selon votre besoin.
En bas de l’écran, vous pouvez ajouter des critères de filtre sur les tables sélectionnées ou
réaliser des agrégations.
Mapping
L’étape de Mapping permet de relier les données Source à l’entrepôt de données. Cette
étape définit la manière d’alimenter les tables de l’entrepôt de données.
Créer la table de destination permet, si la case est cochée, de créer une table dans l’entrepôt
de données selon le nom que vous saisissez. Pour créer les colonnes vous pouvez utiliser les
boutons d’ajout d’axe ou réaliser un drag and drop des éléments à gauche vers la droite de
l’écran.
©Sage 2017 25
Module 3 : Répliquer
Si la table que vous souhaitez alimenter existe déjà, décochez l’option et allez chercher la
table existante.
Pour mapper vos champs existants, glissez votre champ source sur votre champ destination.
De plus, vous pouvez l’Expression en cliquant sur les … à droite du champ.
Dans cet écran vous pouvez utiliser les expressions disponibles en bas à gauche et faire appel
aux champs en haut à gauche. Des outils de recherche sont disponibles pour récupérer un
champ ou une syntaxe spécifique.
Le bouton Index permet de définir des index sur les tables de l’entrepôt Microsoft SQL Server.
©Sage 2017 26
Module 3 : Répliquer
Répéter pour
L’exécution d’un processus peut souvent varier selon des paramètres.
Exemple
On importe en limitant les lignes des données pour une seule année.
Il nous faut aller dans la purge pour modifier le filtre sur l’année, dans la requête SQL pour
changer l’année ou changer l’arborescence d’un répertoire pour aller lire les fichiers de la
nouvelle année.
Les variables vont permettre de gérer cette notion de variation de paramètre. Les variables
se définissent dans l’écran Répéter pour.
Pour définir la variable, faites un clic droit / Ajouter une variable à gauche de l’écran.
Note : La valeur cochée par défaut est utilisée lors des aperçus des différentes étapes et
sera proposée en premier à l’utilisateur.
©Sage 2017 27
Module 3 : Répliquer
Une fois définies, vous pourrez y faire appel dans les différentes étapes et sources ci-
dessous :
Note : Pour y faire appel vous devez placer un @ devant le nom de votre variable.
Le Traitement
Au lancement du processus, les différentes étapes sont exécutées selon l’ordonnancement
défini entre les étapes, par les flèches.
Lancement Manuel
Afin de lancer le processus, dans la Partie Répliquer, placez-vous sur le processus et cliquez
sur Exécuter.
L’écran ci-dessus apparaît avec en haut les variables et leurs valeurs disponibles. Si vous
saisissez une valeur qui n’est pas présente dans la liste des variables, le traitement l’utilisera
comme valeur envoyée au serveur.
Pour lancer le traitement, cliquer sur Lancer. Une fois le traitement terminé, vous pouvez
cliquer sur les liens hypertexte afin de voir le contenu de la table alimentée.
©Sage 2017 28
Module 3 : Répliquer
Lancement Automatisé
Les processus peuvent également être exécutés par une ligne de commande DOS. Afin
d’obtenir la ligne de commande, placez-vous sur le processus et réaliser un clic droit puis
Générer la ligne de commande.
L’ID du processus s’affiche en cliquant sur le bouton Renommer, une fois positionné sur le
processus concerné.
Exemple
©Sage 2017 29
Module 4 : Sécurité
Module 4 : Sécurité
Présentation
Le module Sécurité permet le contrôle d’accès aux données et aux fonctions Sage BI
Reporting. La sécurité est gérée par Groupe d’Utilisateurs. Par défaut, il existe le groupe
Groupe Administrateur avec un compte Admin. Le mot de passe du compte Admin est définit
lors de l’installation et doit vous être fourni par votre partenaire Sage BI Reporting. Ce groupe
a tous les droits dans l’application et ne peut être bridé.
• Des droits d’utilisation des Connecteurs : Pour une gestion encore plus fine de la
sécurité, vous pouvez cliquer dans la colonne Filtre d’un modèle pour appliquer des
filtres liés à un ou plusieurs axes. La syntaxe des filtres est la même que celle utilisée
dans Sage BI Reporting XL.
• Des droits d’utilisation des entrepôts de données : limiter l’accès et l’exécution des
processus et des actions définis dans le module Répliquer.
• Des droits d’utilisation de fonctions Sage BI Reporting
Note : Pour libérer une licence si plusieurs utilisateurs sont connectés en même temps, vous
pouvez faire sur le graphique un clic droit libérer la session.
Utilisateur Description
Nom de l’utilisateur
Nom
Prénom de l’utilisateur.
Prénom
Mail de l’utilisateur.
Email
Langue de l’utilisateur.
Langue
©Sage 2017 30
Module 4 : Sécurité
©Sage 2017 31
Module 4 : Sécurité
Note : Le type de licence est une option à préciser lors de la génération de la licence.
©Sage 2017 32
Module 5 : Options
Module 5 : Options
Présentation
Les options permettent de gérer le paramétrage SMTP utilisé par le module Diffuser et gérer
la licence applicative.
SMTP
Pour permettre au module Diffuser d’envoyer des mails, vous devez renseigner le
paramétrage SMTP.
©Sage 2017 33
Module 5 : Options
Licence
Cet écran indique les informations concernant votre licence. Si vous souhaitez modifier ou
changer la clé de licence :
©Sage 2017 34