Concevoir des rapports de forage

Les gestionnaires de base de données peuvent créer des définitions de rapport de forage en créant les mappages de colonne, puis en définissant une ou plusieurs régions forables.

Points à considérer pour la conception des rapports de forage

Le rapport de forage que vous créez est associé à un cube dans la section Scripts de l'inspecteur de la base de données.

Chaque définition de rapport de forage doit inclure un mappage de colonne et une région forable. Vous pouvez éventuellement définir un mappage pour les paramètres d'exécution, s'il existe une interrogation paramétrée dans la source de données qui fournit une connectivité de données sources externes pour vos rapports de forage.

Pour créer une définition de rapport de forage, vous devez disposer au moins du rôle Gestionnaire de base de données.

Vous pouvez créer des rapports de forage qui extraient les données d'un système de gestion de base de données relationnelle externe ou d'un fichier.

Note :

Si la source de données du rapport de forage est connectée à Oracle Database, vous pouvez cocher la case Utiliser des tables temporaires pour améliorer la performance des interrogations dont la clause SQL "IN" comporte un grand nombre de valeurs.

Vous pouvez également concevoir les rapports de forage pour accéder aux URL Web.

Définir des mappages de colonne pour les rapports de forage

Le mappage de colonne définit quelles colonnes de la source externe doivent être incluses dans le rapport, à quelles dimensions Essbase ces colonnes sont mappées et (éventuellement) une condition de filtre de génération/niveau indiquant la profondeur d'accès à accorder.

Pour bien comprendre les mappages de colonne, voir Définition de rapport de forage.

Définir des mappages de colonne :

  1. Dans la page Applications, ouvrez l'application et ouvrez le cube.

  2. Sélectionnez Scripts dans le panneau de gauche.

  3. Cliquez sur Rapports de forage.

  4. Cliquez sur Créer et sélectionnez Source de données dans le menu.

  5. Dans le champ Nom, ajoutez le nom du rapport.

  6. Dans le champ Source de données, sélectionnez la source de données que vous souhaitez utiliser.

  7. Créer des mappages de colonne :

    1. Sélectionnez les colonnes de la source de données externe que vous souhaitez inclure dans le rapport.

    2. Sélectionnez la dimension à laquelle vous souhaitez mapper chaque colonne.

    3. Sélectionnez une condition de filtre pour les mappages, par exemple, Level0, Generation ou None (pour le mappage de dimensions).


      Illustration des mappages de colonne pour un rapport de forage.

    4. Lorsque vous avez terminé, cliquez sur Régions forables. Vous ne pouvez pas enregistrer le rapport de forage sans définir de région, comme décrit dans Définir des régions forables pour les rapports de forage.

Définir des mappages de colonne :

  1. Dans la page Applications, développez l'application.

  2. Dans le menu Actions, à droite du nom du cube, cliquez sur Inspecter.

  3. Dans l'inspecteur d'application, sélectionnez l'onglet Scripts.

  4. Sélectionnez Rapports de forage.

  5. Cliquez sur Créer et sélectionnez Source de données dans le menu déroulant.

  6. Dans le champ Nom, ajoutez le nom du rapport.

  7. Dans le champ Source de données, sélectionnez la source de données que vous souhaitez utiliser.

  8. Créer des mappages de colonne :

    1. Sélectionnez les colonnes de la source de données externe que vous souhaitez inclure dans le rapport.

    2. Sélectionnez la dimension à laquelle vous souhaitez mapper chaque colonne.

    3. Sélectionnez une condition de filtre pour les mappages, par exemple, Level0, Generation ou None (pour le mappage de dimensions).


      Illustration du mappage de colonne dans l'assistant Rapport de forage.

  9. Lorsque vous avez terminé, cliquez sur Régions forables. Vous ne pouvez pas enregistrer le rapport de forage sans définir de région, comme décrit dans Définir des régions forables pour les rapports de forage.

Définir des régions forables pour les rapports de forage

Définissez une ou plusieurs régions forables dans le cube Essbase à partir duquel vous pouvez accéder (par "forage") à la source de données externe.

  1. Après avoir effectué les mappages de colonne, cliquez sur Régions forables.

  2. Cliquez sur le signe plus et sélectionnez l'une des méthodes suivantes :
    • Cliquez deux fois dans la rangée vide et définissez la région en utilisant la syntaxe de calcul : noms de membre et fonctions de jeu de membres.
    • Cliquez sur l'icône de crayon pour ouvrir Sélecteur de région forable, sélectionnez le membre à ajouter, cliquez avec le bouton droit de la souris et sélectionnez l'une des options de menu pour définir la région.
      Illustration du sélecteur de région forable dans Redwood.

  3. Cliquez sur Enregistrer. Un message est affiché, indiquant si le rapport de forage a bien été mis à jour.


    Illustration de l'onglet Régions forables dans l'Assistant Rapports de forage, avec une région définie pour Market, Year, Scenario, Sales, et des membres de niveau 1 dans Product.

Exemples de régions forables

Les exemples suivants montrent des régions forables dans Smart View, mises en surbrillance en bleu.

Exemple 1

Pour définir une région forable en haut des dimensions Market, Year et Scenario, du membre Sales et de tous les membres de niveau 1 de la dimension Product, utilisez :

Market,Year,Scenario,Sales,@LEVMBRS(Product,1)

Lorsque vous forez une feuille Smart View, la grille obtenue se présente comme suit :


Illustration d'une grille Smart View, avec les membres forables mis en surbrillance en bleu. La région définie est Market,Year,Scenario,Sales,@LEVMBRS(Product,1).

Exemple 2

Pour définir une région forable pour les descendants de Market, utilisez :

@DESCENDANTS(Market)

Lorsque vous forez une feuille Smart View, la grille obtenue se présente comme suit :


Illustration d'une grille Smart View, avec les cellules forables mises en surbrillance en bleu. La région définie est @DESCENDANTS(Market)

Exemple 3

Pour définir une région forable pour les membres de la génération 3 dans la dimension Product, en haut des dimensions Market, Year, Scenario et du membre Sales, utilisez :

Market,Year,Scenario,Sales,@GENMBRS(Product,3)

Lorsque vous forez une feuille Smart View, la grille obtenue se présente comme suit :


Illustration d'une grille Smart View, avec les cellules forables mises en surbrillance en bleu. La région définie est Market,Year,Scenario,Sales,@GENMBRS(Product,3).

Mettre en œuvre des paramètres pour les rapports de forage

Pour rendre les rapports de forage encore plus flexibles, vous pouvez concevoir le forage de façon à mettre en œuvre des paramètres.

Si vous avez un rôle de gestionnaire de base de données ou supérieur, vous pouvez mettre en œuvre des interrogations de source de données paramétrées dans les rapports de forage.

Préalables : un gestionnaire d'application ou un rôle supérieur vous a donné accès à une source de données qui utilise une valeur (par défaut) fixe, une variable de substitution ou une fonction définie par l'utilisateur externe en guise de paramètre.

Essbase détecte la valeur des paramètres lors de l'exécution et insère la valeur courante dans l'interrogation qu'Essbase génère lorsqu'un forage est effectué.

Dans la définition du rapport de forage, vous pouvez éventuellement ajouter un mappage de dimension, de génération et de niveau pour les paramètres d'exécution. Cela vous permet de personnaliser davantage les résultats des rapports de forage en fonction du contexte de variable courant.

Pour qu'Essbase crée dynamiquement des rapports de forage en fonction des variables, procédez selon le flux de travail suivant :

  1. Mettre en œuvre des paramètres pour les sources de données dans l'interrogation de source de données sous-jacente. Cette opération doit être effectuée par un gestionnaire d'application ou un rôle supérieur.

  2. Créez une Définition de rapport de forage associée à la source de données.

  3. Éventuellement, prévoyez une utilisation personnalisée des paramètres lors de l'exécution, dans la définition du rapport de forage. Un exemple est fourni ci-dessous.

  4. Testez et validez le comportement attendu en exécutant les rapports de forage et Déboguer le forage à l'aide du journal de la plate-forme du serveur Essbase.

Paramètres d'exécution et fonctions définies par l'utilisateur

Les exemples de cas d'utilisation suivants sont basés sur des hypothèses préalables :

  • Une fonction définie par l'utilisateur, getMonths, est définie dans le système source externe. Cette fonction retourne une liste de mois séparés par des virgules.

  • La source de données utilisée pour la définition du rapport de forage est définie à l'aide d'une interrogation qui appelle la fonction getMonths, comme suit :

    select * from SampleBasic where month in (getMonths(?))

Mappage de niveau 0 (récursif) de paramètre d'exécution

Dans la définition du rapport de forage, lorsque le paramètre d'exécution est lié à Year au Level0,


Onglet Paramètres d'exécution de la définition du rapport de forage. Parameter : Param1. Variable : coché. Value : Sample.mnth. Dimension : Year. Generation Binding : Level0 [Level]

si un utilisateur de Smart View fore sur Qtr1 de la dimension Year, le rapport de forage inclura Jan, Feb, Mar. Si un utilisateur de Smart View fore sur Year, le rapport de forage inclura Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec.

Mappage de génération de paramètre d'exécution

Dans la définition du rapport de forage, lorsque le paramètre d'exécution est lié à Year à la génération Quarter,


Onglet Paramètres d'exécution de la définition du rapport de forage. Parameter : Param1. Variable : coché. Value : Sample.mnth. Dimension : Year. Generation Binding : Quarter [Generation]

si un utilisateur de Smart View fore sur le membre de dimension Year, le rapport de forage inclura Qtr1, Qtr2, Qtr3, Qtr4.

Note :

Il n'est pas permis de régler une liaison de dimension/génération d'un paramètre d'exécution qui chevauche un mappage de colonne. L'interrogation générée dans ce cas est toujours un jeu nul.