Cas d'utilisation 7 : Créer une dimension personnalisée avec hiérarchie

Vous pouvez créer une dimension avec une hiérarchie en définissant une structure hiérarchique basée sur le niveau parent-enfant.

Le domaine prédéfini SCM – Commande client ne contient pas les attributs et les niveaux hiérarchiques requis de la dimension Dim – Hiérarchie des parties. Dans ce cas d'utilisation, vous ajoutez un dossier Dim - Dimension Hiérarchie des parties au domaine prédéfini SCM - Commandes client. Ce dossier contient la hiérarchie Hiérarchie des niveaux de compte avec quatre niveaux, plus un niveau inférieur détaillé. La dimension personnalisée avec hiérarchie est jointe au fait Fait - Commandes client OM prédéfini à l'aide de la clé ID partie.

Ce cas d'utilisation requiert un abonnement à Fusion SCM Analytics. Toutefois, vous pouvez appliquer les concepts couverts dans ce cas d'utilisation à tout autre abonnement Fusion Data Intelligence. Le cas d'utilisation peut référencer des tables et des synonymes prédéfinis Autonomous AI Lakehouse et simuler des tables et des vues de base de données personnalisées. Si vous avez activé l'abonnement Fusion Data Intelligence spécifié, vous pouvez utiliser les exemples fournis. Il est recommandé de remplacer les exemples d'objets par vos propres objets Autonomous AI Lakehouse personnalisés, tels que la table personnalisée, la vue matérialisée, la vue, le synonyme personnalisé ou le synonyme d'ensemble de données d'augmentation des données.

Dans cette tâche, vous procédez comme suit :

1. Ajouter un fait personnalisé au modèle sémantique
2. Ajout d'une colonne physique à un fait prédéfini pour afficher la clé étrangère à joindre
3. Joindre la hiérarchie de dimensions libres à un fait prédéfini
4. Présentation de la hiérarchie de dimensions libres dans le modèle sémantique
5. Appliquer et publier les personnalisations
6. Validation des résultats

Pour effectuer cette tâche, procédez comme suit :

• Domaine prédéfini : SCM – Commandes client

Veillez à vous reporter à la section Upload Samples for the Semantic Model Extensions Use Cases et à remplir les conditions suivantes :

• Créez un modèle d'environnement restreint nommé MySandbox5Mar25. Reportez-vous à Création d'un modèle d'environnement restreint Vous pouvez également modifier un modèle d'environnement restreint existant dans la page Extensions de modèle sémantique, par exemple en cliquant sur le modèle d'environnement restreint MySandbox5Mar25.
• Générez l'exemple de vue de dimension FDI_X_PARTY_HIERARCHY_D_V à l'aide du script SQL suivant :

  CREATE OR REPLACE FORCE EDITIONABLE VIEW "OAX_USER"."FDI_X_PARTY_HIERARCHY_D_V" ("PARTY_ID", "LVL1", "LVL2", "LVL3", "LVL4", "LVL_DETAIL") DEFAULT COLLATION "USING_NLS_COMP"  AS 
    (
  SELECT DISTINCT
  PARTY_ID,
  NVL(COUNTRY,'~No Value~') as LVL1,
  NVL(STATE,'~No Value~') as LVL2,
  NVL(CITY,'~No Value~') as LVL3,
  NVL(POSTAL_CODE,'~No Value~') as LVL4,
  NVL(PARTY_NAME,'~No Value~') as LVL_DETAIL
  FROM
  OAX$OAC.DW_PARTY_D
  where (CUSTOMER_FLAG <> 'N' or CUSTOMER_FLAG is null)
  );

• Accordez l'accès au modèle sémantique à la vue FDI_X_PARTY_HIERARCHY_D_V pour le schéma OAX$OAC à l'aide du script SQL suivant :

  GRANT SELECT ON "OAX_USER"."FDI_X_PARTY_HIERARCHY_D_V" TO "OAX$OAC";

• Vérifiez que les données sont chargées à partir de l'exemple comme prévu à l'aide du script SQL suivant :

  SELECT * FROM OAX_USER.FDI_X_PARTY_HIERARCHY_D_V;

• Confirmez que la clé étrangère est unique afin d'éviter les résultats inexacts dus à une éventuelle duplication en raison d'une granularité incorrecte en entrant ce script SQL sous SQL Worksheet dans le volet de droite du client SQL Developer :

  SELECT PARTY_ID, COUNT(*)
  FROM FDI_X_PARTY_HIERARCHY_D_V
  GROUP BY PARTY_ID
  HAVING COUNT(*) > 1;

Ajouter un fait personnalisé au modèle sémantique

Vous modifiez l'étoile logique pour définir les objets, les attributs, les libellés d'affichage, les clés et la hiérarchie du data warehouse autonome.

Cette étape consiste à modifier l'étoile logique Fait - Commandes client OM pour ajouter une dimension personnalisée Dim - Dimension de hiérarchie de partie référençant l'objet d'entrepôt de données autonome FDI_X_PARTY_HIERARCHY_D_V et à définir une hiérarchie à plusieurs niveaux nommée Hiérarchie de niveau compte. Pour chaque niveau, le cas d'utilisation définit une clé primaire et un attribut d'affichage uniques.

1. Sur la page Extensions de modèle sémantique, cliquez sur le modèle d'environnement restreint MySandbox5Mar25.
2. Dans Effectuer une action, cliquez sur Gérer l'étoile logique, puis sur Modifier l'étoile logique, sélectionnez Prêt à l'emploi, sélectionnez le domaine SCM – Commandes client, sélectionnez Fait – Commandes client OM, puis cliquez sur Suivant.
3. Sur la page Logical Star : Fait, cliquez sur Gérer la dimension, puis sur Ajouter une dimension.
   
   

   

   
   
4. Sur la page Ajouter une dimension, à l'étape 1 de l'assistant, sélectionnez OAX_USER dans Schéma, sélectionnez FDI_X_PARTY_HIERARCHY_D_V dans Objet et renommez Nom de dimension en Dimension de hiérarchie de parties. Cochez la case Utiliser pour la clé pour la colonne source PARTY_ID, cochez la case Ajouter des attributs pour les colonnes source LVL2, LVL_DETAIL, LVL3, LVL4, LVL1 et PARTY_ID, puis cliquez sur Suivant.
   
   

   

   
   
5. Cochez la case Ajouter une hiérarchie au domaine, entrez Hiérarchie des niveaux de compte dans Nom et faites glisser chaque attribut vers le niveau correspondant.
   
   

   

   
   
6. Pour chaque niveau, cliquez sur le niveau, cliquez sur l'icône en forme de crayon, puis définissez la clé primaire et l'attribut display.

   Remarque :

   Vous pouvez préférer utiliser un ID interne / une clé entière pour chaque niveau, si disponible. Pour le niveau de détail, ce cas d'emploi utilise l'ID partie pour la clé.

   
   
   

7. Cliquez sur Terminer.

Ajout d'une colonne physique à un fait prédéfini pour afficher la clé étrangère à joindre

Vous allez étendre le fait prédéfini pour afficher les colonnes physiques qui seront utilisées comme clés pour joindre la nouvelle dimension libre dans l'étoile logique. Vous devez attribuer des noms uniques aux colonnes logiques.

Au cours de cette étape, vous allez étendre Fait - Commandes client OM pour afficher la colonne physique BILL_TO_PARTY_ID à utiliser comme clé pour la jointure à la nouvelle dimension personnalisée Dim - Dimension Hiérarchie des parties. Le nom unique ID partie est attribué à BILL_TO_PARTY.

1. Sur la page Extensions de modèle sémantique, cliquez sur le modèle d'environnement restreint MySandbox5Mar25.
2. Dans Effectuer une action, cliquez sur Gérer l'étoile logique, puis sur Modifier l'étoile logique, sélectionnez Prêt à l'emploi, sélectionnez le domaine SCM – Commandes client, sélectionnez Fait – Commandes client OM, puis cliquez sur Suivant.
3. Sur la page Étoile logique : Fait, cliquez avec le bouton droit de la souris sur Fait - Commandes client OM, puis cliquez sur Gérer l'extension.
   
   

   

   
   
4. Sur la page Ajouter des colonnes, cliquez sur Ajouter une colonne physique, puis dans Sélectionner une colonne physique, sélectionnez BILL_TO_PARTY_ID dans Fact_DW_OM_FULFILLMENT_CF, puis cliquez sur OK.
   
   

   

   
   
5. Sous la colonne logique, entrez l'ID partie comme nom unique, puis cliquez sur Terminer.
   
   

   

   
   

Joindre la hiérarchie de dimensions libres à un fait prédéfini

Vous joignez la hiérarchie de dimension libre au fait prédéfini en définissant le type de jointure, la condition de jointure et le niveau de contexte. Bien que vous puissiez définir des jointures complexes, utilisez autant que possible des jointures standard.

Cette étape consiste à définir une jointure interne standard sur le fait Fait - Commandes client OM prédéfini vers la hiérarchie de dimension personnalisée Dim - Dimension Hiérarchie des parties à l'aide de la clé ID partie de chaque table. Vous définissez le niveau de contenu sur Détails.

1. Sur la page Extensions de modèle sémantique, cliquez sur le modèle d'environnement restreint MySandbox5Mar25.
2. Dans Effectuer une action, cliquez sur Gérer l'étoile logique, puis sur Modifier l'étoile logique, sélectionnez Prêt à l'emploi, sélectionnez le domaine SCM – Commandes client, sélectionnez Fait – Commandes client OM, puis cliquez sur Suivant.
3. Dans la page Logical Star : Fact, faites glisser la hiérarchie des dimensions libres vers le fait prédéfini.
   
   

   

   
   
4. Dans la boîte de dialogue Joindre, joignez-vous à l'ID partie (nouvelle colonne physique ajoutée) et à l'ID partie (de la hiérarchie des dimensions personnalisées). Cet exemple utilise une jointure interne. D'autres peuvent nécessiter une jointure de gauche (ou un autre type de jointure). Définissez le niveau de contexte sur Détails, puis cliquez sur Terminé.
   
   

   

   
   
5. Vérifiez la jointure en mode graphique.
   
   

   

   
   
6. Cliquez sur la flèche vers le bas dans la page Logical Star : Fact pour revenir à la page Sandbox : MySandbox5Mar2025.

Présentation de la hiérarchie de dimensions libres dans le modèle sémantique

Vous modifiez le domaine pour présenter les nouveaux attributs de dimension libre et les nouveaux niveaux de hiérarchie.

Le système représente la dimension en tant que dossier contenant des colonnes dans le domaine et représente les niveaux hiérarchiques au bas du dossier de dimension libre. Les niveaux de hiérarchie utilisés dans les classeurs peuvent être développés et réduits pour afficher ou masquer des lignes détaillées.

Au cours de cette étape, vous modifiez le domaine SCM – Commande client pour présenter le nouveau dossier personnalisé Dim – Dimension de hiérarchie des parties contenant la hiérarchie personnalisée Hiérarchie des niveaux de compte avec quatre niveaux (Niveau 1, Niveau 2, Niveau 3, Niveau 4) et le niveau détaillé le plus bas.

1. Accédez à la page MySandbox5Mar25, cliquez sur Effectuer une action, cliquez sur Gérer les domaines, sélectionnez Modifier un domaine, sélectionnez le domaine Commandes client SCM, puis cliquez sur Suivant.
2. Sur la page Modifier un domaine, à l'étape 1 de l'assistant, affichez les détails et cliquez sur Suivant.
3. A l'étape 2 de l'assistant, cliquez sur Gérer les éléments, sur Gérer les nouvelles personnalisations, puis, dans Ajouter un domaine, sélectionnez les éléments de hiérarchie et de dimension, puis cliquez sur Ajouter.
   
   

   

   
   
4. Vérifiez les éléments sélectionnés et cliquez sur Terminer.
   
   

   

   
   

Appliquer et publier les personnalisations

Vous appliquez les modifications pour compiler le modèle d'environnement restreint et assurez-vous qu'il ne comporte aucune erreur.

Ensuite, vous utilisez l'onglet Activité pour déboguer, résoudre les erreurs et vérifier que l'action Appliquer les modifications est terminée et qu'elle a réussi. Enfin, vous fusionnez les modifications dans le modèle d'environnement restreint principal et publiez les principales extensions utilisateur pour partager les nouvelles extensions avec les consommateurs.

Cette étape consiste à appliquer les modifications, à utiliser l'onglet Activité pour surveiller le statut, à fusionner le modèle d'environnement restreint MySandbox5Mar25 avec le modèle d'environnement restreint principal, puis à publier l'extension utilisateur principale.

1. Sur la page Extensions de modèle sémantique, positionnez le pointeur de la souris sur le modèle d'environnement restreint MySandbox5Mar25 pour afficher les actions, puis cliquez sur Appliquer les modifications.
2. Cliquez sur l'onglet Activité pour surveiller la tâche Appliquer les modifications sur la page Activité.
3. Une fois les modifications appliquées, cliquez sur Publier le modèle sur la page Extensions de modèle sémantique.
4. Dans Publier le modèle, dans Extensions utilisateur, sélectionnez MySandbox5Mar25 et dans Configurations de sécurité, sélectionnez Tout.
5. Cliquez sur Publier.
6. Sur la page Extensions de modèle sémantique, cliquez sur l'onglet Activité pour surveiller la tâche Publier des personnalisations.
   Reportez-vous à Appliquer les modifications et à Publier le modèle.

Validation des résultats

Vérifiez que vos personnalisations sont visibles dans le modèle sémantique.

1. Dans la console Fusion Data Intelligence, cliquez sur Accéder à la page d'accueil.
2. Sur la page d'accueil d'Oracle Analytics, cliquez sur Créer, cliquez sur Classeur, dans Ajouter des données, sélectionnez SCM - Commandes client, puis cliquez sur Ajouter au classeur.
3. Vérifiez que la nouvelle dimension avec la hiérarchie apparaît par défaut au bas du dossier.
   
   

   

   
   
4. Ajoutez le niveau 1 et une mesure à la visualisation.
   
   

   

   
   
5. Développez et réduisez les niveaux et confirmez qu'ils fonctionnent comme prévu.
   
   

   

   
   
6. Vérifiez que les champs de dimension sont également disponibles (sans développer ni réduire).
   
   

   

   
   
7. Consulter le rapport.