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

Tipo di dati MDDataSet (XMLA)

Concetti

Proprietà (XMLA)