Présentation

Ce tutoriel pratique de 15 minutes vous explique comment utiliser une expression dans un convertisseur de type de noeud pour rechercher le parent d'un noeud au moyen d'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 de test de la logique et vous connectez-vous en tant qu'exécutant de l'abonnement pour voir les résultats de la demande d'abonnement.

Contexte

Lorsque vous ajoutez un noeud à la source et soumettez la modification au moyen d'une demande d'abonnement, vous voulez 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 recherche le parent approprié dans la cible. Lorsque vous soumettez la modification au moyen d'une demande d'abonnement avec l'option de soumission automatique sélectionnée et qu'aucune approbation n'est requise, la modification est automatiquement poussée vers la cible.

Préalables

Avant de commencer ce tutoriel, vous devez :

  • Avoir un accès d'administrateur de service à votre environnement Enterprise Data Management Cloud.
  • Créez un exemple d'application. Pour plus d'informations, voir la documentation.
  • Attention :

    Notez que la création de l'exemple d'application supprimera toutes les applications et tous les artefacts existants dans l'environnement. Sauvegardez votre environnement courant avant de créer l'exemple d'application. Pour plus d'informations sur la sauvegarde, le chargement et l'importation d'applications et d'artefacts, consultez la documentation sur l'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 avec le rôle Administrateur de service, naviguez jusqu'à Vues et ouvrez la vue Maintenance de compte. Le point de vue Compte d'entreprise est votre source et le point de vue Planifier le compte est votre cible.
    Vue de maintenance de compte
  2. Sélectionnez le point de vue Compte d'entreprise, naviguez jusqu'au noeud 11000, puis développez-le.
    Point de vue de compte d'entreprise
  3. Cliquez sur Icône de disposition côte à côte (Disposition côte à côte) pour voir les points de vue Compte d'entreprise et Compte de plan.
    Disposition côte à côte
  4. Avec 11000 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 connexe A_11000 dans le point de vue Planifier le compte.
    Localiser le noeud à partir du point de vue

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

Création d'un abonnement

  1. Cliquez sur Icône Disposition à onglets (Disposition à onglets) pour désactiver la disposition côte à côte et inspecter le point de vue Planifier le compte.
    Cadre de sous-comptes
  2. Sélectionnez l'onglet Abonnements, puis cliquez sur Créer.
    Cadre de sous-comptes
  3. Réglez le point de vue source à 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 qu'exécutant par défaut, puis sélectionnez Activé et Soumettre automatiquement.
    Cadre de sous-comptes
  7. Enregistrez l'abonnement, puis sélectionnez l'onglet Planifier le compte dans le coin inférieur gauche. Notez que l'abonnement créé est répertorié dans l'onglet Subscriptions.
  8. Onglet Abonnement

Configuration d'un convertisseur de noeuds

  1. Dans l'inspecteur de point de vue Planifier le compte, 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 sélectionnez 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éation d'une expression pour calculer le nom du noeud

    Dans cette section, vous allez ajouter 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, voir notre vidéo de tutoriel sur la transformation de 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) pour 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 d'un fichier).
  4. Charger l'expression de nom de noeud
  5. Dans la boîte de dialogue Fichier ouvert, 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éation d'une expression pour dériver le nom du parent

    Dans cette section, vous allez ajouter 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 trouver le noeud parent dans la dimension cible, l'expression ajoute le qualificatif de préfixe A_, identifie les 2 premiers caractères du nom du noeud parent dans la dimension source (11 dans cet exemple), et ajoute 000 pour identifier le parent comme 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) pour ouvrir le générateur d'expressions.
    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 d'un fichier).
  4. Charger l'expression de nom de noeud
  5. Dans la boîte de dialogue Fichier ouvert, 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 obtenir le nom du noeud parent.
  1. Cliquez sur le bouton Charger à partir du fichier (Tester l'expression).
    Générateur d'expressions
  2. Dans le volet Test Expression, effectuez les actions suivantes :
    • Pour Point de vue, sélectionnez Compte d'entreprise dans la vue Maintenance des comptes.
    • Pour le noeud, sélectionnez 11000 (Investissements en espèces et à court terme).
    • Cliquez sur Évaluer.
    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 obtient correctement le nom du noeud parent dans la dimension cible.
  4. Évaluer l'expression
  5. Fermez le volet Expression de test, puis cliquez sur Appliquer.
    Inspecteur de type de noeud de compte
  6. Enregistrer et fermer l'inspecteur.
  7. Cliquez sur OK pour confirmer que la vue a été modifiée.
    Cadre de sous-comptes

Créer une demande de test des 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 de noeud (menu Noeud) à droite du noeud 11000 pour lancer le menu contextuel, puis sélectionnez Ajouter un enfant pour créer un nouveau 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 Compte de chèques USBNK3 de compensation
    Description - États-Unis Compte de chèques USBNK3 de compensation
    Sommaire Non
    Cochée Oui
    Permettre le report Oui
    Type de compte Immobilisation
    Catégorie financière Trésorerie

    Cadre de sous-comptes
  5. Dans le panneau de demande, à côté de Tous les éléments, cliquez sur Icône de menu Éléments de demande (menu Élé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. Soumettre la demande. Vous devriez recevoir un message indiquant que la demande a été soumise.
    Cadre de sous-comptes
  7. Fermez la vue.

Consultation des résultats de la demande

  1. Naviguez jusqu'à Demandes, réglez le filtre Type de demande à Abonnement et confirmez qu'une demande a été envoyée à l'exécutant de la demande : Barry Dylan. Notez que le statut de la demande est Provisoire, car il y a un problème avec la demande.
    Cadre de sous-comptes
  2. Connectez-vous en tant que Barry Dylan. Dans 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. Dans la page Activité de demande, cliquez sur le lien ID 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 du 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 Planifier le compte.
  6. Cadre de sous-comptes
  7. Valider et soumettre la demande.
    La demande a été soumise
  8. Cliquez sur Retour aux demandes. Dans la page Activité de demande, réglez le filtre Statut à Tout et le filtre Mon activité à Soumise. Vérifiez que le statut de la demande est Terminée et que l'étape de la demande est Fermée.
    Activité de la demande