Chaînes de format

A l'aide de chaînes de format, vous pouvez formater les valeurs des membres Essbase dans des mesures de type numérique afin qu'elles apparaissent, à des fins de requête, sous forme de texte, de dates ou d'autres types de valeur prédéfinis. Vous pouvez définir des chaînes de format pour tous les membres de la dimension Mesures et pour les membres de formule d'autres dimensions.

La valeur affichée lorsque vous utilisez des chaînes de format est la valeur formatée de la cellule (propriétéFORMATTED_VALUE dans MDX).

La valeur réelle sous-jacente est numérique et cette valeur n'est pas affectée par la valeur formatée associée. Les chaînes de format permettent d'afficher des valeurs plus significatives à la place des valeurs numériques brutes. Par exemple, en utilisant une valeur formatée basée sur du texte, vous pouvez afficher les cellules de données comme "Elevée", "Moyenne" et "Faible".

Les valeurs de texte et de type de date sont également prises en charge à l'aide des types de mesure de texte et de date intégrés. Les chaînes de format ajoutent plus de flexibilité à votre implémentation, car vous pouvez appliquer des chaînes de format aux membres de plusieurs dimensions, tandis qu'avec les mesures de type texte et de type date, vous ne pouvez appliquer que l'une ou l'autre à une dimension de mesure unique. Vous pouvez appliquer des chaînes de format à des dimensions numériques ; vous n'avez pas besoin de saisir la dimension sous forme de texte ou de date.

Les chaînes de format peuvent être appliquées aux bases de données en mode "aggregate storage" (ASO) ou "block storage" (BSO).

Rubriques :

Implémenter des chaînes de format

Les chaînes de format sont prises en charge pour les bases en mode "aggregate storage" (ASO) et "block storage" (BSO). Vous implémentez des chaînes de format au niveau de la base de données. Utilisez le workflow suivant pour activer et utiliser les chaînes de format dans Essbase.

  1. Dans les propriétés de l'outline, activez les mesures typées.

  2. Dans la dimension Comptes, créez une mesure dont vous souhaitez formater les membres et, dans ses propriétés, modifiez le champ Associer une chaîne de format pour créer une directive de format MDX. Pour connaître la syntaxe de création d'une directive de format MDX, reportez-vous à la section MDX Format Directive.

Limites des chaînes de format

Les chaînes de format ne sont pas prises en charge entre les partitions.

La longueur maximale d'une chaîne de format est de 256 caractères.

Les membres partagés (y compris les partages implicites) ne peuvent pas avoir de chaînes de format distinctes. Les membres partagés héritent de la chaîne de format du membre prototype.

Directive de format MDX

Vous définissez une chaîne de format Essbase à l'aide d'une expression MDX, dans les cubes ASO et BSO.

La syntaxe MDX pour appliquer une chaîne de format est la suivante :

format_string_expression = MdxFormat (string_value_expression)

où string_value_expression est une expression de valeur de chaîne MDX valide comme décrit dans la spécification MDX (reportez-vous à la section Règles de grammaire MDX).

La plupart des expressions MDX peuvent être utilisées pour spécifier des chaînes de format. Cependant, les chaînes de format ne peuvent pas contenir de références à des valeurs de cellules de données autres que la valeur de cellule en cours de formatage. La valeur de cellule actuelle peut être référencée à l'aide de la fonction MDX CellValue.

Essbase traite les membres dont les chaînes de format ne sont pas valides comme si aucune chaîne de format n'était définie. Les outlines peuvent être enregistrées avec des chaînes de format non valides. Essbase génère un avertissement si une requête se compose d'un membre dont la chaîne de format n'est pas valide.

Si un membre n'est pas associé à une chaîne de format, des règles de format par défaut sont appliquées. Les règles de format par défaut formatent une cellule selon que la mesure est de type numérique, texte ou date. Pour les mesures numériques, la valeur formatée par défaut est la version texte de ce nombre. Pour les mesures de texte, la valeur formatée par défaut est la valeur de texte basée sur l'objet de liste de texte associé. Pour les valeurs de date, le format par défaut est une chaîne de date formatée en fonction de la chaîne de format de date définie dans les propriétés de l'outline.

Fonctions prenant en charge les chaînes de format

Certaines fonctions MDX sont utiles lorsque des chaînes de format sont appliquées aux mesures Essbase.

Les chaînes de format sont appliquées en tant qu'expressions MDX, dans les cubes ASO et BSO.

  • EnumText renvoie le libellé de liste de texte associé à la valeur numérique interne.

  • EnumValue renvoie la valeur numérique interne d'un libellé de liste de texte.

  • CellValue renvoie la valeur numérique interne de la cellule en cours.

  • NumToStr convertit une valeur en chaîne décimale.

La fonction de calcul @ENUMVALUE peut être utile lors de l'écriture de scripts de calcul pour une base de données en mode "block storage" comportant des mesures de texte ou des chaînes de format. Cette fonction renvoie le libellé de liste de texte associé à la valeur numérique interne.

L'instruction alter session set dml_output de MaxL comporte une clause set formatted_value on | off. Par défaut, les valeurs formatées sont affichées dans les requêtes, mais cette instruction peut être utilisée pour désactiver l'affichage des valeurs formatées.

La commande OUTFORMATTEDVALUES Report Writer renvoie les valeurs de cellule formatées dans un rapport.