Expressions : exemple détaillé

Cet exemple détaillé illustre plus spécifiquement l'utilisation du générateur d'expressions pour créer une logique métier personnalisée.

Pour plus d'informations sur le générateur d'expressions, reportez-vous aux rubriques suivantes :

Dans cet exemple, nous voulons avoir la possibilité de faire glisser des noeuds d'une dimension Compte dans une application Oracle Financials Cloud General Ledger vers une dimension Compte dans une application Corporate Planning. Pour ce faire, nous avons configuré un convertisseur de type de noeud entre les types de noeud de chaque application. (Pour plus d'informations sur la conversion de types de noeud, reportez-vous à la section Utilisation de convertisseurs de type de noeud.) Nous allons générer l'expression suivante pour transformer la propriété Type de compte dans l'application Planning :

Si le type de compte dans l'application Oracle Financials Cloud General Ledger est "Asset", "Liability" ou "Owner's Equity", nous voulons que la propriété de type de compte dans l'application Corporate Planning soit "Expense". S'il s'agit d'un autre type de compte, nous voulons que la propriété de type de compte Corporate Planning soit "Non-Expense".

Commençons par examiner les propriétés dans le convertisseur de type de noeud que nous avons configuré :

  1. Dans Types de noeud, cliquez sur le type de noeud Compte pour Corporate Planning afin d'ouvrir le type de noeud dans l'inspecteur.
  2. Cliquez sur l'onglet Convertisseurs.
  3. Dans le panneau Propriétés à copier, localisez la propriété Account Type dans la colonne Cible.
  4. Cliquez sur Modifier.
  5. Dans la colonne Opération, sélectionnez Transform dans le menu déroulant.
  6. Dans la colonne Source, cliquez sur Définir une expression définir une expression.
    inspecteur de type de noeud avec mise en évidence de Transform et de la définition d'une expression

    Le générateur d'expressions apparaît.

Nous allons ensuite générer l'expression pour transformer le type de compte.

Génération de l'expression

Pour générer l'expression de transformation, procédez comme suit :

  1. Dans la palette, dans Instructions, faites glisser l'instruction IF jusqu'à la flèche bleue en haut de l'éditeur.
    générateur d'expressions avec instruction IF glissée depuis l'éditeur
  2. Dans Opérateurs, faites glisser deux opérateurs OR jusqu'à la condition IF dans l'éditeur.
    éditeur avec trois instructions IF séparées par des opérateurs OR

    Vous pouvez voir que chaque instruction IF et que le bloc d'instructions sont encadrés en rouge. Cela signifie qu'ils ne sont pas valides. Chaque instruction IF comprend une condition qui doit être de type Booléen, et chaque bloc d'instructions doit contenir une instruction RETURN. Le générateur d'expressions évalue l'expression en temps réel au fil de sa génération, et ces erreurs de validation sont résolues au fur et à mesure que nous ajoutons des champs à l'expression.

  3. Dans la première condition IF, cliquez sur Choisir un terme d'expression, puis sélectionnez sourceNode dans le menu déroulant.
    Instruction IF avec l'icône de choix du terme d'expression mise en évidence et sourceNode affiché
  4. Cliquez sur le point en regard de sourceNode, puis sélectionnez properties dans le menu déroulant.
    Condition IF affichant sourceNode, le point sur lequel cliquer et les propriétés

    Remarque :

    Lorsque vous cliquez sur le point en regard d'un champ dans une expression, le menu déroulant affiche uniquement les objets, les méthodes et les attributs applicables au champ.
  5. Cliquez sur le point en regard de properties, puis sélectionnez FCGL.Account Type dans le menu déroulant.
    liste déroulante des propriétés avec toutes les propriétés pertinentes affichées

    Remarque :

    Lors de l'affichage des propriétés pour les transformations de propriété, le type du noeud source étant connu, seules les propriétés pour ce type de noeud sont affichées. Cependant, lors de l'affichage des propriétés pour les propriétés dérivées, le type de noeud n'étant pas connu, toutes les propriétés valides pour l'application sont affichées.
  6. Sélectionnez le point en regard de FCGL.Account Type, puis equals dans le menu déroulant.
    L'expression IF indique maintenant : sourcenode properties FCGL Account Type equals

    Vous voyez que l'encadré rouge de validation a disparu sur la première condition IF. En effet, grâce à l'ajout de l'instruction equals, la condition contient désormais la valeur booléenne requise.

  7. Dans le champ de texte littéral, saisissez "A" (pour Asset).
    Champ littéral indiquant qu'un A a été saisi
  8. Répétez les étapes 3 à 7 afin d'ajouter des conditions IF pour FCGL.Account Type equals "L" (pour Liability) et "O" (pour Owner's Equity).
    Instruction IF avec les trois conditions détaillées dans l'étape

    Toutes les conditions IF contiennent maintenant des valeurs booléennes, et ne présentent donc plus d'encadré rouge indiquant des problèmes de validation. L'instruction RETURN reste toutefois manquante dans le bloc d'instructions. C'est pourquoi il est toujours encadré de rouge (erreur de validation).

  9. Dans le bloc d'instructions, cliquez sur Insérer une instruction, puis sélectionnez return dans le menu déroulant.
    bloc d'instructions avec instruction RETURN mise en évidence

    Une fois que vous ajoutez l'instruction RETURN, l'encadré rouge de validation n'apparaît plus autour du bloc d'instructions.

  10. Dans le bloc de renvoi, entrez "Expense".
    instruction RETURN avec Expense saisi dans le champ de texte
  11. Dans le bloc de renvoi inférieur, entrez "Non-Expense".
    deuxième bloc de renvoi affichant Non-Expense

    Remarque :

    Vous n'avez pas à saisir manuellement une instruction ELSE IF après la première instruction IF. Si une instruction IF n'est pas évaluée sur True, la logique passe automatiquement à l'instruction suivante.
  12. Cliquez sur Appliquer.

    Le générateur d'expressions est fermé et l'inspecteur de type de noeud apparaît.