Implémentation de variables pour les informations qui changent

Vous pouvez utiliser des variables de substitution Essbase en tant qu'espaces réservés pour modifier régulièrement les informations. Les modifications apportées à une valeur de variable étant répercutées partout où la variable est utilisée, la nécessité d'effectuer des mises à jour manuelles est réduite.

Par exemple, de nombreux rapports dépendent des périodes de reporting. Si vous générez un rapport basé sur le mois en cours, vous devez mettre à jour le script de rapport manuellement chaque mois. Une variable de substitution, telle que CurMnth, définie sur le serveur Essbase, permet de modifier la valeur affectée chaque mois à la période. Lorsque vous utilisez le nom de variable dans un script de rapport, les informations sont mises à jour dynamiquement lorsque vous exécutez le rapport final.

Vous pouvez utiliser des variables de substitution avec des applications en mode "aggregate storage" (ASO) et en mode "block storage" (BSO) (sauf indication contraire) dans les domaines suivants :

  • Formules d'outline en mode "aggregate storage"

  • Formules de l'outline Block Storage

  • Scripts de calcul (bases de données en mode "block storage" uniquement)

    Les variables d'exécution et de substitution de substitution sont prises en charge dans les scripts de calcul.

  • Définitions d'en-tête et de champ de fichier de règles de chargement des données. Vous pouvez entrer des noms de variable pour les noms de dimension et de membre.

  • Spécifications de nom de source de données (DSN) dans les fichiers de règles pour les sources de données SQL

  • Clauses SELECT, FROM ou WHERE dans les fichiers de règles pour les sources de données SQL

  • Filtres de sécurité

  • Requêtes MDX

  • Smart View

  • Scripts de rapport

Vous pouvez définir des variables de substitution aux niveaux suivants :

  • Globalement : permet d'accéder à la variable à partir de toutes les applications et bases de données sur le serveur Essbase.

  • Application : Permet d'accéder à la variable à partir de toutes les bases de données de l'application.

  • Base de données : permet d'accéder à la variable dans la base de données indiquée.

Valeurs et noms de variable de substitution autorisés

Lorsque vous utilisez des variables de substitution dans Essbase, suivez les instructions relatives aux caractères et aux types de données que vous pouvez utiliser dans les noms et les valeurs des variables de substitution.

Les restrictions suivantes s'appliquent aux noms et aux valeurs de variable de substitution :

Caractères autorisés dans le nom de variable

Les caractères alphanumériques et les traits de soulignement sont autorisés, mais pas les caractères spéciaux ni les espaces. Limite de caractères : reportez-vous à Limites.

Caractères autorisés dans la valeur de variable

Tout caractère est autorisé à l'exception d'une esperluette de début (&). Limite de caractères : reportez-vous à Limites.

Noms de membre Essbase utilisés comme valeurs de variable

Placez les noms de membre commençant par un nombre ou contenant des caractères spéciaux entre guillemets (" ") pour les bases en mode "block storage" et entre crochets ([ ]) pour les bases en mode "aggregate storage". Pour plus d'informations, voir Conventions de dénomination dans des scripts d'analyse, des scripts d'état, des formules, des filtres et des valeurs de variables de substitution et d'environnement.

Pour définir une valeur de variable de substitution comme un nom de membre en double, utilisez le nom de membre qualifié entre guillemets doubles. Par exemple, une valeur pour &Period peut être "[2022].[Qtr1]".

N'utilisez pas de nom de variable de substitution dans le cadre d'un nom de membre qualifié. Par exemple, l'indication de "[2022].[&CurrentQtr]" n'est pas valide.

Nombres utilisés comme valeurs de variable

Placez les valeurs numériques entre guillemets (" ") pour les bases en mode "block storage" (BSO) et entre parenthèses ([ ]) pour les bases en mode "aggregate storage" (ASO).

Par exemple, si le nom de la variable est Month et que sa valeur est 01, pour le stockage de blocs, définissez la valeur sur "01". Pour le mode "aggregate storage", définissez la valeur sur [01].

Plusieurs variables portant le même nom

Les variables peuvent porter le même nom tant qu'elles sont définies à des portées différentes. La priorité de résolution de variable fonctionne comme suit : la variable de base de données est résolue avant la variable d'application. La variable d'application est résolue avant la variable globale.

Créer ou définir des variables de substitution

Avant de définir une variable de substitution, reportez-vous à Noms et valeurs de variable de substitution autorisés.

Vous pouvez créer ou définir des variables de substitution au niveau du serveur Essbase, de l'application ou de la base de données.

Pour garantir qu'une nouvelle valeur de variable de substitution est disponible dans les formules, les définitions de partition et les filtres de sécurité, arrêtez et redémarrez l'application. Toutes les autres utilisations des variables de substitution sont résolues dynamiquement lorsqu'elles sont utilisées.

Lorsque vous ajoutez ou mettez à jour des variables de substitution, elles sont envoyées à l'application et résolues dynamiquement.

Pour définir une variable de substitution à l'aide de l'interface Web Essbase, reportez-vous à Utilisation de variables de substitution. Vous pouvez également utiliser un classeur d'application pour définir des variables au niveau de l'application ou utiliser les instructions MaxL suivantes :

Enlever des variables de substitution

Vous pouvez supprimer une variable de substitution Essbase qui n'est plus nécessaire.

Pour supprimer une variable de substitution, vous pouvez la supprimer du classeur d'application et créer le cube, la supprimer à l'aide de l'interface Web Essbase ou utiliser les instructions MaxL suivantes :

Mettre à jour les variables de substitution

Les variables de substitution étant des espaces réservés pour la modification des informations, vous devrez peut-être mettre à jour leurs valeurs fréquemment. Vous pouvez modifier des variables de substitution existantes à l'aide de MaxL ou de l'interface Web Essbase.

Pour mettre à jour une variable de substitution, vous pouvez utiliser l'une des instructions MaxL suivantes (dont l'utilisation dépend du contexte de votre variable) :

Si vous préférez utiliser l'interface Web Essbase pour mettre à jour une variable, reportez-vous à la section Utiliser des variables de substitution pour obtenir des instructions.