Documentation Oracle Cloud Infrastructure

Cas d'utilisation 1 : Extension d'une dimension conforme

Vous pouvez étendre un dossier de dimensions en ajoutant de nouvelles colonnes qui représentent des attributs descriptifs supplémentaires liés à la dimension conforme.

Le dossier Détails de facturation du client (sous-dossier du dossier Site client du domaine prédéfini Gestion financière - Régularisations des comptes clients) contient déjà l'attribut Pays de facturation contenant l'abréviation à deux lettres du pays. Toutefois, l'attribut descriptif supplémentaire Nom complet du pays est manquant.

Dans ce cas d'utilisation, vous ajoutez la colonne Nom complet du pays d'une source externe dans le dossier prédéfini Détails de facturation du client pour associer l'attribut de pays complet au site client. Vous joignez l'extension personnalisée à la dimension prédéfinie conforme Dim – Lieu de facturation du client à l'aide de l'ID lieu du client.

Ce cas d'utilisation requiert l'abonnement Fusion ERP Analytics. Toutefois, vous pouvez appliquer les concepts abordés dans ce cas d'utilisation à tout autre abonnement Fusion Data Intelligence. Le cas d'utilisation peut référencer les tables et synonymes prédéfinis Autonomous Data Warehouse et simuler des tables et des vues de base de données personnalisées. Si vous avez activé l'abonnement Fusion Data Intelligence indiqué, vous pouvez utiliser les exemples fournis. Il est recommandé de remplacer les exemples d'objet par vos propres objets Autonomous Data Warehouse 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 devez :
  1. Ajouter une extension de dimension au modèle sémantique
  2. Présentation de l'extension de dimension dans le modèle sémantique
  3. Appliquer et publier les personnalisations
  4. Validation des résultats
Pour effectuer cette tâche, procédez comme suit :
  • Exemple de table d'extensions de dimension - FDI_X_COUNTRY_D
  • Attribut - Pays FullName
  • Domaine - Ajustements des comptes clients
  • Dossier de dimensions parent - Client
  • Dossier de dimensions - Dimension - Lieu de facturation du client
  • Table ADW prédéfinie - DW_CUSTOMER_LOCATION_D
Veillez à vous reporter à la section Upload Samples for the Semantic Model Extensions Use Cases et à remplir les conditions suivantes :
  1. Créez un modèle d'environnement restreint nommé MySandbox5Mar25. Reportez-vous à Créer un modèle d'environnement restreint. Vous pouvez également modifier un modèle d'environnement restreint existant sur la page Extensions de modèle sémantique, par exemple en cliquant sur le modèle d'environnement restreint MySandbox5Mar25.
  2. Créez l'exemple de table d'extensions de dimension FDI_X_COUNTRY_D dans le data warehouse autonome associé à votre instance Fusion Data Intelligence à l'aide des exemples de fichier FDI_X_COUNTRY_D.xlsx ou FDI_X_COUNTRY.sql.
  3. Créez une vue intitulée FDI_X_CUSTOMER_LOCATION_D_V pour joindre la table personnalisée FDI_X_COUNTRY_D à la table de dimension prédéfinie DW_CUSTOMER_LOCATION_D qui contient la clé primaire CUSTOMER_LOCATION_ID, qui sera utilisée pour la jointure lors de l'extension de la dimension. Utilisez le script SQL suivant pour créer la vue :
    CREATE OR REPLACE FORCE EDITIONABLE VIEW "OAX_USER"."FDI_X_CUSTOMER_LOCATION_D_V" ("CUSTOMER_LOCATION_ID", "COUNTRY_FULLNAME") DEFAULT COLLATION "USING_NLS_COMP"  AS 
  (
SELECT p.CUSTOMER_LOCATION_ID, NVL(c.COUNTRY_FULLNAME,'~NOVALUE~') AS COUNTRY_FULLNAME
FROM OAX$OAC.DW_CUSTOMER_LOCATION_D p
LEFT JOIN FDI_X_COUNTRY_D c
ON p.COUNTRY_CODE = c.COUNTRY_CODE
);
  4. Accordez l'accès au modèle sémantique à la vue FDI_X_CUSTOMER_LOCATION_D_V pour le schéma OAX$OAC à l'aide du script SQL suivant :
    GRANT SELECT ON "OAX_USER"."FDI_X_CUSTOMER_LOCATION_D_V" TO "OAX$OAC";
  5. 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_CUSTOMER_LOCATION_D_V;

Ajouter une extension de dimension au modèle sémantique

Vous modifiez l'étoile logique pour définir l'objet de data warehouse autonome, les attributs, les libellés d'affichage et les clés, puis vous joignez l'objet personnalisé à la dimension conforme prédéfinie en cours d'extension.

Dans cette tâche, vous modifiez l'étoile logique Faits – Fins – Ajustements des comptes clients pour ajouter une extension de dimension dans Dim – Lieu de facturation du client faisant référence à l'objet d'entrepôt de données autonome FDI_X_CUSTOMER_LOCATION_V. L'extension personnalisée est jointe à la dimension prédéfinie conforme Dim – Lieu de facturation du client à l'aide de l'ID lieu du client.
  1. Sur la page Extensions de modèle sémantique, cliquez sur le modèle d'environnement restreint MySandbox5Mar25.

    Page Extensions de modèle sémantique affichant le modèle d'environnement restreint que vous avez créé

  2. In Perform Action, click Manage Logical Star, then Edit Logical Star, then Out of the box, then select Financials - AR Adjustments as the subject area, select Fact – Fins – AR Adjustments as the corresponding fact, and then Next.

    Boîte de dialogue Exécuter l'action

  3. Sur la page Étoile logique : Fait, localisez la table de dimension Dim - Lieu de facturation client, cliquez dessus avec le bouton droit de la souris, puis cliquez sur Gérer l'extension.

    La page Logical Star : Fact affiche la table de dimension Dim - Customer Bill To Location.

  4. Dans la liste de valeurs Gérer l'extension, sélectionnez Etendre la dimension.

    Liste de valeurs Gérer les extensions

  5. Sur la page Etendre une dimension, à l'étape 1 de l'assistant, sélectionnez OAX_USER dans Schéma, puis FDI_X_CUSTOMER_LOCATION_D_V dans Objet. Cochez la case Utiliser pour la clé pour la colonne source CUSTOMER_LOCATION_ID, cochez la case Ajouter des attributs pour la colonne source COUNTRY_FULLNAME, puis cliquez sur Suivant.
    Remarque

    Assurez-vous que le nom d'affichage est unique et n'entre pas en conflit avec les noms de colonne prédéfinis. Par exemple, renommez CUSTOMER_LOCATION_ID en tant qu'ID d'emplacement client FDI.

    Page Etendre une dimension

  6. A l'étape 2 de l'assistant, sélectionnez Extérieur gauche dans Sélectionner un type de jointure.
    Remarque

    Le type de jointure est principalement Interne (correspondance) ou Gauche (tous provenant de la dimension d'origine). Le type de jointure Left garantit qu'aucune donnée n'est perdue.

    Etape 2 de l'assistant Etendre une dimension dans laquelle vous sélectionnez le type de jointure

  7. Sélectionnez ID d'emplacement client (DOUBLE) comme clé de dimension et CUSTOMER_LOCATION_ID (DOUBLE) comme clé de dimension étendue. Cliquez sur Terminer.

    Etape 2 de l'assistant Etendre une dimension dans laquelle vous sélectionnez les clés de jointure

  8. Vérifiez la dimension étendue.

    Page Etendre la dimension affichant la dimension étendue

Présentation de l'extension de dimension dans le modèle sémantique

Vous modifiez le domaine pour présenter les colonnes étendues dans un dossier de domaine.

Cette étape consiste à modifier le domaine Finances - Régularisations des comptes clients afin de présenter la colonne Nom complet du pays étendue dans le dossier Détails de facturation du client prédéfini.
  1. Accédez à l'environnement restreint MySandbox5Mar25.
  2. Dans le modèle d'environnement restreint MySandbox5Mar25, cliquez sur Effectuer une action, puis sur Gérer les domaines, puis sur Modifier un domaine, sélectionnez Financials – Régularisations des comptes clients comme domaine, puis Suivant.

    Boîte de dialogue Exécuter l'action

  3. A l'étape 1 de l'assistant sur la page Modifier un domaine - Financials - Ajustements de comptes clients, affichez les détails et cliquez sur Suivant.
  4. A l'étape 2 de l'assistant, sélectionnez Gérer les éléments, puis cliquez sur Gérer les personnalisations d'usine.

    Etape 2 de l'assistant sur la page Modifier un domaine - Financials - Ajustements clients affichant les options Gérer les éléments

  5. Dans Ajouter un domaine, sélectionnez Nom complet du pays et cliquez sur Ajouter des dossiers.

    Boîte de dialogue Ajouter un domaine affichant la colonne Nom complet du pays dans le dossier prédéfini Détails de facturation du client

  6. Dans Ajouter un domaine, sélectionnez le dossier Détails de facturation du client et cliquez sur Ajouter des dossiers.

    Boîte de dialogue Ajouter un domaine affichant le dossier prédéfini Détails de facturation du client auquel la dimension étendue est ajoutée

  7. Vérifiez les ajouts et cliquez sur Terminer.

    Page Modifier un domaine - Finances - Ajustements comptes clients affichant les ajouts

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.

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 Gestion financière - Régularisations des comptes clients, domaine étendu dans ce cas d'utilisation, puis cliquez sur Ajouter au classeur.
  3. Développez le dossier Site client, puis le dossier Détails de facturation du client et vérifiez que l'attribut étendu Nom complet du pays est visible en bas de la liste des attributs.
  4. Créez un rapport pour afficher que l'attribut de dimension étendue a été joint aux mesures de faits souhaitées.

    L'état affiche l'attribut de dimension étendue joint avec succès aux mesures de faits souhaitées