Créer des dimensions et charger des données à l'aide d'un fichier de règles

Vous pouvez créer une dimension et charger des données à partir d'un fichier texte ou autre fichier plat à l'aide d'une règle.

Avant de commencer, vous aurez besoin des ressources suivantes :

Accédez à une instance d'Essbase.
Si vous n'utilisez pas de fichier plat comme source de données, vous aurez besoin d'une connexion et d'une source de données configurées dans Essbase au niveau de l'application.
Fichier de métadonnées de dimension (exemple de fichier pour exercice : dim-market.txt) téléchargé sur votre ordinateur.
Fichier de données (exemple de fichier pour exercice : data-basic.txt ) téléchargé sur votre ordinateur.

À l'aide des ressources indiquées, vous pouvez maintenant effectuer les tâches liées à la création des dimensions et au chargement des données à l'aide d'une règle.

Créer des dimensions à l'aide d'un fichier de règles

Vous pouvez modifier et mapper des dimensions à une structure Essbase à l'aide d'une règle, au lieu de créer manuellement des dimensions vides dans l'éditeur de structure Essbase. Cette section présente et illustre la création de dimensions à partir d'un fichier plat, à l'aide d'une règle.

Lors de la création à l'aide d'une règle, vous définissez la structure hiérarchique des dimensions et métadonnées de membre. Vous pouvez créer une ou plusieurs dimensions à l'aide d'un fichier de règles unique ou utiliser un fichier de règles par dimension.

Vous pouvez créer une dimension pour ajouter ou modifier des dimensions, mais vous ne pouvez pas l'utiliser pour supprimer une dimension existante.

Cette section illustre l'exemple d'une création de dimensions à partir d'un fichier plat, à l'aide de règles. Le processus de chargement des données à l'aide de SQL, ou par diffusion en continu, est décrit dans d'autres rubriques.

Ouvrez le fichier des métadonnées de dimension téléchargé, dim-market.txt, dans un éditeur de texte formaté. Notez que le fichier ne comporte pas de rangée d'en-tête et que le séparateur du fichier est une virgule.
Connectez-vous à l'interface Web d'Essbase.
Dans la page d'accueil, développez l'application Exemple et sélectionnez le cube de base.
Vous pouvez maintenant créer le fichier de règles.
1. Dans le menu Actions, à droite du cube, lancez l'inspecteur.
2. Cliquez sur Scripts, puis sur Règles. L'éditeur de règles est affiché, montrant les règles actuellement définies.
3. Cliquez sur Créer, puis sélectionnez Création de dimension (basée sur l'indexation) pour définir la règle de création de dimension. Une règle de création de dimension basée sur un index supprime la dépendance mutuelle des champs et leur permet d'être affichés dans n'importe quel ordre.
4. Dans la boîte de dialogue Nouvelle règle, entrez Dim_market1 comme nom du fichier de règles.
5. Sous Prévisualiser les données, sélectionnez Fichier pour l'option d'entrée de fichier plat.
6. Cliquez sur l'icône Parcourir pour repérer le fichier dim-market.txt que vous avez téléchargé, puis cliquez sur Ouvrir pour le sélectionner.
7. Comme vous l'avez vu auparavant, la première rangée du fichier plat ne contient pas de valeur d'en-tête. Désélectionnez la case à cocher Rangée d'en-tête, si celle-ci est cochée.
8. Réglez la valeur Séparateur à Virgule, en fonction du format de fichier.
9. Cliquez sur Continuer.
  Vous pouvez maintenant prévisualiser la structure de la dimension dans l'éditeur de règles, les colonnes étant affichées en fonction du fichier plat d'entrée.
La barre d'outils en haut à droite dans l'éditeur de règles montre les options globales pour une règle. Vous pouvez modifier les propriétés ou la source de données ici et voir les résultats. La barre d'outils à gauche de l'éditeur de règles montre les options de champ pour la règle.
Dans la page de l'éditeur de règles, vous pouvez maintenant configurer et modifier la règle.
1. Dans la page de prévisualisation de la nouvelle règle, dans le premier champ (colonne), cliquez sur Dimension, puis sélectionnez Marché comme nom de dimension. La dimension Marché est maintenant affectée à tous les champs.
2. Sous Marché, dans le premier champ, cliquez sur Type et sélectionnez le type de dimension, Parent.
  Le fichier source correspondant à cette règle est au format parent-enfant. Si le fichier source est basé sur la génération, vous pouvez régler le premier champ à Génération. Dans ce cas, le numéro de génération est réglé à 2, comme la génération 1 est par défaut la dimension elle-même.
3. Configurez les autres champs :
  Réglez le type du champ 2 à Enfant.
  
  Réglez le type du champ 3 à Propriété et la case Parent/Enfant sur la troisième rangée à Enfant.
  
  Pour les champs 4 et 5, réglez le type à ADU et les cases Parent/Enfant sur la troisième rangée à Enfant.
  
  Réglez le type des champs 6 à 9 à Alias, les cases Alias sur la troisième rangée à ChineseNames, JapaneseNames, RussianNames et GermanNames respectivement; et les cases sur la quatrième rangée à Enfant.
  
  Réglez le type du champ 10 à Membre d'attribut, la case sur la troisième rangée à Population et celle de la quatrième rangée à Enfant.
  
  Le champ Dimension est le plus souvent réglé à Génération, Parent ou Enfant. Si le nom de la dimension voulu ne figure pas dans le menu, cliquez sur Dimensions (dans la barre d'outils Global), ajoutez le nom de la dimension et cliquez sur Ajouter, puis sur OK.
4. Vérifiez maintenant les propriétés d'un champ. Sélectionnez la dernière colonne de champ, Population. Dans la barre d'outils des options de champ, ouvrez l'onglet Propriétés et vérifiez que l'option Casse est réglée à Aucune opération. Cela signifie que le texte en majuscules et en minuscules n'est pas traité différemment ici qu'il ne l'était dans le fichier texte source.
5. Dans la barre d'outils des options globales, cliquez sur l'onglet Source si vous souhaitez modifier le fichier source de données. Dans l'onglet Propriétés de fichier, vérifiez que le séparateur est réglé Virgule.
6. Lorsque vous avez terminé de définir la règle, cliquez sur Vérifier dans la barre d'outils des options globales pour valider la syntaxe de la règle.
7. Cliquez sur Enregistrer et fermer.
8. Cliquez sur Actualiser. Constatez que la règle que vous avez créée est maintenant indiquée dans le volet Règles de l'onglet Scripts. Cliquez sur le nom de la règle pour la modifier et cliquez sur Continuer.
  Dans le menu Actions d'une règle dans la liste, vous pouvez également choisir de copier, de renommer ou d'exporter la création (dans un fichier JSON à utiliser à des fins de dépannage). Cliquez sur Fermer pour retourner à la page d'accueil.
Ensuite, vous allez créer et exécuter un travail pour créer la dimension à l'aide de la règle.
1. Dans la page d'accueil, sélectionnez Travaux, puis Nouveau travail.
2. Sélectionnez Créer une dimension.
3. Dans la boîte de dialogue Créer une dimension, dans la liste Application, sélectionnez l'application Exemple.
4. Dans la liste Base de données, sélectionnez le cube De base. Le chargement peut prendre un certain temps
5. Dans la liste Script, sélectionnez la règle de création de dimension que vous avez créée, Dim_market1.rul.
6. Sélectionnez Fichier comme type de chargement.
7. Dans la liste Fichier de données, sélectionnez Dim_Market comme fichier de données de la dimension de données. Ce fichier se trouve dans le dossier Exemple, De base.
8. Dans la liste Options de restructuration, sélectionnez l'option Conserver les données d'entrée pour les données que vous voulez conserver.
  
  Pour déconnecter les autres utilisateurs connectés au cube Exemple, De base, afin de pouvoir créer immédiatement la dimension, vous pouvez sélectionner Forcer la création de dimension.
  
  Pour les données de niveau feuille, seules les valeurs de niveau 0 sont conservées. Utilisez cette option si toutes les données requises pour le calcul résident dans des membres de niveau 0. Pour les données d'entrée, seuls les blocs contenant les données en cours de chargement sont conservés. Aucune de ces options ne s'applique aux bases de données de stockage agrégé.
9. Cliquez sur OK. Le travail de création de dimension est exécuté.
10. Dans la page Travaux, cliquez sur Actualiser pour voir le statut du travail.
11. Lorsque le travail est terminé, cliquez sur le menu Actions pour le travail exécuté, puis sélectionnez Détails du travail pour vérifier le statut de votre travail de création.
12. Dans la page d'accueil des applications, à droite du cube de base dans l'application Exemple, ouvrez Actions, puis Structure pour vérifier la hiérarchie de la dimension. Dans Actions, Base de données, Inspecter, vous pouvez également voir les noms de génération créés sous l'onglet Dimension. Lorsque vous avez terminé, quittez la vue.
Vous avez maintenant terminé de créer une dimension à l'aide d'une règle.

Charger des données à l'aide d'un fichier de règles

Vous pouvez utiliser des règles pour extraire, transformer et charger des valeurs de données dans un cube Essbase. Les valeurs des données sources peuvent contenir les éléments suivants :

Valeurs de données
Noms de membre, alias et formules
Noms de génération et de niveau
Propriétés de stockage de données
Attributs et attributs définis par l'utilisateur

Lorsque vous créez un cube Essbase, des fichiers de données et des fichiers de règles de chargement de données sont créés dans le répertoire du cube. Vous pouvez également utiliser des données et des règles provenant d'une version sur place d'Essbase prise en charge.

Les formats de données de tableau croisé dynamique et de fichier plat de jeu de rangées sont pris en charge.

Lorsque vous chargez des données, les opérations SUM, MIN, MAX, AVG et COUNT sont prises en charge dans les colonnes de données sur l'ensemble des rangées. Les cas d'utilisation de mégadonnées, dans lesquels des cubes Essbase sont créés avec des membres de niveau supérieur, sont ainsi pris en charge. Vous pouvez effectuer un forage transversal, depuis Essbase, pour consulter des données à un niveau plus granulaire.

Cette section illustre l'exemple d'un chargement de données à partir d'un fichier plat, à l'aide de règles. Le processus de chargement des données à l'aide de SQL, ou par diffusion en continu, est décrit dans d'autres rubriques.

Ouvrez le fichier de données téléchargé, data-basic.txt, dans un éditeur de texte formaté. Notez qu'il ne comprend pas de rangée d'en-tête et que le séparateur du fichier est la virgule.
Connectez-vous à l'interface Web d'Essbase.
Dans la page d'accueil, développez l'application Exemple et sélectionnez le cube de base.
Maintenant, créez la règle de chargement.
1. Dans le menu Actions, à droite du cube de base, lancez l'inspecteur.
2. Sélectionnez l'onglet Scripts, puis Règles. L'éditeur de règles est affiché, montrant les règles actuellement définies.
3. Cliquez sur Créer, puis sélectionnez Chargement de données pour définir la règle de chargement de données.
4. Dans la boîte de dialogue Nouvelle règle, entrez Data_basic1 comme nom de la règle.
5. Entrez Mesures comme dimension de données.
6. Sous Prévisualiser les données, sélectionnez Fichier pour une entrée de fichier plat.
7. Cliquez sur l'icône Parcourir pour repérer le fichier data-basic.txt que vous avez téléchargé, puis cliquez sur Ouvrir pour le sélectionner.
8. Comme vous l'avez vu auparavant, la première rangée du fichier plat ne contient pas de valeur d'en-tête. Désélectionnez la case à cocher Rangée d'en-tête, si celle-ci est cochée. Lorsque la rangée d'en-tête est présente, les colonnes sont mappées automatiquement.
9. Sélectionnez Virgule comme valeur de séparateur, en fonction du format de fichier.
10. Cliquez sur Continuer.
  Vous pouvez maintenant voir la prévisualisation des données dans l'éditeur de règles, en fonction du fichier plat d'entrée.
La barre d'outils des options globales, en haut à droite de l'éditeur de règles, vous permet de modifier les propriétés de fichier ou la source de données et de voir les résultats dans l'éditeur de règles. La barre d'outils des options de champ, sur le côté gauche de l'éditeur de règles, vous permet de mapper les champs dans la règle.

Puisqu'il n'y a pas d'en-tête dans le fichier d'entrée, vous devez mapper chaque colonne avec les dimensions et les membres appropriés.
Dans l'éditeur de règles, vous pouvez maintenant configurer les champs de la règle.
1. Cliquez sur le menu déroulant Créer et commencez à définir les noms de champ.
  Réglez le champ (colonne) 1 à Produit.
  
  Réglez le champ 2 à Marché.
  
  Réglez le champ 3 à Année.
  
  Réglez le champ 4 à Scénario.
  
  Réglez le champ 5 à Ventes.
  
  Réglez le champ 6 à CPV.
  
  Réglez le champ 7 à Marketing.
  
  Réglez le champ 8 à Paie.
  
  Réglez le champ 9 à Divers.
  
  Réglez le champ 10 à Stock initial.
  
  Réglez le champ 11 à Ajouts.
  
  Toutes les dimensions doivent être représentées dans la règle de chargement de données avant de pouvoir charger des données.
2. Lorsque vous avez terminé de définir la règle, avec les options globales et de champ, cliquez sur Vérifier dans la barre d'outils des options globales pour en valider la syntaxe, puis cliquez sur Fermer.
3. Une fois la syntaxe validée, cliquez sur Enregistrer et fermer.
4. Cliquez sur Actualiser. Constatez que la règle que vous avez créée est maintenant indiquée dans le volet Règles de l'onglet Scripts. Cliquez sur le nom de la règle pour la modifier et cliquez sur Continuer.
5. Cliquez sur Fermer pour retourner à la page d'accueil des applications.
Ensuite, vous allez créer un travail pour charger les données à l'aide de la règle.
Dans la page d'accueil, sélectionnez Travaux, puis Nouveau travail.
1. Sélectionnez Charger les données.
2. Dans la boîte de dialogue Charger les données, dans le menu Application, sélectionnez l'application Exemple.
3. Dans la liste Base de données, sélectionnez le cube De base.
4. Dans la liste Script, sélectionnez la règle de chargement de données que vous avez créée, Data_market1.rul.
5. Sélectionnez Fichier comme type de chargement.
6. Sélectionnez le fichier Data_Basic1 dans la liste Fichier de données. Ce fichier se trouve dans le dossier Exemple > De base.
7. Facultatif : Cochez la case Abandonner en cas d'erreur si vous voulez que le chargement s'arrête si une erreur se produit.
8. Cliquez sur OK. Le travail de chargement de données est exécutée.
9. Dans la page Travaux, cliquez sur Actualiser pour voir le statut du travail.
Une fois le travail terminé, vérifiez que les enregistrements d'entrée ont été traités et chargés.
1. Dans la page d'accueil Applications, cliquez sur Actions à droite du cube de base dans l'exemple d'application.
2. Sélectionnez Détails du travail pour vérifier les résultats.
3. Cliquez sur Fermer lorsque vous avez terminé.
4. De nouveau dans la page d'accueil Applications, cliquez sur l'inspecteur Actions pour l'exemple de cube.
5. Sélectionnez Statistiques pour voir les statistiques obtenues pour le cube de base.
Vous avez maintenant terminé de charger des données à l'aide d'une règle.