Documentation Oracle Cloud Infrastructure

Cas d'utilisation 5 : Ajouter un fait personnalisé dégénéré

Vous pouvez ajouter un fait personnalisé dégénéré (dégénéré) contenant à la fois des mesures agrégées et des attributs descriptifs, et joindre le fait personnalisé dégénéré à une dimension prédéfinie avec une clé définie.

Le domaine prédéfini SCM – Commande client ne contient pas les mesures Fait – Calendrier des jours fériés et les attributs Dim – Fait – Calendrier des jours fériés – dégendim requis. Dans ce cas d'utilisation, vous ajoutez les dossiers Fait – Calendrier des jours fériés et Dim – Fait – Calendrier des jours fériés – degendim au domaine prédéfini SCM – Commandes client. Le dossier Fait - Calendrier des jours fériés contient des mesures agrégées. Le dossier Dim – Fact – Holiday Calendar – degendim contient des attributs descriptifs. Le fait personnalisé dégénéré est joint au Dim – Calendrier grégorien des données prédéfini à l'aide de la clé Date.

Ce cas d'utilisation requiert un abonnement Fusion SCM 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 des 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 un fait avec des attributs dégénérés au modèle sémantique
  2. Joindre un fait personnalisé avec des attributs dégénérés à une dimension prédéfinie
  3. Présenter le fait personnalisé avec les attributs de dégénérescence dans le modèle sémantique
  4. Appliquer et publier les personnalisations
  5. Validation des résultats
Pour effectuer cette tâche, procédez comme suit :
  • SCM - Domaine prédéfini 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é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.
  • Créez la table de dimension de jours fériés, FDI_X_HOLIDAY_CALENDAR_D, dans le data warehouse autonome associé à votre instance Fusion Data Intelligence à l'aide des exemples de fichier FDI_X_HOLIDAY_CALENDAR_D.xls ou FDI_X_HOLIDAY_CALENDAR_D.sql.
  • Créez l'exemple de vue de dimension FDI_X_HOLIDAY_CALENDAR_F_V à l'aide du script SQL suivant :
    CREATE OR REPLACE FORCE EDITIONABLE VIEW "OAX_USER"."FDI_X_HOLIDAY_CALENDAR_F_V" ("CALENDAR_DATE", "HOLIDAY", "BUSINESS_DAY", "TODATE_BUSINESS_DAYS", "MONTH_BUSINESS_DAYS") DEFAULT COLLATION "USING_NLS_COMP"  AS 
  (
  SELECT 
  CALENDAR_DATE,
  HOLIDAY,
  BUSINESS_DAY,
  SUM(BUSINESS_DAY) OVER (PARTITION BY TO_CHAR(CALENDAR_DATE,'MM-YYYY') ORDER BY CALENDAR_DATE) AS TODATE_BUSINESS_DAYS,
  SUM(BUSINESS_DAY) OVER (PARTITION BY TO_CHAR(CALENDAR_DATE,'MM-YYYY')) AS MONTH_BUSINESS_DAYS
  FROM
  (
  SELECT
  d.CALENDAR_DATE,
  d.DAY_LOCALE_NAME,
  c.HOLIDAY,
  CASE WHEN DAY_LOCALE_NAME NOT IN ('Saturday','Sunday') AND HOLIDAY IS NULL THEN 1 ELSE 0 END AS BUSINESS_DAY
  FROM DW_DAY_D d
  LEFT JOIN
  FDI_X_HOLIDAY_CALENDAR_D c
  ON c.COL_DATE = d.CALENDAR_DATE
  )
  );
  • Accordez l'accès au modèle sémantique à la vue FDI_X_HOLIDAY_CALENDAR_F_V pour le schéma OAX$OAC à l'aide du script SQL suivant :
    GRANT SELECT ON "OAX_USER"."FDI_X_HOLIDAY_CALENDAR_F_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 FDI_X_HOLIDAY_CALENDAR_F_V
WHERE HOLIDAY IS NOT NULL;

Ajouter un fait avec des attributs dégénérés au modèle sémantique

Vous créez une étoile logique pour définir l'objet de data warehouse autonome, dégénérer les attributs, les mesures de faits, les libellés d'affichage, les clés, les règles d'agrégation et les niveaux de contenu.

Cette étape consiste à créer une étoile logique pour définir le fait personnalisé, Fait – Calendrier des jours fériés, et à créer implicitement Dim – Fait – Calendrier des jours fériés – degendim. Ce fait personnalisé référence à l'objet de data warehouse autonome FDI_X_HOLIDAY_CALENDAR_F_V.
  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 Créer l'étoile logique et cliquez sur Suivant.
  3. Dans la page Logical Star : Fact, cliquez sur Ajouter un fait.
  4. Sur la page Ajouter un fait, à l'étape 1 de l'assistant, sélectionnez OAX_USER dans Schéma, puis FDI_X_HOLIDAY_CALENDAR_F_V dans Objet et renommez Nom du fait en Fait – Calendrier des jours fériés. Cochez la case appropriée comme suit, puis cliquez sur Suivant.
    • Sélectionner un attribut de second ordre – VACANCES
    • Sélectionner un fait : TODATE_BUSINESS_DAYS, MONTH_BUSINESS_DAYS et BUSINESS_DAY.
    • Utiliser pour la clé – CALENDAR_DATE


    Etape 1 de l'assistant sur la page Ajouter un fait

  5. A l'étape 2 de l'assistant, définissez les règles d'agrégation comme suit :
    Colonne de fait Règle d'agrégation
    Modifier les jours ouvrables (NUMERIC) Max.
    Jours ouvrables du mois (NUMERIC) Moyenne
    Jour ouvrable (NUMERIC) Somme


    Etape 2 de l'assistant sur la page Ajouter un fait

  6. Cliquez sur l'icône Niveau de contenu, définissez le niveau de contenu comme suit, cliquez sur OK, puis sur Terminer.
    Dimension Niveau
    Calendrier grégorien Jour


    La dimension Calendrier grégorien et son niveau de contenu, Jour

Joindre un fait personnalisé avec des attributs dégénérés à une dimension prédéfinie

Vous ajoutez des dimensions prédéfinies et vous les joignez au fait de dégen personnalisé à l'aide de clés étrangères définies dans le fait de dégen personnalisé.

Cette étape consiste à ajouter la dimension prédéfinie, Dim – Calendrier grégorien des données, et à la joindre au fait de dégénérescence personnalisé Dim – Fait – Calendrier des jours fériés à l'aide de la clé étrangère CALENDAR_DATE définie dans le fait de dégénérescence personnalisé.
  1. Dans la page Logical Star : Fact, cliquez sur Gérer la dimension.

    La page Logical Star : Fact affichant le bouton Manage Dimension

  2. Dans la liste de valeurs Gérer la dimension, cliquez sur Ajouter une dimension existante, puis dans Ajouter une table, sélectionnez Dim – Calendrier grégorien de date et cliquez sur OK.

    Boîte de dialogue Ajouter une table affichant le calendrier grégorien Dim – Date

  3. Sur la page Étoile logique : Fait, faites glisser le cercle du fait personnalisé (Fait - Calendrier des jours fériés) vers le cercle de la dimension personnalisée (Dim - Calendrier grégorien des dates) pour ouvrir la boîte de dialogue Joindre. Dans Jointure, sélectionnez Intérieur comme Type de jointure, cliquez sur Ajouter une condition de jointure pour l'ajouter comme suit, puis cliquez sur Terminé :
    Fait - Calendrier des jours fériés Dim - Date du calendrier grégorien
    DATE calendaire (DATE) DATE (DATE)


    Boîte de dialogue de jointure affichant le fait Calendrier des jours fériés et la dimension Calendrier grégorien de date correspondante

  4. Vérifiez la jointure en mode graphique.

    Jointure que vous avez créée en mode graphique

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

Présenter le fait personnalisé avec les attributs de dégénérescence dans le modèle sémantique

Vous modifiez le domaine pour présenter le nouveau fait de dégénérescence personnalisé et ses métriques agrégables, ainsi que la dimension de dégénérescence et ses attributs. Le système présente le fait dégen comme un dossier contenant les colonnes de mesure et la dimension dégen comme un dossier séparé contenant les colonnes d'attribut.

In this step, you modify the SCM – Sales Order subject area to present the new degen fact folder Fact – Holiday Calendar containing three measures, Business Day, Month Business Days, and Todate Business Days, along with the new degen dim folder Dim – Fact – Holiday Calendar – degendim containing the Holiday attribute.

  1. Sur la page Extensions de modèle sémantique, cliquez sur le modèle d'environnement restreint MySandbox5Mar25.
  2. Cliquez sur Effectuer une action, cliquez sur Gérer les domaines, sélectionnez Modifier un domaine, sélectionnez SCM – Commandes client, puis cliquez sur Suivant.
  3. Sur la page Modifier un domaine - SCM - Commandes client, à l'étape 1 de l'assistant, affichez les détails du domaine et cliquez sur Suivant.
  4. A l'étape 2 de l'assistant, cliquez sur Gérer les éléments, cliquez sur Gérer les nouvelles personnalisations, puis dans Ajouter un domaine, sélectionnez le dossier Fait - Calendrier des jours fériés et toutes les mesures de fait, puis cliquez sur Ajouter.

    Boîte de dialogue Ajouter un domaine affichant le jour férié sélectionné (attribut Degen) et les mesures applicables

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

    Etape 2 de l'assistant sur la page Modifier un domaine - SCM - Commandes client affichant les éléments de données sélectionnés

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 SCM - Commandes client, puis cliquez sur Ajouter au classeur.
  3. Créez un rapport en le faisant glisser :
    • Année
    • Mois
    • Date
    • Jour férié
    • Jour ouvrable
    • Jours ouvrables du mois
    • Modifier les jours ouvrables


    Créer un rapport en faisant glisser les éléments de données applicables vers le volet de visualisation

  4. Filtrer sur 2024/07 qui a 2 jours fériés. Toutes les colonnes totalisent les mêmes 21 jours ouvrables du mois, mais chaque colonne peut être utile pour différents calculs.

    Rapport filtré le 2024/07 et affichant 2 jours fériés