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 de los elementos

Característica	Descripción
Tipo y longitud de los datos	Ninguno
Valor predeterminado	Ninguno
Cardinalidad	0-n: Elemento opcional que puede tener lugar más de una vez.

Relaciones del elemento

Relación	Elemento
Elementos primarios	CellData
Elementos secundarios	Cero o más valores de propiedad de la celda, o Error

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 solamente 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 MicrosoftSQL ServerAnalysis 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>

Vea también

Referencia

Tipo de datos MDDataSet Data (XMLA)

Conceptos

Properties (XMLA)