Introduction

Ce tutoriel pratique de 15 minutes vous montre comment utiliser une expression dans un convertisseur de type de noeud pour rechercher le parent d'un noeud via une demande d'abonnement. Vous commencez par créer un abonnement, puis ajoutez des expressions à un convertisseur de type de noeud pour dériver logiquement le nom du noeud et le nom parent. Enfin, vous créez et soumettez une demande pour tester la logique, puis vous connectez-vous en tant que personne affectée à l'abonnement pour afficher les résultats de la demande d'abonnement.

Contexte

Lorsque vous ajoutez un noeud à la source et que vous soumettez la modification via une demande d'abonnement, vous souhaitez que le moteur Enterprise Data Management Cloud recherche un parent spécifique dans la cible en fonction d'une propriété du noeud source. Pour ce faire, vous pouvez créer une expression dans le convertisseur de type de noeud.

Dans l'exemple de ce tutoriel, vous créez deux expressions. La première expression calcule le nom du noeud dans la cible et la seconde expression trouve le parent approprié dans la cible. Lorsque vous soumettez la modification via une demande d'abonnement avec la soumission automatique sélectionnée et qu'aucune approbation n'est requise, la modification est automatiquement transmise à la cible.

Prérequis

Avant de commencer ce tutoriel, vous devez :

  • Demandez à l'administrateur de service d'accéder à votre environnement Enterprise Data Management Cloud.
  • Créer une application échantillon. Pour plus d'informations, reportez-vous à la documentation.
  • Attention :

    Notez que la création de l'exemple d'application enlèvera toutes les applications et tous les artefacts existants dans l'environnement. Sauvegardez votre environnement actuel avant de créer l'exemple d'application. Pour plus d'informations sur la sauvegarde, le téléchargement et l'import d'applications et d'artefacts, reportez-vous à la documentation Administration de la migration pour Oracle Enterprise Performance Management Cloud.
  • Créez un utilisateur, puis ajoutez-le au groupe d'utilisateurs et au groupe d'utilisateurs interactifs. Dans ce tutoriel, cet utilisateur est Barry Dylan.

Identifier la source et la cible

  1. Connectez-vous en tant qu'utilisateur disposant du rôle Administrateur de service, accédez à Vues et ouvrez la vue Maintenance de compte. Le point de vue Compte entreprise est votre source et le point de vue Compte du plan est votre cible.
    Vue Maintenance des comptes
  2. Sélectionnez le point de vue Compte d'entreprise, accédez au noeud 11000, puis développez-le.
    Point de vue du compte d'entreprise
  3. Cliquez sur Icône Disposition côte à côte (Présentation côte à côte) pour afficher les points de vue Compte d'entreprise et Compte de plan.
    Disposition côte à côte
  4. 11000 étant sélectionné dans le point de vue Compte d'entreprise, cliquez sur Icône Localiser le noeud (Localiser le noeud à partir du compte d'entreprise du point de vue) pour localiser le noeud associé A_11000 dans le point de vue Compte de plan.
    Localiser le noeud à partir du point de vue

    Dans ce tutoriel, vous allez ajouter un noeud enfant au parent 11000 dans la dimension Compte entreprise, utiliser des expressions distinctes pour calculer le nom du noeud cible et rechercher le parent A_11000 dans la dimension Compte du plan, puis ajouter le noeud au parent dans la dimension cible via une demande d'abonnement.

Création d'un abonnement

  1. Cliquez sur Icône Présentation à onglets (Présentation à onglets) pour désactiver la présentation côte à côte et inspectez le point de vue Compte du plan.
    Cadre de sous-comptes
  2. Sélectionnez l'onglet Abonnements, puis cliquez sur Créer.
    Cadre de sous-comptes
  3. Définissez le point de vue source sur Compte d'entreprise dans la vue Maintenance de compte, puis cliquez sur Créer.
    Cadre de sous-comptes
  4. Sélectionnez l'onglet Définition.
    Cadre de sous-comptes
  5. Dans l'onglet Définition, cliquez sur Modifier.
    Cadre de sous-comptes
  6. Ajoutez Barry Dylan en tant que destinataire par défaut, puis sélectionnez Activé et Soumission automatique.
    Cadre de sous-comptes
  7. Enregistrez l'abonnement, puis sélectionnez l'onglet Compte du plan dans l'angle inférieur gauche. Notez que l'abonnement créé est répertorié dans l'onglet Subscriptions.
  8. Onglet Abonnement

Configuration d'un convertisseur de noeud

  1. Dans l'inspecteur de point de vue Compte du plan, sélectionnez l'onglet Chaîne de données.
    Cadre de sous-comptes
  2. Sélectionnez l'objet de chaîne de données Types de noeud, puis le type de noeud Compte.
    Cadre de sous-comptes
  3. Dans l'onglet Général, notez que le type de noeud inclut le préfixe de qualificatif A_.
    Cadre de sous-comptes
  4. Sélectionnez Convertisseurs, puis cliquez sur Modifier.
    Cadre de sous-comptes

Créer une expression pour calculer le nom de noeud

    Dans cette section, vous ajoutez l'expression suivante pour calculer le nom du noeud :
     return "A_".concat(sourceNode.properties.Core.Name)

    Par exemple, vous ajoutez un noeud nommé 11504 à la dimension source. L'expression ajoute le qualificatif de préfixe A_ au noeud et le noeud est ajouté en tant que A_11504 dans la cible.

    Pour plus d'informations sur la création d'expressions, consultez notre vidéo de tutoriel Transformation des propriétés à l'aide du générateur d'expressions.

  1. Pour la propriété Nom, remplacez l'opération Copier par Transformer.
    Cadre de sous-comptes
  2. Pour le noeud Nom, cliquez sur fx (Modifier l'expression) afin d'ouvrir le générateur d'expressions.
    Cadre de sous-comptes
  3. Téléchargez l'expression à partir du fichier Property_Transform_Name.json , puis cliquez sur le bouton Charger à partir du fichier (Charger à partir du fichier).
  4. Télécharger l'expression de nom de noeud
  5. Dans la boîte de dialogue Ouvrir le fichier, sélectionnez le fichier JSON téléchargé, puis cliquez sur Ouvrir.
  6. Expression de nom de noeud
  7. Cliquez sur Appliquer.
    Inspecteur de type de noeud de compte

Créer une expression pour dériver le nom du parent

    Dans cette section, vous ajoutez l'expression suivante pour dériver le nom du noeud parent :
    return "A_".concat(sourceNode.properties.Core.Name.substring(0, 2), "000")

    Par exemple, vous ajoutez un noeud enfant nommé 11504 au noeud parent 11000 dans la dimension source. Pour rechercher le noeud parent dans la dimension cible, l'expression ajoute le qualificatif de préfixe A_, identifie les 2 premiers caractères du nom de noeud parent dans la dimension source (11 dans cet exemple) et ajoute 000 pour identifier le parent en tant que A_11000 dans la cible.

  1. Pour la propriété Parent, dans la liste déroulante Opération, sélectionnez Transformer.
    Opération de propriété parent
  2. Pour la propriété Parent, cliquez sur fx (Modifier l'expression) afin d'ouvrir Expression Builder.
    Type de noeud de compte
  3. Téléchargez l'expression à partir du fichier Property_Transform_Parent.json , puis cliquez sur le bouton Charger à partir du fichier (Charger à partir du fichier).
  4. Télécharger l'expression de nom de noeud
  5. Dans la boîte de dialogue Ouvrir le fichier, sélectionnez le fichier JSON téléchargé, puis cliquez sur Ouvrir.
  6. Expression de nom de noeud parent

Test de l'expression de nom parent

Dans cette section, vous allez tester l'expression pour dériver le nom du noeud parent.
  1. Cliquez sur le bouton Charger à partir du fichier (Expression de test).
    Générateur d'expressions
  2. Dans le volet Test Expression, effectuez les actions suivantes :
    • Pour le point de vue, sélectionnez Compte d'entreprise dans la vue Maintenance des comptes.
    • Pour Noeud, sélectionnez 11000 (Investissements en espèces et à court terme).
    • Cliquez sur Evaluer.
    Tester l'expression de noeud parent
  3. Vérifiez le résultat de l'évaluation de l'expression, A_11000, et vérifiez que l'expression dérive correctement le nom de noeud parent dans la dimension cible.
  4. Evaluer l'expression
  5. Fermez le panneau Expression de test, puis cliquez sur Appliquer.
    Inspecteur de type de noeud de compte
  6. Enregistrez et fermez l'inspecteur.
  7. Cliquez sur OK pour confirmer que la vue a été modifiée.
    Cadre de sous-comptes

Créer une demande pour tester les expressions

  1. Dans la vue Maintenance des comptes, cliquez sur Nouvelle demande.
    Nouvelle demande
  2. Dans le point de vue Compte d'entreprise, développez T > 10000 > 11000.
    Cadre de sous-comptes
  3. Cliquez sur Menu Noeud (menu Noeud) à droite du noeud 11000 pour lancer le menu contextuel, puis sélectionnez Ajouter un enfant pour créer un noeud en tant qu'enfant du noeud 11000.
    Cadre de sous-comptes
  4. Définissez les propriétés enfant :

    Propriété Définition
    Nom 11 504
    Description Effacement du compte chèques USBNK3
    Description US Effacement du compte chèques USBNK3
    Résumé No
    Etat d'activation Oui
    Autoriser la publication Oui
    Type de compte Ressource
    Catégorie financière Espèces

    Cadre de sous-comptes
  5. Dans le panneau de demande, en regard de Tous les éléments, cliquez sur Icône de menu d'éléments de la demande (menu Eléments de demande), puis sélectionnez Valider.
    Cadre de sous-comptes

    Vous devriez recevoir un message de validation réussie.

    Cadre de sous-comptes

  6. Soumettez la demande. Vous devriez recevoir un message indiquant que la demande a été soumise.
    Cadre de sous-comptes
  7. Fermez la vue.

Affichage des résultats de la demande

  1. Accédez à Demandes, définissez le filtre Type de demande sur Abonnement et confirmez qu'une demande a été envoyée à la personne affectée à la demande : Barry Dylan. Notez que le statut de la demande est Brouillon en raison d'un problème avec la demande.
    Cadre de sous-comptes
  2. Déconnectez-vous et reconnectez-vous en tant que Barry Dylan. Sur la page d'accueil, sélectionnez l'onglet Activité, puis cliquez sur Demandes qui me sont affectées.
    Page d'accueil de Barry Dylan
  3. Sur la page Activité de demande, cliquez sur le lien ID de demande pour vérifier le problème de demande.
    Page d'accueil de Barry Dylan
  4. Notez une erreur de validation avec le noeud A_11504.
    Erreur de validation
  5. Corrigez l'erreur en définissant les propriétés de noeud A_11504 comme indiqué dans le tableau suivant :
    Propriété Définition
    Type de données Devise
    Type de taux de change Moyenne

    Vérifiez que le noeud parent est correctement calculé : le noeud A_11504 est ajouté en tant qu'enfant au parent A_11000 dans le point de vue Compte du plan.
  6. Cadre de sous-comptes
  7. Validez et soumettez la demande.
    La demande a été soumise
  8. Cliquez sur Back to Requests. Sur la page Activité de demande, définissez le filtre Statut sur Tout et le filtre Mon activité sur Soumis. Vérifiez que le statut de la demande est Terminé et que l'étape de la demande est Fermé.
    Activité de demande