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

Nouveau : 12 décembre 2006

L'extension pour le traitement des données Hyperion Essbase prend en charge des propriétés de champs étendues. Les propriétés de champs étendues sont des propriétés complémentaires aux propriétés Reporting Services Value 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 s'affichent pas dans le volet Datasets dans la collection de champs pour un dataset du rapport. Vous pouvez inclure des valeurs de propriété de champ étendues dans votre rapport en écrivant des expressions à l'aide de la collection Fields globale qui en spécifient le 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 globale Les propriétés personnalisées sont définies en fonction de chaque fournisseur de données et sont accessibles par l'intermédiaire de la collection Fields globale uniquement par la syntaxe utilisant 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 extraites en même temps que les champs 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 :

  • Les propriétés de champ sont prises généralement en charge par plusieurs fournisseurs de données qui mappent à des propriétés prédéfinies de champ dataset du 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.
  • Les propriétés prédéfinies de champ sont généralement prises en charge par plusieurs fournisseurs de données et apparaissent dans la requête MDX pour 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 le pointeur sur un champ dans le volet de 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 globales dans les expressions (Reporting Services).

Bb326360.note(fr-fr,SQL.90).gifRemarque :
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 d'une expression en utilisant la syntaxe décrite ci-dessous. 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 pouvant être utilisées 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 dresse la liste des propriétés de champ personnalisées pouvant être utilisées 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.

Ressources externes

Utilisation de SQL Server 2005 Reporting Services avec Hyperion

Voir aussi

Référence

Utilisation de collections globales dans les expressions (Reporting Services)

Autres ressources

Utilisation des expressions dans Reporting Services
Interface utilisateur du Concepteur de requêtes Hyperion Essbase

Aide et Informations

Assistance sur SQL Server 2005