Ajouter des membres à un parent spécifié

Lorsque vous devez ajouter de nouveaux membres à l'outline Essbase mais que les données source n'indiquent pas leurs ancêtres, concevez une règle de construction de dimension qui les ajoute à un membre parent spécifié. Utilisez la méthode de construction de dimension Ajouter en tant qu'enfant de pour ajouter tous les nouveaux membres en tant qu'enfants d'un parent spécifié.

Une fois que Essbase a ajouté tous les nouveaux membres à l'outline, vous pouvez vérifier les membres ajoutés et les déplacer ou les supprimer dans l'outline.

Pour cet exemple de construction de dimension, supposons que vous souhaitiez ajouter 600-54 et 780-22 en tant qu'enfants d'un membre d'outline existant, NewProducts.

Figure 14-6 Exemple d'ajout de membres en tant qu'enfant d'un parent spécifié


Cette image montre les nouveaux membres ajoutés en tant qu'enfants de NewProducts, comme décrit dans le texte précédant l'image.

Ce cas d'utilisation appelle la méthode de construction Ajouter en tant qu'enfant de. Dans cette méthode de création, lorsque Essbase rencontre un nouveau membre dans les données source, il ajoute le nouveau membre en tant qu'enfant du nom parent que vous indiquez. Le parent doit faire partie de l'outline avant de commencer la construction de la dimension.

Pour recréer cet exemple,

  1. Importez/créez le cube Sample Basic à l'aide du classeur d'application disponible dans la galerie du catalogue de fichiers sur le serveur Essbase.

  2. Créez un fichier de données délimité par des tabulations comme suit, nommez-le sibpar.txt et téléchargez-le vers le répertoire de cube Sample Basic.

    600-54	Texas	Sales	100	120	100
    780-22	Texas	Sales	111	154	180
  3. Ouvrez l'outline Sample Basic pour la modification dans l'interface Web Essbase et, dans la dimension Product, ajoutez un membre nommé NewProducts.

  4. Vérifiez et enregistrez l'outline.

  5. Sur la page d'accueil, ouvrez l'application, puis la base de données (cube).

  6. Sélectionnez l'onglet Scripts, puis cliquez sur Règles.


    L'onglet Scripts est sélectionné et la mosaïque Rules est mise en surbrillance dans l'interface Web Essbase.

  7. Cliquez sur Créer et choisissez Construction de dimension (standard).


    Dans la boîte de dialogue d'inspection de la base de données, cliquez sur le bouton Créer et l'option Construction de dimension (standard) est sélectionnée

  8. Dans la boîte de dialogue Nouvelle règle,

    1. Entrez un nom de règle, par exemple, sibpar.

    2. Pour Type de source, sélectionnez Fichier, cliquez sur Catalogue et accédez à sibpar.txt.

      Lorsque vous cliquez sur Catalogue, le fichier doit se trouver dans le répertoire du cube sur le serveur Essbase par défaut. Vous devez donc l'avoir déjà téléchargé à l'aide de la section Fichiers de l'interface Web Essbase. Si le fichier se trouve sur votre ordinateur client, cliquez sur Navigateur de fichiers pour le localiser.

    3. Conservez les champs Numéro d'enregistrement d'en-tête et Numéro d'enregistrement de construction de dimension sur 0. Les enregistrements d'en-tête ne sont pas utiles pour les builds de dimension.

    4. Remplacez la valeur Délimiteur de Virgule par Tabulation.

    5. Cliquez sur Continuer.

    6. La règle de construction de dimension s'ouvre avec des champs non définis et des données d'aperçu (à partir du fichier texte) alimentant la grille sous les champs.


      Nouvelle règle non terminée nommée sibpar. Les métadonnées de champ pour les champs 1 à 6 sont vides dans les sélecteurs de champ. Les enregistrements sont renseignés sous les sélecteurs de champ, ce qui correspond aux données du fichier .txt de l'étape 2.

  9. Comme il s'agit d'une nouvelle règle, aucune dimension n'est encore associée.

    1. Cliquez sur Dimensions.
      Bouton Dimensions dans l'éditeur de règles

    2. Sélectionnez ou saisissez le nom de dimension Produit, puis cliquez sur Ajouter.
  10. Vous devez maintenant définir la méthode de construction et vérifier les autres instructions opérationnelles de construction de dimension. Cliquez sur Produit pour modifier les propriétés.
    Nom de dimension Produit cliquable dans la boîte de dialogue Modifier les dimensions.

  11. Remplacez Build Method par Add as child of et saisissez le nom du membre parent de destination sous celui-ci (NewProducts).


    Propriétés de construction de dimension pour Product. Toutes les options restent par défaut, à l'exception de la méthode de création et du nom de membre, qui sont modifiés comme décrit.

    Cliquez ensuite sur OK.

  12. Cliquez sur le sélecteur Dimension dans le champ 1, puis sélectionnez Produit.


    Dimension de produit sélectionnable dans la zone Dimension du champ 1

  13. Laissez le sélecteur Type du champ 1 vide.

  14. Sélectionnez des champs 2-6. Pour ce faire, cliquez sur la zone d'en-tête inactive intitulée Champ 2, maintenez la touche Maj enfoncée, puis cliquez sur la zone d'en-tête Champ 6. Cliquez sur Ignorer.


    Nouvelle règle sibpar terminée, conçue pour ajouter des membres en tant qu'enfants d'un parent spécifié. Les métadonnées de champ des champs 1 à 6 contiennent Product pour la dimension, avec Type vide. Les enregistrements sont renseignés sous les sélecteurs de champ, ce qui correspond aux données du fichier .txt de l'étape 2. Les champs 2 à 6 sont marqués comme devant être ignorés lors de la construction de la dimension.

    Par conséquent, cette règle ne s'applique qu'au premier champ de chaque enregistrement. Ignorer les champs peut être utile lorsque vous n'avez pas besoin d'utiliser tous les champs de la source pour la construction de dimension, mais que vous ne voulez pas préparer d'autres sources.

  15. Vérifiez la règle, puis enregistrez-la et fermez-la. En cas d'erreur, reportez-vous à Conditions requises pour les fichiers de règles de construction de dimension valides.

  16. Exécutez le travail de construction de dimension.

    Si les travaux échouent avec l'erreur suivante, cela signifie probablement que l'outline ne contient pas le nom de membre parent requis (NewProducts, dans cet exemple).

    Member missing for add as child of dimension setting for dimension <name>
  17. Affichez l'outline et examinez le membre Product NewProducts pour vérifier que les membres ont été ajoutés.


    Visualiseur d'outline dans l'interface Web Essbase. La dimension Product est développée pour afficher le membre parent NewProducts avec deux nouveaux membres ajoutés : 600-54 et 780-22

Tableau 14-3 Résumé de l'ajout de membres en tant qu'enfant d'un parent spécifié

Champ Value En savoir plus

Dimension Product

Sélectionner l'option Ajouter en tant qu'enfant de la méthode de build

Sélectionner une méthode de build

Saisissez NewProducts dans la zone de texte Ajouter comme enfant de.

Champ 1 (Produit)

  • Ne pas sélectionner de type de champ pour le champ

  • Définir la dimension du champ sur Produit

Définir les informations de type de champ de construction de dimension

Champs 2 à 6

Ignorer les champs

Vous pouvez ignorer tous les champs d'une colonne spécifiée des données source.

Reportez-vous à Ignorer les champs.