Usar las propiedades de celda (MDX)
Las propiedades de celda de las expresiones multidimensionales (MDX) contienen información sobre el contenido y el formato de las celdas de un origen de datos multidimensional, como un cubo.
MDX admite la palabra clave CELL PROPERTIES en una instrucción MDX SELECT para recuperar propiedades de celda intrínsecas. Las propiedades de celda intrínsecas se suelen usar para facilitar la presentación visual de los datos de las celdas.
Sintaxis de la palabra clave CELL PROPERTIES
Use la siguiente sintaxis para la palabra clave CELL PROPERTIES de la instrucción MDX SELECT:
SELECT [<axis_specification>
[, <axis_specification>...]]
FROM [<cube_specification>]
[WHERE [<slicer_specification>]]
[<cell_props>]
La siguiente sintaxis muestra el formato del valor <cell_props> y cómo éste usa la palabra clave CELL PROPERTIES junto con una o más propiedades de celda intrínsecas:
<cell_props> ::= CELL PROPERTIES <property> [, <property>...]
Propiedades de celda intrínsecas compatibles
En la siguiente tabla figuran las propiedades de celda intrínsecas compatibles que se utilizan en el valor <property>.
Propiedad |
Descripción |
|---|---|
ACTION_TYPE |
Máscara de bits que indica los tipos de acciones de la celda. Esta propiedad admite cualquiera de los siguientes valores:
.gif "Nota") Nota
Las acciones de obtención de detalles no se incluyen para las consultas que contienen un conjunto en la cláusula WHERE.
|
BACK_COLOR |
Color de fondo para mostrar las propiedades VALUE o FORMATTED_VALUE. Para obtener más información, vea Contenido de FORE_COLOR y BACK_COLOR (MDX). |
CELL_ORDINAL |
Número ordinal de la celda en el conjunto de datos. |
FONT_FLAGS |
Máscara de bits que detalla los efectos de la fuente. El valor es el resultado de una operación de bits OR de una o varias de las siguientes constantes:
Por ejemplo, el valor 5 representa la combinación de los efectos de fuente negrita (MDFF_BOLD) y subrayado (MDFF_UNDERLINE). |
FONT_NAME |
Fuente usada para mostrar la propiedad VALUE o FORMATTED_VALUE. |
FONT_SIZE |
Tamaño de fuente utilizado para mostrar la propiedad VALUE o FORMATTED_VALUE. |
FORE_COLOR |
Color de primer plano para mostrar las propiedades VALUE o FORMATTED_VALUE. Para obtener más información, vea Contenido de FORE_COLOR y BACK_COLOR (MDX). |
FORMAT |
Equivalente a FORMAT_STRING. |
FORMAT_STRING |
Cadena de formato usada para crear el valor de la propiedad FORMATTED_VALUE. Para obtener más información, vea FORMAT_STRING, contenido (MDX). |
FORMATTED_VALUE |
Cadena de caracteres que representa una visualización con formato de la propiedad VALUE. |
LANGUAGE |
Configuración regional a la que se aplicará FORMAT_STRING. LANGUAGE suele utilizarse para la conversión de moneda. |
UPDATEABLE |
Valor que indica si la celda puede actualizarse. Esta propiedad admite cualquiera de los siguientes valores:
|
VALUE |
Valor sin formato de la celda. |
Sólo son obligatorias las propiedades de celda CELL_ORDINAL, FORMATTED_VALUE y VALUE. Todas las propiedades de celda, intrínsecas o específicas del proveedor, se definen en el conjunto de datos del esquema PROPERTIES, incluidos los tipos de datos y la compatibilidad con el proveedor. Para obtener más información acerca del conjunto de filas del esquema PROPERTIES, vea Conjunto de filas MDSCHEMA_PROPERTIES.
De forma predeterminada, si no se usa la palabra clave CELL PROPERTIES, las propiedades de celda devueltas son VALUE, FORMATTED_VALUE y CELL_ORDINAL (en este orden). Si se usa la palabra clave CELL PROPERTIES, se devuelven únicamente las propiedades de celda especificadas explícitamente con la palabra clave.
En el siguiente ejemplo se muestra el uso de la palabra clave CELL PROPERTIES en una consulta 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
No se devuelven las propiedades de celda de consultas MDX que devuelven conjuntos de filas sin información de estructura jerárquica; en este caso, cada celda se representa como si solo se hubiese devuelto la propiedad de celda FORMATTED_VALUE.
Establecer las propiedades de celda
Las propiedades de la celda se pueden establecer en Microsoft SQL Server Analysis Services en varios lugares. Por ejemplo, la propiedad Format String puede establecerse para las medidas normales en la pestaña Estructura de cubo del Editor de cubos en BI Development Studio; la misma propiedad puede establecerse para las medidas calculadas definidas en el cubo en la pestaña Cálculos del Editor de cubos; la cadena de formato de las medidas calculadas definidas en la cláusula WITH de una consulta también se definen allí. La siguiente consulta muestra cómo se pueden establecer las propiedades de la celda en una medida calculada:
WITH MEMBER MEASURES.CELLPROPERTYDEMO AS [Measures].[Internet Sales Amount]
, FORE_COLOR=RGB(0,0,255)
, BACK_COLOR=IIF([Measures].[Internet Sales Amount]>7000000, RGB(255,0,0), RGB(0,255,0))
, FONT_SIZE=10
, FORMAT_STRING='#,#.000'
SELECT MEASURES.CELLPROPERTYDEMO ON 0,
[Date].[Calendar Year].[Calendar Year].MEMBERS ON 1
FROM [Adventure Works]
CELL PROPERTIES VALUE, FORMATTED_VALUE, FORE_COLOR, BACK_COLOR, FONT_SIZE