Compartilhar via


Elemento Cell (MDDataSet) (XMLA)

Contém informações sobre uma única célula contida por um elemento CellData pai.

Sintaxe

<CellData>
   <Cell CellOrdinal="unsignedInt">
      <!-- Zero or more cell property values -->
      <!-- or -->
      <Error>...</Error>
   </Cell>
</CellData>

Características do elemento

Característica

Descrição

Tipo de dados e comprimento

Nenhum

Valor padrão

Nenhum

Cardinalidade

0-n: elemento opcional que pode ocorrer mais de uma vez.

Relações do elemento

Relação

Elemento

Elementos pai

CellData

Elementos filho

Zero ou mais valores de propriedade de célula ou Erro

Atributos

Atributo

Descrição

CellOrdinal

Atributo unsignedInt obrigatório. A posição ordinal da célula dentro do conjunto de dados multidimensional.

Comentários

No elemento pai root, o elemento Axes é seguido pelo elemento CellData, uma coleção de elementos Cell que contêm os valores de propriedade de cada célula retornada no conjunto de dados multidimensionais. O elemento Cell contém o atributo CellOrdinal, que indica a posição ordinal baseada em zero da célula dentro do conjunto de dados multimensional e um elemento para cada valor de propriedade de célula associado à célula. Cada valor de propriedade de célula no Cell elemento é definido por um elemento XML separado. O valor da propriedade de célula é o dado contido pelo elemento XML, e o nome da propriedade de célula, conforme definido no elemento CellInfo do elemento raiz pai, corresponde ao nome do elemento XML.

A sintaxe a seguir descreve um valor de propriedade de célula.

<CellProperty xsi:type="string">value</CellProperty>

O tipo de dados de um valor de propriedade de célula só é especificado para a propriedade de célula de VALUE. Os tipos de dados de outras propriedades de célula são determinados pela definição de propriedade de célula incluída no elemento CellInfo. Um elemento de valor de propriedade de célula poderá ser excluído se o valor padrão tiver sido especificado (incluindo um elemento Default para uma propriedade de célula contido no elemento CellInfo) para uma propriedade de célula ou se nenhum valor padrão tiver sido especificado e se o valor da propriedade da célula for nulo.

Erros de propriedade de célula

Se uma propriedade de célula não puder ser retornada devido a um erro que ocorre na instância do MicrosoftSQL ServerAnalysis Services, como um erro de cálculo que impede que o valor seja retornado de uma célula específica, um elemento Error substituirá o conteúdo da propriedade dá célula em questão. O exemplo de XML a seguir descreve um erro de propriedade de célula:

<Cell CellOrdinal="0">
   <Value xsi:type="xsd:double">
      <Error>
         <ErrorCode>2148497527</ErrorCode>
         <Description>Unknown error</Description>
      </Error>
   </Value>
</Cell>

Calculando valores ordinais de células

A referência de eixo para uma célula pode ser calculada com base em um valor de atributo CellOrdinal. Conceitualmente, as células são numeradas em um conjunto de dados como se o conjunto de dados fosse uma matriz dimensional p, em que p é o número de eixos. As células são tratadas em ordem linha-principal.

Suponha que uma consulta solicite quatro medidas em colunas e uma interjunção de quatro estados com quatro quartos de linhas. Seguindo o resultado do conjunto de dados, a propriedade CellOrdinal da parte do resultado do conjunto de dados em negrito é o conjunto {9, 10, 11, 13, 14, 15, 17, 18, 19}. Esse é o conjunto, porque as células são numeradas em ordem de linha principal, começando com um CellOrdinal de 0 para a célula superior esquerda.

Estado

Trimestre

Vendas de unidade

Custo na loja

Vendas da loja

Contas de vendas

Califórnia

T1

16890

14431.09

36175.2

5498

 

T2

18052

15332.02

38396.75

5915

 

T3

18370

15672.83

39394.05

6014

 

T4

21436

18094.5

45201.84

7015

Oregon

Q1

19287

16081.07

40170.29

6184

 

Q2

15079

12678.96

31772.88

4799

 

T3

16940

14273.78

35880.46

5432

 

T4

16353

13738.68

34453.44

5196

Washington

T1

30114

25240.08

63282.86

9906

 

T2

29479

24953.25

62496.64

9654

 

T3

30538

25958.26

64997.38

10007

 

T4

34235

29172.72

73016.34

11217

Aplicando a fórmula mostrada na figura, o eixo k = 0 tem Uk = 4 membros e o exio k = 1 tem Uk = 8 tuplas. P = 2 é o número total de eixos na consulta. Considerando a célula {Califórnia, T3, Custo da Loja} como S0, a soma inicial é i = 0 a 1. Para i = 0, a tupla ordinal no eixo 0 de {Custo da loja} é 1. Para i = 1, a tupla ordinal de {CA, T3} é 2.

Para i = 0, Ei = 1, então, para i = 0, a soma é 1 * 1 = 1, e para i = 1, a soma é 2 (tupla ordinal) vezes 4 (o valor de Ei calculado como 1 * 4) ou 8. A soma de 1 + 8 é então 9, a célula ordinal para essa célula.

Exemplo

O exemplo seguinte demonstra a estrutura do elemento Cell, incluindo os valores da propriedade VALUE, FORMATTED_VALUE, and FORMAT_STRING para cada célula.

<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>

Consulte também

Referência

Conceitos