Cas d'utilisation 3 : Ajouter une dimension personnalisée à un fait prédéfini

Vous pouvez ajouter un dossier de dimensions personnalisées contenant des attributs descriptifs et joindre la dimension personnalisée à une table de faits prédéfinie avec des clés définies.

Le domaine SCM – Commande client prédéfini ne contient pas l'attribut de dimension Service d'articles personnalisés requis. Dans ce cas d'utilisation, vous ajoutez un dossier Service d'articles personnalisés au domaine prédéfini SCM – Commandes clients. Ce dossier contient l'attribut Service. La dimension personnalisée est jointe au fait prédéfini Fact – Commandes clients OM à l'aide d'une clé composite ID organisation et ID article en stock.

Ce cas d'utilisation nécessite 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 d'Autonomous Data Warehouse et simuler des vues et des tables 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 Data Warehouse personnalisés tels que table personnalisée, vue matérialisée, vue, synonyme personnalisé ou synonyme de jeu de données d'augmentation de données.

Dans cette tâche, vous effectuez les opérations suivantes :

Utilisez ce qui suit pour effectuer cette tâche :

Attribut - Service
Domaine - SCM - Commandes clients
Dossier de faits - Dim - Commandes clients OM

Assurez-vous de faire référence à Charger les échantillons pour les cas d'utilisation des extensions de modèle sémantique et de remplir les préalables suivants :

Créez un bac à sable intitulé MySandbox5Mar25. Voir Créer un bac à sable. Vous pouvez également modifier un bac à sable existant dans la page Extensions de modèle sémantique; par exemple, en cliquant sur le bac à sable MySandbox5Mar25.

Générez l'exemple de vue de dimension FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V à l'aide du script SQL suivant :

CREATE OR REPLACE FORCE EDITIONABLE VIEW "OAX_USER"."FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V" ("ORG_ITEM_KEY", "ORGANIZATION_ID", "INVENTORY_ITEM_ID", "DEPARTMENT") DEFAULT COLLATION "USING_NLS_COMP"  AS 
  (
SELECT ORGANIZATION_ID || INVENTORY_ITEM_ID AS ORG_ITEM_KEY,
ORGANIZATION_ID, INVENTORY_ITEM_ID,
CASE SUBSTR(INVENTORY_ITEM_ID,-1,1)
WHEN '1' THEN 'Clothing'
WHEN '2' THEN 'Shoes'
WHEN '3' THEN 'Cosmetics'
WHEN '4' THEN 'Furniture'
WHEN '5' THEN 'Gardening'
WHEN '6' THEN 'Hardware'
WHEN '7' THEN 'Home Appliances'
WHEN '8' THEN 'Houseware'
WHEN '9' THEN 'Paint'
WHEN '0' THEN 'Sporting Goods'
ELSE 'Other'
END DEPARTMENT
FROM OAX$OAC.DW_INVENTORY_ITEM_D
);

Accordez l'accès au modèle sémantique à la vue FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V pour le schéma OAX$OAC à l'aide du script SQL suivant :
```
GRANT SELECT ON "OAX_USER"."FDI_X_ITEM_CUSTOM_DEPARTMENT_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_ITEM_CUSTOM_DEPARTMENT_D_V;
```

Ajouter une dimension personnalisée au modèle sémantique

Vous modifiez l'étoile logique pour définir l'objet d'entrepôt de données autonome, les attributs, les étiquettes d'affichage, les clés et la hiérarchie.

Dans cette étape, vous modifiez l'étoile logique Fact – OM - Commandes clients pour ajouter une dimension personnalisée Service d'articles personnalisés référençant l'objet d'entrepôt de données autonome FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V.

Dans la page Extensions de modèle sémantique, cliquez sur le bac à sable MySandbox5Mar25.
In Perform Action, click Manage Logical Star, then Edit Logical Star, then Out of the box, then select SCM - Sales Orders as the subject area, select Fact - OM Sales Orders as the corresponding fact, and then click Next.
Dans la page Étoile logique : Fait, cliquez sur Gérer la dimension, puis sur Ajouter une dimension.
In step 1 of the Add a Dimension wizard, select OAX_USER in Schema, select FDI_X_ITEM_CUSTOM_DEPARTMENT_D_V in Object, and enter Custom Item Department in Dimension Name. Cochez la case Ajouter des attributs pour DEPARTMENT et ORG_ITEM_KEY. Cochez la case Use for Key (Utiliser comme clé) pour INVENTORY_ITEM_ID, ORGANIZATION_ID et ORG_ITEM_KEY. Cliquez sur Suivant.
À l'étape 2 de l'assistant, laissez la case Add Hierarchy to Subject Area (Ajouter une hiérarchie au domaine) désélectionnée pour omettre une hiérarchie. Toutefois, il est nécessaire de nommer la hiérarchie et de mapper une clé primaire et d'afficher l'attribut dans l'étoile logique, bien que la hiérarchie n'apparaisse pas dans le domaine. Effectuez cette étape comme suit :
- Entrez Hiérarchie des services d'articles personnalisés dans Nom de la hiérarchie.
- Dans Propriétés, définissez la clé primaire et l'attribut d'affichage comme suit :
  - Cliquez sur l'icône en forme de crayon pour Clé principale et sélectionnez Clé d'article d'organisation.
  - Cliquez sur l'icône en forme de crayon pour Afficher l'attribut et sélectionnez Clé d'article d'organisation.
- Sous Éléments de données sélectionnés, à partir des éléments de données disponibles, effectuez un glisser-déposer et ajoutez Service et Clé d'article d'organisation au niveau Détails.
  Note
  
  Vous pouvez ajouter les attributs d'affichage de dimension à un niveau ou au niveau Détails.
Cliquez sur Terminer. Passez à la tâche suivante sans quitter l'assistant, Add Physical Column to a Prebuilt Fact (Ajouter une colonne physique à un fait prédéfini).

Ajouter une colonne physique à un fait prédéfini

Vous étendez le fait prédéfini pour exposer les colonnes physiques que vous utilisez comme clés pour joindre la nouvelle dimension personnalisée dans l'étoile logique.

Dans cette étape, vous allez étendre Fact – Commandes clients OM pour exposer les colonnes physiques ORGANIZATION_ID et INVENTORY_ITEM_ID à utiliser comme clés pour se joindre à la nouvelle dimension personnalisée Service d'articles personnalisés. Vous devez fournir des noms uniques pour les colonnes logiques; par exemple, ORGANIZATION_ID reçoit un nom unique ID organisation d'UC et INVENTORY_ITEM_ID reçoit un nom unique ID article de stock d'UC.

Dans la page Étoile logique : Fait, cliquez avec le bouton droit de la souris sur Fact – Commandes clients OM, puis cliquez sur Gérer la prolongation.
Dans la page Bac à sable : MySandbox5Mar25, cliquez sur Gérer l'extension, puis sur Ajouter des colonnes.
Dans la page Ajouter des colonnes, cliquez sur Ajouter une colonne physique.
Dans Sélectionner des colonnes physiques, cochez la case ORGANIZATION_ID et INVENTORY_ITEM_ID, puis cliquez sur OK.

Note

Ces colonnes proviennent de la table Fact_DW_OM_FULFILLMENT_CF.
Dans la page Ajouter des colonnes, dans Colonne logique, entrez des noms de colonne logique uniques tels que ID organisation UC et ID article de stock UC, puis cliquez sur Terminer.

Note

Il est très important que le nom de colonne logique soit unique et n'entre pas en conflit avec le nom de colonne prédéfini.
Passez à la tâche suivante sans quitter l'assistant, Joint the Custom Dimension to the Prebuilt Fact (Joindre la dimension personnalisée au fait prédéfini).

Joindre la dimension personnalisée au fait prédéfini

Vous joignez la dimension personnalisée au fait prédéfini en définissant le type de jointure, la condition de jointure et le niveau de contexte. Vous pouvez définir des jointures complexes. Toutefois, il est recommandé d'essayer d'utiliser des jointures standard lorsque cela est possible.

Dans cette étape, vous définissez une jointure externe gauche standard dans le fait prédéfini Fact – Commandes clients OM pour la dimension personnalisée Dim – Service d'article personnalisé à l'aide d'une clé composite comprenant ID organisation UC et ID article de stock UC de chaque table. Le niveau de contenu est réglé à Détails.

Dans la page Étoile logique : Fait, cliquez sur le cercle de dimension personnalisée Dim - Service d'article personnalisé et faites-le glisser vers le cercle de fait prédéfini Fact - Commandes clients OM dans le format graphique pour ouvrir la boîte de dialogue Jointure.
In the Join dialog, set Join Type as Left Outer, set Content level to Detail, set Join Condition as follows and then click Done:
- Pour Fait - Commandes clients OM, sélectionnez ID organisation UC (DOUBLE) et Dim - Service d'article personnalisé, sélectionnez ID organisation (DOUBLE).
- Pour Fait - Commandes clients OM, sélectionnez ID article de stock UC (DOUBLE) et Dim - Service d'article personnalisé, sélectionnez ID article de stock (DOUBLE).
Vérifiez les jointures personnalisées dans le format tabulaire.
Vérifiez les jointures personnalisées dans le format graphique.

Présenter la dimension personnalisée dans le modèle sémantique

Vous modifiez le domaine pour présenter la nouvelle dimension personnalisée et ses attributs. La dimension est représentée sous la forme d'un dossier contenant des colonnes dans le domaine.

Dans cette étape, vous modifiez le domaine SCM – Commande client pour présenter le nouveau dossier de dimension personnalisée Service d'article personnalisé contenant la colonne d'attribut Service.

Revenez au bac à sable MySandbox5Mar25, cliquez sur Effectuer une action, puis sur Gérer les domaines, puis sur Modifier un domaine. Sélectionnez SCM – Commandes clients et cliquez sur Suivant.
Dans la page Modify a Subject Area - SCM - Sales Orders, vérifiez les détails du domaine à l'étape 1 de l'assistant et cliquez sur Next (Suivant).
À l'étape 2 de l'assistant, cliquez sur Manage Elements (Gérer les éléments), puis sur Manage New Customizations (Gérer les nouvelles personnalisations).
Dans Ajouter un domaine, sous Personnalisé, sélectionnez la colonne d'attribut Service, puis cliquez sur Ajouter.

Le dossier Dim - Service de l'article personnalisé est alors ajouté au modèle sémantique et la colonne Service est placée dans le dossier.
Vérifiez les éléments de données sélectionnés et cliquez sur Terminer.

Appliquer et publier les personnalisations

Vous appliquez les modifications pour compiler le bac à sable et assurez-vous qu'il ne comporte pas d'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 réussie. Enfin, vous fusionnez les modifications apportées au bac à sable principal et publiez les extensions utilisateur principales pour partager les nouvelles extensions avec les consommateurs.

Dans cette étape, vous appliquez les modifications, utilisez l'onglet Activité pour surveiller le statut, fusionnez le bac à sable MySandbox5Mar25 avec le bac à sable principal, puis publiez l'extension d'utilisateur principale.

Dans la page Extensions de modèle sémantique, pointez le bac à sable MySandbox5Mar25 pour voir les actions, puis cliquez sur Appliquer les modifications.
Cliquez sur l'onglet Activité pour surveiller la tâche Appliquer les modifications dans la page Activité.
Une fois les modifications appliquées, cliquez sur Publier le modèle dans la page Extensions de modèle sémantique.
Dans Publish Model, dans User Extensions, sélectionnez MySandbox5Mar25 et, dans Security Configurations, sélectionnez All (Tout).
Cliquez sur Publier.
Dans la page Extensions de modèle sémantique, cliquez sur l'onglet Activité pour surveiller la tâche Publier les personnalisations.
Voir 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.

Dans la console Fusion Data Intelligence, cliquez sur Aller à la page d'accueil.
Dans la page d'accueil d'Oracle Analytics, cliquez sur Créer, cliquez sur Classeur, dans Ajouter des données, sélectionnez SCM – Commandes clients, domaine étendu dans ce cas d'utilisation, puis cliquez sur Ajouter au classeur.
Développez le dossier Service de l'article personnalisé et vérifiez que la colonne d'attribut Service s'affiche par défaut en bas du domaine. Faites glisser la colonne Service vers le classeur.
Faites glisser une mesure telle que Nombre de lignes à partir du dossier Faits - Commandes clients pour confirmer que le fait peut être joint à la dimension personnalisée.
Vérifiez les résultats.