Condividi tramite


Elemento Cell (MDDataSet) (XMLA)

Contiene informazioni su una sola cella contenuta in un elemento CellData padre.

Sintassi

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

Caratteristiche elemento

Caratteristica

Descrizione

Tipo di dati e lunghezza

Nessuno

Valore predefinito

Nessuno

Cardinalità

0-n: Elemento facoltativo che può presentarsi più di una volta.

Relazioni elemento

Relazione

Elemento

Elementi padre

CellData

Elementi figlio

Zero o più valori della proprietà della cella o Error

Attributi

Attributo

Descrizione

OrdinaleCella

Attributo unsignedInt obbligatorio. La posizione ordinale della cella all'interno del dataset multidimensionale.

Osservazioni

Nell'elemento root padre, l'elemento Axes è seguito dall'elemento CellData, una raccolta di elementi Cell che contengono i valori della proprietà per ogni cella restituito nel dataset multidimensionale. L'elemento Cell contiene l'attributo CellOrdinal che indica la posizione ordinale in base zero della cella all'interno del dataset multidimensionale e un elemento per ogni valore della proprietà della cella associato alla cella stessa. Ogni valore della proprietà della cella nell'elemento Cell è definito da un elemento XML separato. Il valore della proprietà della cella comprende i dati contenuti nell'elemento XML; il nome della proprietà della cella, come definito nell'elemento CellInfo dell'elemento radice padre, corrisponde al nome dell'elemento XML.

Nella sintassi seguente viene descritto un valore della proprietà della cella:

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

Il tipo di dati del valore proprietà della cella viene specificato solo per la proprietà VALORE della cella. I tipi di dati di altre proprietà della cella sono determinati dalla definizione di proprietà della cella inclusa nell'elemento CellInfo. Un elemento del valore della proprietà di cella può essere escluso se un valore predefinito è stato specificato (includendo un elemento Default per una definizione di proprietà della cella contenuta nell'elemento CellInfo ) per una proprietà della cella, o se non è stato specificato alcun valore predefinito e il valore della proprietà della cella è null.

Errori proprietà cella

Se una proprietà della cella non può essere restituita a causa di un errore che si verifica sull'istanza di MicrosoftSQL ServerAnalysis Services, ad esempio un errore di calcolo che impedisce che il valore venga restituito per una cella specificata, un elemento Error sostituisce il contenuto della proprietà della cella in questione. Nell'esempio XML seguente è descritto un errore di proprietà della cella:

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

Calcolo dei valori ordinali di cella

Il riferimento dell'asse per una cella può essere calcolato in base a un valore dell'attributo CellOrdinal. Concettualmente, le celle sono numerate in un dataset se il dataset è una p- matrice dimensionale, dove p è il numero di assi. Le celle sono indirizzate in ordine di riga.

Si suppone che una query richieda quattro misure su colonne e una crossjoin di due stati con quattro trimestri sulle righe. Nel risultato del dataset, la proprietà CellOrdinal per la parte del risultato del dataset mostrata in grassetto è l'insieme {9, 10 11, 13 14, 15 17, 18 19}. L'insieme è di questo tipo perché le celle sono numerate in ordine crescente di riga, iniziando con un CellOrdinal di 0 per la cella più in alto a sinistra.

Stato

Trimestre

Vendite unità

Costo magazzino

Vendite magazzino

Conto vendite

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

Applicando la formula nella figura, l’asse k = 0 ha Uk = 4 membri e l’asse k = 1 ha Uk = 8 tuple P = 2 è il numero complessivo di assi nella query. Prendendo la cella {California, Q3 Archivia Costato} come S0, la sommatoria iniziale è i = 0 a 1. Per i = 0, l'ordinale della tupla su asse 0 di {Costo Magazzino} è 1. Per i = 1, l'ordinale della tupla di {CA, Q3} è 2.

Per i = 0, Ei = 1, pertanto per i = 0 la somma è 1 * 1 = 1 e per i = 1, la somma è 2 (ordinale della tupla) per 4 (il valore di Ei calcolato come 1 * 4) o 8. La somma di 1 + 8 è quindi 9, l'ordinale della cella per quella cella.

Esempio

Nell'esempio seguente viene dimostrata la struttura dell'elemento Cell, inclusi i valori delle proprietà delle celle VALORE, VALORE_FORMATTATO e STRINGA_FORMATO per ogni cella.

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

Vedere anche

Riferimento

Concetti