Utilisation de variables

Les variables vous permettent de stocker la logique métier sous forme de valeurs nommées dans une expression.

L'utilisation de variables peut améliorer vos expressions de plusieurs manières :

  • Elles simplifient le développement d'expressions en vous permettant de stocker des termes longs afin que vous puissiez les réutiliser rapidement.
  • Elles améliorent la lisibilité d'une expression en utilisant des noms de variable plus courts pour représenter des blocs plus importants de la logique d'expression.
  • Elles peuvent améliorer les performances de calcul en permettant l'extraction des données de noeud une seule fois lors de la définition de la valeur de variable, puis l'accès à la valeur de variable mise en cache dans d'autres parties de l'expression. Ce processus est particulièrement efficace lorsque vous évaluez plusieurs fois un ensemble important de noeuds dans une expression.

Deux types de variable sont disponibles dans Oracle Fusion Cloud Enterprise Data Management :

  • Les variables globales sont définies au niveau supérieur de l'expression et peuvent être utilisées n'importe où dans l'expression.
  • Les variables locales sont définies dans une instruction IF spécifique et ne peuvent être utilisées que dans cette instruction. Elles peuvent être utiles à la logique conditionnelle au sein de votre expression.

Vous pouvez utiliser des variables dans n'importe quel contexte d'expression, par exemple pour dériver des valeurs de propriété, créer des validations personnalisées et créer des filtres d'extraction.

Définition des variables

Votre emplacement dans le générateur d'expressions détermine le type de variable que vous définissez. Si vous êtes au niveau supérieur de l'expression, la variable est définie en tant que variable globale et peut être utilisée n'importe où dans l'expression. Si vous êtes dans une instruction IF, la variable est définie en tant que variable locale et ne peut être utilisée que dans cette instruction IF. La procédure de définition d'une variable est la même pour les deux types.

  1. Effectuez l'une des actions suivantes :
    • Dans la section Instructions de la palette, faites glisser Définir une expression vers l'éditeur.
    • Cliquez sur Insérer une instruction Icône Insérer une instruction, puis sélectionnez Définir une variable.
  2. Dans la boîte de dialogue Définir une variable :
    • Entrez un nom pour la variable.
    • Sélectionnez le type de données de la variable. Les types suivants sont pris en charge :
      • Valeur booléenne
      • Date
      • Float
      • Entier
      • Noeud
      • Chaîne
      • Liste de chaînes
      • Horodatage
    • Cliquez sur OK.

    La variable est créée et affichée dans la section Variables de la palette.

    Note:

    La section Variables répertorie toutes les variables globales et locales. N'oubliez pas que vous ne pouvez faire glisser les variables locales que vers les instructions dans lesquelles elles sont définies.

Utilisation de variables dans les expressions

Une fois que vous avez défini une variable, vous pouvez l'utiliser dans une méthode ou une instruction d'expression.

  • Dans la section Variables de la palette, faites glisser la variable vers un terme d'expression au sein d'une instruction (comme une instruction IF ou RETURN) ou vers une méthode.
  • Dans une instruction ou une méthode, cliquez sur Choisir un terme d'expression choisir un terme d'expression et utilisez le menu Variables pour sélectionner la variable à insérer.

Vous pouvez sélectionner des variables globales n'importe où dans l'expression. Vous ne pouvez sélectionner des variables locales qu'avec le contexte de l'instruction IF dans laquelle elles ont été définies. Dans les deux cas, vous ne pouvez utiliser une variable qu'après l'avoir définie dans l'éditeur.

Affectation de valeurs à des variables

Vous pouvez affecter une valeur à une variable au sein d'une expression. Par exemple, vous pouvez définir une variable globale varDesc pour extraire la propriété Description d'un noeud. Ensuite, dans une instruction IF, vous pouvez ajouter une logique indiquant que si le pays du noeud est les Etats-Unis, la valeur affectée à la variable est la propriété Description - US du noeud.

Pour affecter une valeur à une variable, procédez comme suit :

  1. Insérez la variable à laquelle vous souhaitez affecter une valeur.
  2. Cliquez sur Insérer une instruction Icône Insérer une instruction, puis sélectionnez Affecter la variable.
  3. Sélectionnez la variable à laquelle vous souhaitez affecter une valeur, puis utilisez le menu d'expression ou le menu à points pour modifier la valeur de la variable selon vos besoins. Vous pouvez affecter une valeur littérale, une autre expression ou une autre variable en tant que valeur de variable.

Changement de nom et suppression des variables

  • Pour renommer une variable, cliquez sur Actions d'instruction Icône Actions d'instruction, sélectionnez Renommer, puis entrez un nouveau nom.
  • Pour enlever une variable, cliquez sur Actions d'instruction Icône Actions d'instruction, puis sélectionnez Enlever.