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