Utilisation de variables de substitution

Utilisez les variables de substitution dans les scripts de calcul pour stocker les valeurs qui peuvent changer. Utilisez les variables de substitution d'exécution lorsque vous avez besoin que différents utilisateurs indiquent des valeurs distinctes pour un même script.

Par exemple, si plusieurs scripts de calcul, formules, filtres, scripts de rapport et scripts MDX doivent se référer au mois en cours, vous n'avez pas besoin de rechercher et de remplacer le mois tous les 30 jours environ dans toute votre bibliothèque d'artefacts de cube. Vous pouvez en effet définir une variable de substitution nommée CurrMonth et modifier sa valeur affectée tous les mois selon le mois en cours. Tous les artefacts de cube qui font référence à la variable feront alors référence au mois approprié.

Voici un exemple de variable de substitution simple pour représenter le mois en cours :

Nom de variable : CurrMonth

Valeur : Jan

Les valeurs de variable de substitution s'appliquent à tous les utilisateurs qui exécutent un script de calcul contenant la variable. Par exemple, si CurrMonth a la valeur Jan, tous les scripts contenant &CurrMonth seront exécutés pour Jan. La portée d'une variable de substitution peut être des types suivants :

  • globale (pour toutes les applications et les cubes sur le serveur)
  • application (pour tous les cubes dans l'application)
  • cube (pour un seul cube)

Pour définir une variable de substitution pour un cube donné, procédez comme suit :

  1. Dans l'interface Web Oracle Analytics Cloud – Essbase, sur la page Applications, développez l'application pour afficher le cube à modifier.

  2. Dans le menu Actions à droite du cube, lancez l'inspecteur.

  3. Sélectionnez l'onglet Variables, puis cliquez sur Ajouter Image de l'icône Ajouter..

  4. Saisissez le nom et la valeur de la variable, puis cliquez sur Enregistrer et Fermer.

Pour définir une variable de substitution pour une application donnée, procédez comme suit :

  1. Sur la page Applications, dans le menu Actions à droite de l'application, lancez l'inspecteur.

  2. Sélectionnez l'onglet Variables, puis cliquez sur Ajouter Image de l'icône Ajouter..

  3. Saisissez le nom et la valeur de la variable, puis cliquez sur Enregistrer et Fermer.

Pour définir une variable de substitution globalement, procédez comme suit :

  1. Dans Oracle Analytics Cloud – Essbase, cliquez sur Console.

  2. Cliquez sur l'onglet Variables, puis sur Ajouter.

  3. Saisissez le nom et la valeur de la variable, puis cliquez sur Enregistrer.

Une fois que la variable de substitution est définie, vous pouvez l'utiliser dans des scripts de calcul, des formules, des filtres, des scripts MDX, des règles de chargement et des rapports. Pour faire référence à la variable, utilisez le préfixe &.

Voici un exemple de script de calcul faisant référence à une variable de substitution :

FIX(&CurrMonth)
   CALC DIM (Measures, Product);
ENDFIX

Voici un exemple de formule faisant référence à une variable de substitution :

@ISMBR(&CurrMonth)

Les variables de substitution d'exécution vous permettent de déclarer des variables et leurs valeurs dans le contexte d'une action d'exécution, telle qu'un script de calcul, un script MaxL ou une requête MDX. Vous pouvez affecter des valeurs numériques aux variables de substitution d'exécution ou ces variables peuvent faire référence à des noms de membre. Vous pouvez affecter une valeur par défaut au cas où un utilisateur ne changerait pas la valeur d'entrée. En outre, pour les scripts de calcul, vous pouvez remplir la valeur de la variable au moment de l'exécution à partir des membres d'une dimension présentée dans une grille Smart View. Concernant les scripts de calcul avec des valeurs variables qui se remplissent au moment de l'exécution, vous devez les lancer à partir de Smart View, car les variables n'ont aucune définition en dehors du contexte de la grille.

Vous pouvez définir des variables de substitution d'exécution dans le script de calcul à l'aide de paires clé-valeur :

SET RUNTIMESUBVARS
{
   myMarket = "New York";
   salesNum = 100;
   pointD = "Actual"->"Final";
}

Vous pouvez également définir des variables de substitution d'exécution avec des valeurs qui changent dynamiquement en fonction du PDV. Pour ce faire, affectez la définition au PDV et utilisez une syntaxe XML pour autoriser les invites contextuelles Smart View.

Pour plus d'informations, reportez-vous aux sections suivantes