Modernisation Oracle Forms

Créer un modèle Excel BI Publisher

Les organisations doivent souvent répondre à des besoins d’affaires variés pour générer différents types de documents. Les modèles Excel comptent parmi les plus utilisés en bureautique d’entreprise. Toutefois, créer des feuilles de calcul à partir de zéro peut être long et complexe. Il est donc plus pratique et plus efficace de créer un rapport BI Publisher dont la mise en page est conçue dans Excel.

Présentation de l’Excel Template

Un Excel Template est une mise en page de rapport BI Publisher conçue dans MS Excel. Avec un Excel Template, vous pouvez :

  • Associer les données BI Publisher à une feuille de calcul
  • Définir le format des données dans la sortie Excel
  • Répartir des données hiérarchiques sur plusieurs feuilles et nommer les feuilles dynamiquement
  • Créer des feuilles de données ayant des relations maître-détail
  • Utiliser les fonctionnalités natives d’Excel

Exigences et prérequis

Pour créer un Excel Template, vous devez disposer des outils suivants :

  • Oracle BI Publisher v 9.1 ou ultérieur, installé en mode autonome ou intégré à Oracle BI Enterprise Edition 9i ou ultérieur.
  • Le Data Model doit être créé dans BI Publisher, avec des données d’exemple disponibles.
  • Microsoft Office 2003 ou ultérieur doit être installé.
  • Template Builder for Excel doit être installé.

L’installation de Template Builder for Word installe aussi le plug-in pour Excel. Template Builder est également connu sous le nom d’Oracle BI Publisher Desktop.

Pour installer Oracle BI Publisher Desktop, vous devez vérifier que le serveur BI Publisher (BIP) installé dispose d’une version certifiée de BIP Desktop. Consultez la documentation du produit pour déterminer la version compatible avec votre système à installer. BIP Desktop se télécharge sur le site d’Oracle Analytics Publisher. Vous obtiendrez le fichier BIPPublisher32.exe ou BIPPublisher64.exe selon votre version de Microsoft Office.

Excel Template Builder

Excel Template Builder est une extension de Microsoft Excel qui facilite la création d’Excel Templates pour Oracle Bi Publisher. Excel Template Builder se compose de la barre de menus Bi Publisher, dont les options et les sous-menus sont regroupés dans les six menus suivants : Online, Load Data, Insert, Preview, Tools et Options.

Capture d’écran de l’onglet BI Publisher dans Microsoft Excel : groupes Online, Load Data, Insert, Preview, Tools et Options

Commandes Online

Groupe Online de l’onglet BI Publisher : Log On, Log Off, Open, View Report, Upload Template et Upload Template As

Vous pouvez utiliser Template Builder en mode connecté ou déconnecté.

Le bouton Log On établit une connexion directe au serveur BI Publisher depuis votre session Excel. En vous connectant directement à BI Publisher, vous pouvez parcourir le catalogue pour choisir le rapport auquel ajouter l’Excel Template ou, si seul le modèle de données est créé, sélectionner ce modèle de données et créer le rapport dans le catalogue depuis votre session Excel.

Le bouton Log Off met fin à la connexion au serveur BI Publisher.

Utilisez le bouton Open pour ouvrir un rapport depuis le serveur Bi Publisher.

Vous pouvez utiliser Upload Template ou Upload Template As pour téléverser le modèle dans le catalogue du serveur Bi Publisher, ou afficher le rapport avec le bouton View Report.

Commande Load Data

Vous pouvez aussi travailler hors ligne avec Template Builder pour créer des modèles à partir de données XML d’exemple ou de fichiers. Dans l’onglet Load data, utilisez le bouton Sample XML pour charger des données d’exemple.

Commandes Insert

Field - Insère des mappages de champs de données dans le modèle.

Repeating Group - Insère des mappages de groupes répétés dans le modèle.

Les commandes du menu Insert permettent aussi d’insérer des tableaux, des tableaux croisés dynamiques, des mises en forme conditionnelles, des listes, etc.

Commande Preview

Affiche un aperçu du modèle avec les données d’exemple, ou avec les données réelles en mode connecté. La fonction d’aperçu de Template Builder vous permet de tester votre modèle avant de le téléverser sur le serveur Bi Publisher. Lorsque vous cliquez sur Excel, les données d’exemple sont appliquées au modèle et le document de sortie s’ouvre dans un nouveau classeur.

Commandes Tools

Fournit un Field Browser pour examiner tout le code inséré et modifier ou supprimer des mappages. La commande Import importe un modèle Excel Analyser et le convertit en Excel Template.

Commandes Options

Le menu Options permet de changer les paramètres régionaux et de préciser les options qui influencent la façon dont Template Builder génère les tableaux et les formulaires, ou la fonction d’aperçu. Vous pouvez aussi utiliser le bouton Help pour accéder à la documentation d’aide en ligne.

Créer un Excel Template

Pour créer un Excel Template :

  • Étape 1 : disposer de données d’exemple.

Si vous travaillez en mode déconnecté

  1. Obtenez des données d’exemple à partir du rapport et enregistrez-les dans un répertoire local.
  2. Dans le menu Bi Publisher, cliquez sur Sample XML. Vous êtes invité à localiser le fichier de données d’exemple dans votre répertoire local.
  3. Sélectionnez le fichier de données d’exemple et cliquez sur OK. Le fichier XML d’exemple est chargé dans Template Builder.

Si vous travaillez en mode connecté

  1. Connectez-vous au serveur BI Publisher.
  2. Dans le menu BI Publisher, cliquez sur Open. La boîte de dialogue Open s’ouvre et affiche vos dossiers de rapports BI Publisher dans le volet de gauche.
  3. Sélectionnez un dossier pour voir, dans le volet Reports, les rapports et les modèles de données qu’il contient. Sélectionnez un rapport existant, ou un modèle de données pour en créer un nouveau.
  • Étape 2 : une fois les données d’exemple disponibles, concevez la mise en page.

La commande Field du groupe Insert associe les éléments des données d’exemple chargées à l’emplacement voulu dans la feuille de calcul.

  1. Sélectionnez la cellule de la feuille de calcul où le champ de données doit s’afficher.
  2. Dans l’onglet BI Publisher, dans le groupe Insert, cliquez sur Field.
  3. Capture d’écran de la boîte Field avec DEPARTMENT_NAME sélectionné dans l’arborescence des données DATA > DEPT > EMPS

3. Sélectionnez l’élément dans la boîte de dialogue Field et cliquez sur Insert. Les données d’exemple sont insérées dans la cellule

4. du modèle. Lorsque Template Builder insère un champ ou un groupe répété, il crée un mappage entre les données et la feuille de calcul, et l’écrit dans une feuille masquée appelée XDO_METADATA.

Modèle Excel dont la cellule Department est liée au champ XDO_?XDOFIELD1?, avec la valeur d’exemple Accounting

Template Builder crée la feuille masquée XDO_METADATA la première fois que vous insérez un champ ou un groupe répété. Pour consulter ou mettre à jour la feuille XDO_METADATA, affichez-la.

Feuille masquée XDO_METADATA : type de modèle TYPE_EXCEL_TEMPLATE et XDO_?XDOFIELD1? associé à DEPARTMENT_NAME

Si vous voulez répéter certains éléments, sélectionnez ces cellules dans la feuille de calcul, cliquez sur Repeating Group et saisissez les champs appropriés dans la boîte de dialogue Bi Publisher.

Boîte « BI Publisher Properties » d’un groupe répété : For Each DEPT, Group By DEPARTMENT_ID

Sélectionnez l’élément pour chaque occurrence duquel la boucle doit se répéter. En sélectionnant le champ de données For Each, vous indiquez à BI Publisher que, pour chaque occurrence du champ sélectionné dans les données, les éléments et les instructions de traitement contenus dans la boucle doivent être répétés.

Dans la liste Group By, sélectionnez le champ selon lequel vous voulez regrouper les données. Pour créer une boucle simple, ne sélectionnez pas d’élément de regroupement. Sélectionner un élément de regroupement réorganise les données selon une nouvelle hiérarchie fondée sur cet élément. Pour créer une boucle for-each imbriquée, sélectionnez On Grouping afin que la boucle for-each ne se répète que lorsque l’élément apparaît dans la boucle parente. Une fois les options de la boîte de dialogue définies, un nom défini Excel est attribué à la plage de cellules selon la syntaxe BI Publisher XDO_GROUP_?name?, et le code est écrit dans la feuille XDO_METADATA.

Feuille XDO_METADATA définissant XDO_GROUP_?XDOG1? comme un xsl:for-each-group sur DEPT, groupé par DEPARTMENT_ID

  • Étape 3 : tester le modèle

Dans l’onglet BI Publisher, dans le groupe Preview, cliquez sur Excel. Les données d’exemple sont appliquées au modèle et le document de sortie s’ouvre dans un nouveau classeur.

Si vous souhaitez en savoir plus sur la création de modèles Excel pour Oracle Analytics Publisher ou sur d’autres sujets liés à ces modèles, par exemple :

  • Répartir des données hiérarchiques sur plusieurs feuilles et nommer les feuilles dynamiquement
  • Insérer un champ calculé
  • Mettre en forme les dates

Nous serons heureux de vous aider! Vous pouvez nous joindre à info@renaps.com