Présentation du générateur d'expressions

Le générateur d'expressions se compose de deux zones :

  • La palette permet de sélectionner les champs à insérer dans l'expression.
  • L'éditeur permet de composer l'expression.

générateur d'expressions avec la palette à gauche et l'éditeur à droite

Accès au générateur d'expressions

Vous pouvez accéder au générateur d'expressions dans deux modes :

  • Mode Lecture seule : vous permet de visualiser la logique d'expression sans apporter aucune modification. Lorsque vous êtes en mode Lecture seule, vous pouvez copier ou télécharger l'expression, la capturer sous forme de texte ou la tester, mais vous ne pouvez pas la modifier.
  • Mode de modification : vous permet de créer et de modifier l'expression. Lorsque vous êtes en mode de modification, vous pouvez effectuer toutes les fonctions qui sont répertoriées dans la section Barre d'outils du générateur d'expressions ci-dessous.

Vous pouvez accéder au générateur d'expressions dans les deux modes en cliquant sur le bouton Définir une expression bouton de définition d'expression dans un contexte où une logique métier est appliquée (par exemple, dans une propriété dérivée). Le mode dans lequel le générateur d'expressions est ouvert dépend du mode dans lequel vous étiez dans l'inspecteur avec lequel vous avez accédé au générateur d'expressions. Si vous étiez en mode de modification dans l'inspecteur, le générateur d'expressions est ouvert en mode de modification. Si vous n'étiez pas en mode de modification dans l'inspecteur, le générateur d'expressions est ouvert en mode Lecture seule.

Barre d'outils du générateur d'expressions

La barre d'outils du générateur d'expressions permet d'exécuter des fonctions telles que la copie et le collage de termes d'expression, le chargement d'expressions à partir d'un fichier et le test d'expressions. Les fonctions disponibles sont les suivantes :

Terminologie

Il est utile de maîtriser les concepts suivants pour utiliser le générateur d'expressions :

  • Une expression est composée de lignes de logique, appelées instructions.
  • Les instructions sont des éléments discrets qui contrôlent la logique d'une expression. Il existe trois types d'instruction :
    • Les instructions RETURN renvoient une valeur.
    • Les instructions IF indiquent une liste d'instructions à exécuter en cas de condition remplie. Vous pouvez ajouter des instructions ELSE et ELSE IF aux instructions IF pour développer la condition.
    • Les commentaires permettent d'annoter des parties de l'expression (par exemple, pour identifier l'emplacement de modifications). Ils sont uniquement informatifs et ne sont pas évalués lors de l'exécution de l'expression.

  • Les termes d'expression sont constitués d'objets et d'opérateurs qui sont évalués pour générer une valeur. Dans cet exemple, une expression dérive la valeur d'une propriété d'alias en concaténant le nom du noeud et la description du noeud avec un tiret entre les deux :


    return node name concat hyphen node properties core description

    Cette expression contient trois termes d'expression (plus un espace réservé facultatif pour en ajouter un quatrième), indiqués chacun par une icône terme d'expression :

    • Node.name.concat(
    • - (tiret)
    • Node.properties.Core.Description

    Les termes d'expression apparaissent sur un fond jaune dans le générateur d'expressions, et chaque terme d'expression peut être déplacé ou supprimé dans l'instruction. Vous pouvez également copier et coller des termes d'expression dans une expression. Reportez-vous à la section Opérations de copier-coller dans des expressions.

  • Les objets sont les éléments d'une expression qui représentent les valeurs. Chaque objet possède un type de données qui détermine les objets, méthodes et attributs supplémentaires disponibles pour lui. Par exemple, si vous sélectionnez l'objet sourceNode dans une expression, le générateur d'expressions affiche uniquement les champs applicables au type de données noeud, comme dimension ou name. Reportez-vous à la section Types de données pour les termes d'expression.

    Après avoir sélectionné un objet dans une expression, vous pouvez affiner davantage cette dernière en sélectionnant des attributs et des méthodes pour l'objet.

    • Les attributs décrivent un aspect d'un objet. Par exemple, l'objet dimension possède un attribut appelé name.
    • Les méthodes exécutent des actions sur un objet. Par exemple, la méthode concat concatène des chaînes, et la méthode length renvoie la longueur d'une chaîne. Certaines méthodes ont des arguments, qui sont des paramètres d'entrée pour la méthode. Un libellé décrit l'entrée requise (par exemple, Valeur de chaîne).
  • Les opérateurs effectuent des comparaisons logiques dans une expression. Le générateur d'expressions prend en charge les opérateurs AND et OR.
  • Les littéraux sont des valeurs constantes que vous saisissez manuellement dans une expression. Par exemple, dans les instructions If Account.Type = E, return Expense, "E" et "Expense" sont des littéraux.

Etudions un exemple d'expression pour nous familiariser avec la terminologie :


expression indiquant If FCGL_Account Type is E, return Expense, else return Non-Expense

Il s'agit d'une expression sur un convertisseur de type de noeud qui mappe une dimension de compte Corporate Planning avec une dimension de compte Financials Cloud GL. Si elle était rédigée, cette expression indiquerait :

Pour la propriété PLN.Variance Reporting, si la propriété du noeud source FCGL.Account Type est égale à "E", renvoyer "Expense". Sinon, renvoyer "Non-Expense".

L'expression illustrée dans la capture d'écran contient les éléments suivants :

  1. Trois instructions :
    • If FCGL.Account Type equals "E" (Si FCGL.Account Type est égal à "E")
    • Return "Expense" (Renvoyer "Expense")
    • Return "Non-Expense" (Renvoyer "Non-Expense")

    Remarque :

    Lors de la génération de l'expression, vous ne devez pas ajouter d'instruction ELSE IF. Lorsque l'expression est exécutée, si l'instruction IF ne se vérifie pas, la logique passe à l'instruction suivante. Reportez-vous à la section Création d'expressions.
  2. Quatre termes d'expression :
    • FCGL.Account Type equals (FCGL.Account Type est égal à)
    • "E"
    • "Expense"
    • "Non-Expense"
  3. Un objet : sourceNode.
  4. Deux attributs : FCGL.Account Type et properties.
  5. Une méthode : equals.
  6. Trois littéraux : E, Expense, Non-Expense.