Freigeben über


Cell-Element (MDDataSet) (XMLA)

Enthält Informationen über eine einzelne Zelle, die in einem übergeordneten CellData-Element enthalten ist.

Syntax

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

Elementmerkmale

Merkmal

Beschreibung

Datentyp und -länge

Keine

Standardwert

Keine

Kardinalität

0-n: Optionales Element, das mehr als einmal auftreten kann.

Elementbeziehungen

Beziehung

Element

Übergeordnete Elemente

CellData

Untergeordnete Elemente

Null oder mehr Zelleneigenschaftswerte oder Error

Attribute

Attribut

Beschreibung

CellOrdinal

Erforderliches unsignedInt-Attribut. Die Ordnungsposition der Zelle innerhalb des mehrdimensionalen Datasets.

Hinweise

Im übergeordneten root-Element folgt auf das Axes-Element das CellData-Element, eine Auflistung von Cell-Elementen, die die Zelleneigenschaftswerte für jede im mehrdimensionalen Dataset verwendete Zelle enthalten. Das Cell-Element enthält das CellOrdinal-Attribut, das die nullbasierte Ordnungszahl der Zelle innerhalb des mehrdimensionalen Datasets angibt, und ein Element für jeden Zelleneigenschaftswert, der der Zelle zugeordnet ist. Jeder Zelleneigenschaftswert im Cell-Element wird durch ein separates XML-Element definiert. Der Wert der Zelleneigenschaft entspricht den Daten, die im XML-Element enthalten sind, und der Name der Zelleneigenschaft (laut Definition im CellInfo-Element des übergeordneten Stammelements) entspricht dem Namen des XML-Elements.

Die folgende Syntax beschreibt einen Zelleneigenschaftswert:

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

Der Datentyp eines Zelleneigenschaftswerts wird nur für die VALUE-Zelleneigenschaft angegeben. Die Datentypen anderer Zelleneigenschaften werden durch die Zelleneigenschaftsdefinition im CellInfo-Element bestimmt. Ein Zelleneigenschaftswert kann ausgeschlossen werden, wenn ein Standardwert für eine Zelleneigenschaft angegeben wurde (durch Einschluss eines Default-Elements als Zelleneigenschaftsdefinition, die im CellInfo-Element enthalten ist) oder wenn kein Standardwert angegeben wurde und der Wert der Zelleneigenschaft Null ist.

Zelleneigenschaftsfehler

Wenn aufgrund eines Fehlers, der auf der Instanz von MicrosoftSQL ServerAnalysis Services auftritt (z. B. ein Berechnungsfehler, der eine Rückgabe des Werts für eine bestimmte Zelle verhindert) keine Zelleneigenschaft zurückgegeben werden kann, ersetzt ein Error-Element die Inhalte der fraglichen Zelleneigenschaft. Das folgende XML-Beispiel beschreibt einen Zelleneigenschaftsfehler:

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

Berechnen der Ordinalwerte der Zelle

Der Achsenverweis für eine Zelle kann auf Grundlage eines CellOrdinal-Attributwerts berechnet werden. Konzeptionell werden die Zellen in einem Dataset so nummeriert, als ob das Dataset ein p-dimensionales Array wäre, wobei p für die Anzahl der Achsen steht. Die Zellen werden in zeilengerichteter Reihenfolge adressiert.

Hier wird angenommen, dass eine Anfrage vier Measures auf den Spalten und einen Crossjoin mit zwei Status mit vier Quartalen auf den Zeilen anfordert. Im Folgenden Dataset-Ergebnis ist die CellOrdinal-Eigenschaft des Datasetergebnisses, die fett gedruckt ist, der Satz {9, 10, 11, 13, 14, 15, 17, 18, 19}. Dies ist der Satz, da die Zellen in zeilengerichteter Reihenfolge nummeriert sind (Anfang mit einer CellOrdinal von 0 für die Zelle links oben).

Status

Quartal

Unit Sales

Speicherkosten

Store-Sales

Verkaufszahlen

Kalifornien

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

Wenn die in der Abbildung gezeigte Formel angewendet wird, hat die Achse k = 0 Uk = 4 Elemente und die Achse k = 1 Uk = 8 Tupel. P = 2 ist die Gesamtzahl der Achsen in der Abfrage. Wenn man die Zelle mit dem Inhalt {Kalifornien, Q3, Speicherkosten} als S0 nimmt, ist die ursprüngliche Summe i = 0 bis 1. Für i = 0 ist die Tupelordinalzahl auf Achse 0 auf {Speicherkosten} 1. Für i = 1 ist die Tupelordinalzahl von {CA, Q3} 2.

Für i = 0 Ei = 1, daher ist die Summe für i = 0 gleich 1 * 1 = 1, und die Summe für i = 1 ist 2 (Tupelordinalzahl) mal 4 (der Wert von Ei berechnet als 1 * 4) oder 8. Die Summe von 1 + 8 ist dann 9, die Zellenordinalzahl für diese Zelle.

Beispiel

Das folgende Beispiel zeigt daher die Struktur des Cell-Elements, einschließlich der VALUE-, FORMATTED_VALUE- und FORMAT_STRING-Zelleneigenschaftswerte jeder Zelle.

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

Siehe auch

Verweis

Konzepte