• Article

Utilisation des propriétés de champ étendues pour un cube Hyperion Essbase

L'extension pour le traitement des données Hyperion Essbase prend en charge les propriétés de champ étendues. Les propriétés de champ étendues sont des propriétés complémentaires aux propriétés de champ prise en charge par Reporting ServicesValue et IsMissing qui sont disponibles sur la source de données et prises en charge par l'extension pour le traitement des données. Les propriétés étendues ne figurent pas dans le volet Données du rapport dans le cadre de la collection de champs pour un dataset de rapport. Vous pouvez inclure des valeurs de propriétés de champ étendues dans votre rapport en écrivant des expressions qui utilisent la collection Fields intégrée qui les spécifient par nom.

Les propriétés étendues peuvent être prédéfinies ou personnalisées. Les propriétés prédéfinies sont des propriétés communes à plusieurs sources de données qui sont mappées à des noms de propriété de champ spécifiques. Elles sont accessibles par nom via la collection Fields intégrée. Les propriétés personnalisées sont définies pour chaque fournisseur de données et sont accessibles par l'intermédiaire de la collection Fields intégrée uniquement via la syntaxe qui utilise le nom de la propriété étendue comme chaîne.

Pour faire référence à des propriétés étendues prédéfinies dans une expression, vous pouvez utiliser l'une des syntaxes décrites ci-dessous :

  • Fields!FieldName.PropertyName

  • Fields!FieldName("PropertyName")

Utilisation des propriétés de champ

Les propriétés de champ étendues sont récupérées en même temps que les champs de dataset de rapport lorsque vous exécutez une requête MDX à l'aide du fournisseur de données Microsoft.NET Framework pour Hyperion Essbase. Les champs et les propriétés de cellule et de dimension spécifiés dans la requête MDX sont extraites dans la source de données.

Les propriétés de champ sont classées selon les catégories suivantes :

  • Propriétés de champ qui sont généralement prises en charge par plusieurs fournisseurs de données et qui sont mappées à des propriétés prédéfinies de champ de dataset de rapport. Par exemple, la propriété prédéfinie Value de dataset du rapport représente la propriété par défaut pour la valeur d'une mesure ou d'une dimension dans la source de données. La valeur par défaut pour une mesure est une valeur numérique. La valeur par défaut pour une dimension est la légende conviviale. Pour inclure la valeur par défaut dans une zone de texte, utilisez l'expression =Fields!<FieldName>.Value.

  • Propriétés prédéfinies de champ qui sont généralement prises en charge par plusieurs fournisseurs de données et qui apparaissent dans la requête MDX sous-jacente d'un dataset de rapport. Par exemple, la propriété de dimension MDX MEMBER_UNIQUE_NAME est mappée à la propriété prédéfinie de champ dataset du rapport UniqueName. Pour inclure la valeur de nom unique dans une zone de texte, utilisez l'expression =Fields!<FieldName>.UniqueName.

  • Les propriétés de champ personnalisées qui sont prises en charge par un fournisseur de données et qui apparaissent dans la requête MDX sous-jacente pour un dataset de rapport, n'apparaissent pas dans le volet Datasets comme champs sous ce dataset. Par exemple, Long Names est une propriété de membre définie pour un niveau de dimension. Pour inclure la valeur dans une zone de texte, utilisez l'expression =Fields!<FieldName>("Long Names"). Les noms de champ de l'expression respectent la casse.

Le nom d'une propriété de champ étendue apparaît dans l'info-bulle lorsque vous placez la souris sur un champ dans le volet Métadonnées du concepteur de requêtes. Pour plus d'informations sur le Concepteur de requêtes que vous pouvez utiliser pour explorer les données sous-jacentes, consultez Interface utilisateur du Concepteur de requêtes Hyperion Essbase.

Pour plus d'informations sur l'utilisation de champs et de propriétés de champ dans une expression, consultez Utilisation de collections intégrées dans les expressions (Reporting Services).

[!REMARQUE]

Il existe des valeurs pour les propriétés de champ étendues uniquement si elles sont incluses dans l'expression MDX et la source de données fournit ces valeurs lorsque votre rapport s'exécute et extrait les données pour ses datasets. Vous pouvez alors faire référence à ces valeurs de propriété Field à partir de n'importe quelle expression en utilisant la syntaxe décrite dans la section suivante. Cependant, dans la mesure où ces champs sont spécifiques à ce fournisseur de données et ne font pas partie du langage de définition de rapport, les modifications que vous apportez à ces valeurs ne sont pas enregistrées avec la définition du rapport.

Propriétés de champ prédéfinies

Le tableau suivant dresse la liste des propriétés de champ prédéfinies que vous pouvez utiliser pour une source de données Hyperion Essbase.

Propriété

Type

Description ou valeur attendue

Value

Object

Précise la valeur de données du champ.

Pour une propriété de dimension, celle-ci est mappée à MEMBER_CAPTION. Pour une mesure, elle est mappée à la valeur de données.

IsMissing

Boolean

Indique si le champ figure dans le dataset obtenu.

FormattedValue

String

Retourne la valeur mise en forme d'un élément clé.

Mappé à partir de FORMATTED_VALUE dans l'expression MDX.

BackgroundColor

String

Retourne la couleur d'arrière-plan définie dans la base de données pour le champ.

Mappé à partir de BACK_COLOR dans l'expression MDX.

Color

String

Retourne la couleur de premier plan définie dans la base de données pour l'élément.

Mappé à partir de FORE_COLOR dans l'expression MDX.

UniqueName

String

Retourne le nom complet d'un niveau.

Mappé à partir de MEMBER_UNIQUE_NAME dans l'expression MDX.

Propriétés personnalisées

Pour faire référence à des propriétés étendues personnalisées dans une expression, vous pouvez utiliser la syntaxe suivante :

  • Fields!FieldName("PropertyName")

Le tableau suivant indique la propriété de champ personnalisée que vous pouvez utiliser pour une source de données Hyperion Essbase.

Propriété

Type

Description ou valeur attendue

FORMAT_STRING

String

Défini sur une mesure, FormattedValue est disponible comme type chaîne.