Elemento Cell (MDDataSet) (XMLA)
Contiene información sobre una celda única que se encuentra en un elemento CellData primario.
Sintaxis
<CellData>
<Cell CellOrdinal="unsignedInt">
<!-- Zero or more cell property values -->
<!-- or -->
<Error>...</Error>
</Cell>
</CellData>
Características del elemento
Característica |
Descripción |
|---|---|
Tipo y longitud de los datos |
Ninguno |
Valor predeterminado |
Ninguno |
Cardinalidad |
0-n: Elemento opcional que puede aparecer más de una vez. |
Relaciones del elemento
Atributos
Attribute |
Descripción |
|---|---|
CellOrdinal |
Atributo unsignedInt requerido. Posición ordinal de la celda dentro del conjunto de datos multidimensional. |
Comentarios
En el elemento root primario, el elemento Axes va seguido del elemento CellData, una colección de elementos Cell que contienen los valores de propiedad para cada celda devuelta en un conjunto de datos multidimensional. El elemento Cell contiene el atributo CellOrdinal, que indica la posición ordinal basada en cero de la celda dentro del conjunto de datos multidimensional, y un elemento para cada valor de propiedad de la celda asociado a la celda. Un elemento XML independiente define cada valor de propiedad de la celda en el elemento Cell. El valor de la propiedad de la celda es los datos que se encuentran en el elemento XML; el nombre de la propiedad de la celda, definido en el elemento CellInfo del elemento raíz primario, corresponde al nombre del elemento XML.
La sintaxis siguiente describe un valor de propiedad de la celda:
<CellProperty xsi:type="string">value</CellProperty>
El tipo de datos de un valor de propiedad de celda sólo se especifica para la propiedad de celda VALUE. La definición de la propiedad de la celda incluida en el elemento CellInfo determina los tipos de datos de las demás propiedades de la celda. Se puede excluir un elemento de valor de propiedad de celda si se ha especificado un valor predeterminado (mediante la inclusión de un elemento Default para una definición de propiedad de celda contenida en el elemento CellInfo) para una propiedad de celda, o si no se ha especificado ningún valor predeterminado y el valor de la propiedad de celda es nulo.
Errores de propiedades de celda
Si no se puede devolver una propiedad de celda debido a un error que produce en la instancia de Microsoft SQL Server Analysis Services, por ejemplo un error de cálculo que impide que se devuelva el valor para una celda determinada, un elemento Error reemplaza el contenido de la propiedad de la celda en cuestión. El ejemplo de XML siguiente describe un error de propiedad de celda:
<Cell CellOrdinal="0">
<Value xsi:type="xsd:double">
<Error>
<ErrorCode>2148497527</ErrorCode>
<Description>Unknown error</Description>
</Error>
</Value>
</Cell>
Calcular los valores ordinales de celdas
La referencia de eje de una celda se puede calcular en función de un valor de atributo CellOrdinal. Conceptualmente, las celdas se numeran en un conjunto de datos como si el conjunto de datos fuera una matriz con p dimensiones, donde p es el número de ejes. Las celdas se ordenan por importancia de fila.
Suponga que una consulta solicita cuatro medidas en las columnas y una combinación cruzada de dos estados con cuatro trimestres en las filas. En el siguiente resultado de conjunto de datos, la propiedad CellOrdinal para la parte del resultado del conjunto de datos mostrada en negrita es el conjunto {9, 10, 11, 13, 14, 15, 17, 18, 19}. Éste es el conjunto porque las celdas se numeran en orden de importancia de fila, iniciándose con un CellOrdinal de 0 para la celda superior izquierda.
Estado |
Quarter |
Unit sales |
Store cost |
Store sales |
Sales count |
|---|---|---|---|---|---|
California |
Q1 |
16890 |
14431.09 |
36175.2 |
5498 |
|
Q2 |
18052 |
15332.02 |
38396.75 |
5915 |
|
Q3 |
18370 |
15672.83 |
39394.05 |
6014 |
|
Q4 |
21436 |
18094.5 |
45201.84 |
7015 |
Oregon |
Q1 |
19287 |
16081.07 |
40170.29 |
6184 |
|
Q2 |
15079 |
12678.96 |
31772.88 |
4799 |
|
Q3 |
16940 |
14273.78 |
35880.46 |
5432 |
|
Q4 |
16353 |
13738.68 |
34453.44 |
5196 |
Washington |
Q1 |
30114 |
25240.08 |
63282.86 |
9906 |
|
Q2 |
29479 |
24953.25 |
62496.64 |
9654 |
|
Q3 |
30538 |
25958.26 |
64997.38 |
10007 |
|
Q4 |
34235 |
29172.72 |
73016.34 |
11217 |
Si se aplica la fórmula de la figura, el eje k = 0 tiene Uk = 4 miembros, y el eje k = 1 tiene Uk = 8 tuplas. P = 2 es el número total de ejes de la consulta. Si se toma la celda que es {California, Q3, Store Cost} como S0, la suma inicial es i = 0 a 1. Para i = 0, la tupla ordinal del eje 0 de {Store Cost} es 1. Para i = 1, la tupla ordinal de {CA, Q3} es 2.
Para i = 0, Ei = 1, por lo que para i = 0 la suma es 1 * 1 = 1 y para i = 1, la suma es 2 (ordinal de la tupla) por 4 (el valor de Ei calculado como 1 * 4), o 8. La suma de 1 + 8 es 9, el ordinal de celda de esa celda.
Ejemplo
El ejemplo siguiente muestra la estructura del elemento Cell, con los valores de propiedad de celda VALUE, FORMATTED_VALUE y FORMAT_STRING para cada celda.
<CellData>
<Cell CellOrdinal="0">
<Value xsi:type="xsd:double">16890</Value>
<FmtValue>16,890.00</FmtValue>
<FormatString>Standard</FormatString>
</Cell>
<Cell CellOrdinal="1">
<Value xsi:type="xsd:int">50</Value>
<FmtValue>50</FmtValue>
<FormatString>Standard</FormatString>
</Cell>
<Cell CellOrdinal="2">
<Value xsi:type="xsd:double">36175.2</Value>
<FmtValue>$36,175.20</FmtValue>
<FormatString>Currency</FormatString>
</Cell>
</CellData>