Génération d'univers BO par les stratégies

Les spécifications d'un univers BO sont généralement écrites sous la forme d'un fichier Excel ou OpenOffice. Par exemple pour l'univers eMode (qui est fourni en exemple lors de l'installation de BO) une partie de ce fichier ressemblerait à :

Nous y retrouvons les objets BO, leurs différentes propriétés (classe, nom, type, qualification, description) ainsi que la formule SQL associée.

Dans Designer imaginez-vous créer un nouvel univers et de trouver directement les objets issus de ce fichier Excel, sans devoir les créer manuellement :

Les objets récupérés sont générés dans l'ordre avec les bons noms, les bonnes classes/sous-classes, les bonnes formules SQL et les bonnes descriptions :

Plus besoin de retaper tous les objets à partir des spécifications, tout correspond à 100 %

Je vous propose de voir comment à partir d'un tel fichier Excel on peut parvenir à ce résultat. Il faudra modifier certains fichiers de paramétrage de BO puis créer un fichier texte avec une certaine structure à partir du fichier Excel.

Une stratégie est une méthode dans le Designer pour créer les tables, les jointures ou les objets. Elle s'appuie sur une requête SQL ou sur un fichier.

On distingue les stratégies internes (natives/qu'on ne peut modifier) et externes (qu'on peut rajouter ou modifier).

Si vous avez déjà créé un univers, vous avez déjà utilisé une stratégie !

Par exemple pour ajouter des tables vous avez utilisé la stratégie interne qui lit le catalogue système du SGBD où sont stockés les noms des tables. Et pour créer les objets, vous avez peut-être utilisé la stratégie externe qui permet de créer des classes correspondant aux tables ?

Ces méthodes de génération sont à choisir dans l'onglet Stratégies des paramètres de l'univers :

On peut rajouter facilement des méthodes à celles existantes, en modifiant quelques fichiers de paramétrage comme nous allons le voir.

Pour utiliser une stratégie BO, il faut :

1. Modifier les fichiers de paramétrage de la connexion de l'univers ;
2. Créer un fichier texte source, qui contiendra toutes les informations nécessaires pour créer les objets de l'univers ;
3. Choisir et utiliser la stratégie dans Designer.

Nous allons détailler ces étapes dans le chapitre suivant.

Les stratégies existent depuis la v5 (au moins), mais nous ne traiterons ici que de la XI R2.

Les fichiers à modifier sont dans le répertoire du pilote d'accès (middleware) associé à la connexion de l'univers. Si la connexion utilise un pilote d'accès Oracle, il faut modifier les fichiers du répertoire oracle. Si elle utilise un pilote d'accès Teradata, il faut modifier les fichiers du répertoire teradata. Ici l'univers à créer est basé sur des tables Oracle, les fichiers à changer sont donc ceux spécifiques à Oracle.

Deux fichiers sont à modifier :

• oracle.stg : codes des stratégies ;
• oraclefr.stg : descriptions des stratégies.

Ils se trouvent dans $INSTALLDIR/dataAccess/RDBMS/connectionServer/<SGBDR> (où INSTALLDIR est le répertoire d'installation de Business Objects et <SGBDR> est à remplacer par le type de base de données voulu). Par exemple chez moi ils sont dans C:\Program Files\Business Objects\BusinessObjects Enterprise 11.5\win32_x86\dataAccess\connectionServer\oracle.

Le code d'une stratégie correspond à un bloc XML dans le fichier oracle.stg.

Voici par exemple le code d'une stratégie jointures :

<Strategy Name="Constraints">
<Type>JOIN</Type>
<SQL>SELECT
INSTANCE1.TABLE_NAME,'|',
INSTANCE2.TABLE_NAME,'|',
INSTANCE1.TABLE_NAME || '.' || INSTANCE1.COLUMN_NAME
|| ' = ' ||
INSTANCE2.TABLE_NAME || '.' || INSTANCE2.COLUMN_NAME, '|',
' ','|'
FROM
USER_CONSTRAINTS,
USER_CONS_COLUMNS INSTANCE1,
USER_CONS_COLUMNS INSTANCE2
WHERE
USER_CONSTRAINTS.OWNER = USER
AND USER_CONSTRAINTS.CONSTRAINT_NAME = INSTANCE1.CONSTRAINT_NAME
AND USER_CONSTRAINTS.R_CONSTRAINT_NAME = INSTANCE2.CONSTRAINT_NAME
AND USER_CONSTRAINTS.CONSTRAINT_TYPE = 'R'
AND INSTANCE1.POSITION = INSTANCE2.POSITION</SQL>
</Strategy>

Cette stratégie nommée "Constraints" va lire le catalogue Oracle des contraintes (tables USER_CONSTRAINTS et USER_CONS_COLUMNS) pour en déduire les jointures possibles.

Un bloc est composé de plusieurs éléments et de paramètres XML :

En fonction de la source de la stratégie (requête SQL ou fichier), on mettra un bloc <SQL> ou un bloc <File>.

Le deuxième fichier oraclefr.stg contient les descriptions des stratégies, toujours au format XML. Par exemple :

<Strategy Name="Constraints">
<Message id="Help">Cette stratégie de jointure lit les contraintes de la base de données et fournit une liste de jointures.</Message>
<Message id="Name">Stratégie externe : contraintes</Message>
</Strategy>

Le fichier a un encodage spécial pour les accents ; on trouvera par exemple dans les fichiers « stratégie » pour « stratégie ». Pour la lisibilité générale de l'article, les accents sont remis correctement dans les exemples de code.

Là aussi on a un bloc XML <Strategy> ayant le même nom en paramètre et composé de deux blocs <Message> :

Dans notre exemple on va lire un fichier texte (c:\temp\univers_objets.txt), on ajoute donc un bloc dans le fichier oracle.stg :

<Strategy Name="Fichier_objets">
<Type>OBJECT</Type>
<File>c:\temp\univers_objets.txt</File>
</Strategy>

Et on ajoute une description dans le fichier oraclefr.stg :

<Strategy Name="Fichier_objets">
<Message id="Help">Cette stratégie génère les objets BO à partir du fichier C:\temp\univers_objets.txt</Message>
<Message id="Name">Stratégie externe : Fichier objets</Message>
</Strategy>

Remarques

• D'autres paramètres peuvent être rajoutés à la balise XML comme Connexion pour utiliser une autre connexion que celle de l'univers et SkipMeasures pour passer l'écran qui concerne la création d'indicateurs dans l'assistant de création d'univers.
• Il faut vérifier dans le fichier oracle.sbo si le paramètre Strategies Name est bien défini avec le nom du fichier de stratégie externe. C'est le cas par défaut.

Le fichier source pour générer l'univers doit respecter un certain format.

Pour les objets, il est composé de neuf colonnes délimitées par des tabulations. Une colonne peut être laissée à vide, dans ce cas on a deux tabulations à la suite.

Chaque ligne est composée de :

Un fichier de ce type est rapidement généré à partir d'un fichier Excel de spécifications. Il suffit généralement de copier et de réordonner les colonnes, de rajouter des formules pour le SQL et de copier/coller le résultat dans un fichier texte. C'est ce qu'on a fait à partir du fichier Excel de spécifications pour avoir le fichier c:\temp\univers_objets.txt.

Remarques

• Le fichier ne doit pas contenir de retours à la ligne, notamment dans les descriptions.
• La description ne doit pas contenir de tabulation.
• Ne pas oublier la tabulation à la fin, sinon tous les objets sont en dimension !

Une fois le fichier créé dans le répertoire c:\temp il suffit de lancer Designer et de choisir la stratégie qu'on a créée dans les propriétés de l'univers :

Ensuite il faut choisir dans le menu Insertion/Objets Candidats et les objets définis dans le fichier apparaîtront comme par magie !

Remarques

• Pour prendre en compte des modifications sur les fichiers de stratégie ou sur le fichier de données, il faut fermer et rouvrir Designer.
• Il faut que le fichier de données existe (ça paraît évident mais il n'y a pas de message d'erreur si le fichier est absent) !
• Le bouton actualiser ne marche pas.
• Il faut vérifier dans le fichier oracle.sbo si le paramètre Strategies Name est bien défini avec le nom du fichier de stratégie externe. C'est le cas par défaut.