Documentation Oracle Cloud Infrastructure

Cas d'utilisation 6 : Ajouter des colonnes dérivées

Vous pouvez ajouter des colonnes dérivées à un dossier qui utilise une fonction ou une formule référençant des éléments personnalisés ou prédéfinis qui vous permettent d'effectuer des calculs et d'afficher des valeurs dérivées.

Le dossier Dim – Client acheteur dans le domaine prédéfini SCM – Commande client ne contient pas la colonne dérivée requise Index client. Dans ce cas d'utilisation, vous ajoutez la colonne dérivée Index personnalisé, calculée à l'aide d'une fonction d'instruction CASE, dans le dossier Dim – Client acheteur personnalisé prédéfini pour associer l'index client aux attributs Client acheteur. La colonne dérivée étant créée dans la dimension Dim - Client acheteur, elle est automatiquement jointe.

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 procédez comme suit :
  1. Ajouter une colonne dérivée au modèle sémantique
  2. Présentation de la colonne dérivée 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 :
  • Dim - Dossier Client acheteur
  • SCM – Domaine prédéfini Commande 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.

Ajouter une colonne dérivée au modèle sémantique

Vous modifiez l'étoile logique pour définir la formule d'expression de colonne dérivée personnalisée. Vous pouvez utiliser les fonctions Fx pour obtenir de l'aide sur la syntaxe, ou copier la formule et la coller ou saisir manuellement.

Cette étape consiste à modifier l'étoile logique Fait - Commandes client OM pour étendre la dimension prédéfinie Dim - Client acheteur personnalisé, en créant une nouvelle colonne dérivée Index personnalisé. Lors de l'exécution, Index personnalisé exécute une fonction d'instruction CASE qui évalue la colonne Client acheteur et renvoie une valeur personnalisée basée sur des conditions if-then-else définies.

  1. Sur la page Extensions de modèle sémantique, cliquez sur le modèle d'environnement restreint MySandbox5Mar25.
  2. In Perform Action, click Manage Logical Star, click Edit Logical Star, select Out of the box, select SCM – Sales Orders subject area, select Fact – OM Sales Orders, and then click Next.
  3. Dans la page Logical Star : Fact, localisez la dimension Dim – Client acheteur à laquelle ajouter la colonne dérivée. Cliquez avec le bouton droit sur la dimension, puis cliquez sur Gérer l'extension.

    L'étoile logique : Fait affiche la dimension Dim - Customer Sold To.

  4. Sur la page Sandbox : MySandbox5Mar25, cliquez sur Gérer l'extension, puis sur Ajouter des colonnes.
  5. Sur la page Ajouter des colonnes, cliquez sur Ajouter une colonne dérivée.

    Page Ajouter des colonnes

  6. Dans Créer une colonne, entrez Index client dans Nom et le script suivant dans l'espace sous le champ Nom :
    CASE
WHEN UPPER(SUBSTRING("Core"."Dim - Customer Sold To"."Sold-to Customer" FROM 1 FOR 1)) BETWEEN  'A' AND 'H' THEN 'A-H'
WHEN UPPER(SUBSTRING("Core"."Dim - Customer Sold To"."Sold-to Customer" FROM 1 FOR 1)) BETWEEN  'I' AND 'P' THEN 'I-P'
WHEN UPPER(SUBSTRING("Core"."Dim - Customer Sold To"."Sold-to Customer" FROM 1 FOR 1)) BETWEEN  'Q' AND 'Z' THEN 'Q-Z'
ELSE 'Other' 
END


    Boîte de dialogue Créer une colonne

  7. Dans Créer une colonne, après avoir fourni le script applicable, cliquez sur Valider, Enregistrer, puis sur Terminer sur la page Ajouter des colonnes.

    Page Ajouter des colonnes affichant le bouton Terminer

Présentation de la colonne dérivée dans le modèle sémantique

Vous modifiez le domaine pour présenter la nouvelle colonne dérivée personnalisée et sélectionnez le dossier dans lequel l'afficher.

Le système joint automatiquement la nouvelle colonne à la dimension à laquelle elle est ajoutée. Cette étape consiste à modifier le domaine SCM – Commande client afin de présenter la nouvelle colonne dérivée Index personnalisé, en l'ajoutant au dossier Dim – Client acheteur personnalisé prédéfini.

  1. Accédez à la page MySandbox5Mar25, cliquez sur Effectuer une action, cliquez sur Gérer les domaines, sélectionnez Modifier un domaine, sélectionnez 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, puis sur Gérer les personnalisations d'usine.
  4. Dans Ajouter un domaine, sélectionnez Index client, puis cliquez sur Ajouter des dossiers.

    Boîte de dialogue Ajouter un domaine affichant la nouvelle colonne dérivée personnalisée, Customer Index

  5. Dans Ajouter un domaine, sélectionnez le dossier Client acheteur et cliquez sur Ajouter des dossiers.

    Boîte de dialogue Ajouter un domaine affichant le dossier Client acheteur

  6. A l'étape 2 de l'assistant, 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. Vérifiez que la nouvelle colonne Index client est visible à la fin du dossier Client acheteur.

    La nouvelle colonne Customer Index est visible à la fin du dossier du client acheteur.

  4. Créez un état affichant les colonnes Index client et Client acheteur.

    Etat affichant les colonnes Index du client et Client acheteur