Utilisation des propriétés de cellule (MDX)
Les propriétés de cellule dans les expressions multidimensionnelles (MDX, Multidimensional Expressions) contiennent des informations sur le contenu et le format des cellules appartenant à une source de données multidimensionnelles, par exemple un cube.
La syntaxe MDX prend en charge le mot clé CELL PROPERTIES dans une instruction MDX SELECT pour l'extraction des propriétés de cellule intrinsèques. Ces propriétés sont principalement utilisées pour définir l'affichage des données des cellules.
Syntaxe du mot clé CELL PROPERTIES
Utilisez la syntaxe suivante pour le mot clé CELL PROPERTIES de l'instruction MDX SELECT :
SELECT [<axis_specification>
[, <axis_specification>...]]
FROM [<cube_specification>]
[WHERE [<slicer_specification>]]
[<cell_props>]
La syntaxe suivante représente le format de la valeur <cell_props> et la manière dont elle utilise le mot clé CELL PROPERTIES avec une ou plusieurs propriétés de cellule intrinsèques :
<cell_props> ::= CELL PROPERTIES <property> [, <property>...]
Propriétés de cellule intrinsèques prises en charge
Le tableau suivant dresse la liste des propriétés de cellule intrinsèques prises en charge utilisées dans la valeur <property>.
Propriété |
Description |
|---|---|
ACTION_TYPE |
Masque binaire indiquant les types d'actions qui existent sur la cellule. Cette propriété peut prendre les valeurs suivantes :
.gif "Remarque") Remarque
Les actions d'extraction des requêtes dont la clause Where contient un jeu ne sont pas comprises.
|
BACK_COLOR |
Couleur d'arrière-plan utilisée pour afficher la propriété VALUE ou FORMATTED_VALUE. Pour plus d'informations, consultez Contenu de FORE_COLOR et BACK_COLOR (MDX). |
CELL_ORDINAL |
Numéro ordinal de la cellule dans le jeu de données. |
FONT_FLAGS |
Masque de bits détaillant les effets sur la police. La valeur de cette propriété est le résultat d'une opération OU au niveau du bit sur une ou plusieurs des constantes suivantes :
Par exemple, la valeur 5 représente la combinaison des effets gras (MDFF_BOLD) et souligné (MDFF_UNDERLINE). |
FONT_NAME |
Police à utiliser pour afficher la propriété VALUE ou FORMATTED_VALUE. |
FONT_SIZE |
Taille de la police à utiliser pour afficher la propriété VALUE ou FORMATTED_VALUE. |
FORE_COLOR |
Couleur d'avant-plan utilisée pour afficher la propriété VALUE ou FORMATTED_VALUE. Pour plus d'informations, consultez Contenu de FORE_COLOR et BACK_COLOR (MDX). |
FORMAT |
Identique à FORMAT_STRING. |
FORMAT_STRING |
Chaîne de format utilisée pour créer la valeur de la propriété FORMATTED_VALUE. Pour plus d'informations, consultez Contenu de FORMAT_STRING (MDX). |
FORMATTED_VALUE |
Chaîne de caractères représentant un affichage avec mise en forme de la propriété VALUE. |
LANGUAGE |
Paramètre régional auquel FORMAT_STRING sera appliqué. LANGUAGE est généralement utilisé pour la conversion de devises. |
UPDATEABLE |
Valeur indiquant si la cellule peut être mise à jour. Cette propriété peut prendre les valeurs suivantes :
|
VALUE |
Valeur sans mise en forme de la cellule. |
Seules les propriétés de cellule CELL_ORDINAL, FORMATTED_VALUE et VALUE sont obligatoires. Toutes les propriétés de cellule, intrinsèques ou propres aux fournisseurs, sont définies dans le jeu de lignes du schéma PROPERTIES, notamment les types de données et la prise en charge par un fournisseur. Pour plus d'informations sur le jeu de lignes du schéma PROPERTIES, consultez Ensemble de lignes MDSCHEMA_PROPERTIES.
Par défaut, si le mot clé CELL PROPERTIES n'est pas utilisé, les propriétés de cellule retournées sont, dans l'ordre : VALUE, FORMATTED_VALUE et CELL_ORDINAL. Si le mot clé CELL PROPERTIES est utilisé, seules les propriétés de cellule explicitement spécifiées avec le mot clé sont retournées.
L'exemple suivant illustre l'utilisation du mot clé CELL PROPERTIES dans une requête MDX :
SELECT
{[Measures].[Reseller Gross Profit]} ON COLUMNS,
{[Reseller].[Reseller Type].[Reseller Name].Members} ON ROWS
FROM [Adventure Works]
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORMAT_STRING, FORE_COLOR, BACK_COLOR
Les requêtes MDX qui retournent des jeux de lignes réduits ne retournent pas de propriétés de cellule ; dans ce cas, chaque cellule est représentée comme si seule la propriété de cellule FORMATTED_VALUE était retournée.
Définition de propriétés de cellule
Les propriétés de cellule peuvent être définies dans MicrosoftSQL ServerAnalysis Services à l'aide de l'onglet Calculs du Concepteur de cube ou du Concepteur de dimensions. Les propriétés de cellule sont représentées sous forme d'expressions de chaîne, illustrées dans l'exemple suivant qui fournit, pour le membre spécifié, un arrière-plan jaune avec un avant-plan rouge :
FORE_COLOR='255',BACK_COLOR='65535'
Les propriétés de cellule se cumulent généralement au niveau du membre parent, sauf si ce dernier est un membre personnalisé avec ses propres propriétés de cellule. Dans ce dernier cas, les propriétés de cellule du parent annulent et remplacent celles provenant de ses enfants.