Utilisation de variables de substitution

Utilisez les variables de substitution dans les scripts de calcul Essbase 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)

Afin de définir ou de mettre à jour une variable de substitution pour un cube donné, procédez comme suit :

  1. Sur la page d'accueil, ouvrez l'application, puis la base de données (cube).
  2. Cliquez sur Variables.
  3. Pour créer une variable, cliquez sur Créer, entrez le nom et la valeur de la variable et cliquez sur Enregistrer Image de l'icône d'enregistrement de la zone d'actions..
  4. Si vous modifiez la valeur d'une variable existante, cliquez deux fois sur la valeur (ou cliquez sur Modifier Image de l'icône de modification de la zone d'actions.), saisissez la valeur mise à jour et appuyez dessus (ou cliquez sur Enregistrer Image de l'icône d'enregistrement de la zone d'actions.).

Afin de définir ou de mettre à jour une variable de substitution pour une application donnée, procédez comme suit :

  1. Sur la page d'accueil, ouvrez l'application.
  2. Cliquez sur Variables.
  3. Pour créer une variable, cliquez sur Créer, saisissez le nom de la variable et sa valeur, puis cliquez sur EnregistrerImage de l'icône d'enregistrement de la zone d'actions..
  4. Si vous modifiez la valeur d'une variable existante, cliquez deux fois sur la valeur (ou cliquez sur Modifier Image de l'icône de modification de la zone d'actions.), saisissez la valeur mise à jour et appuyez dessus (ou cliquez sur Enregistrer Image de l'icône d'enregistrement de la zone d'actions.).

Pour définir ou mettre à jour une variable de substitution globalement, procédez comme suit :

  1. Sur la page d'accueil, cliquez sur Console.
  2. Cliquez sur la mosaïque Variables.
  3. Pour créer une variable, cliquez sur Créer, saisissez le nom de la variable et sa valeur, puis cliquez sur EnregistrerImage de l'icône d'enregistrement de la zone d'actions..
  4. Si vous modifiez la valeur d'une variable existante, cliquez deux fois sur la valeur (ou cliquez sur Modifier Image de l'icône de modification de la zone d'actions.), saisissez la valeur mise à jour et appuyez dessus (ou cliquez sur Enregistrer Image de l'icône d'enregistrement de la zone d'actions.).

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