Udostępnij przez


Element komórka (MDDataSet) (XMLA)

Zawiera informacje o jedną komórka zawarte przez nadrzędny CellData element.

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

Właściwości elementu

Charakterystyka

Description

Typ danych i długość

None

Wartość domyślna

None

Relacja

0-n: Opcjonalne element, który może występować więcej niż jeden raz.

Relacje elementu

Relacja

Element

Elementy nadrzędne

CellData

Elementy podrzędność

Zero lub więcej wartości właściwość komórka lub Błąd

Atrybuty

Attribute

Description

CellOrdinal

Wymagane unsignedInt atrybut. Pozycja porządkowa komórka wewnątrz zestawu danych wielowymiarowych.

Remarks

W obiekcie nadrzędnym root element, Axes element następuje CellData Element kolekcja Cell elementy, które zawierają wartości właściwość dla każdej komórka zwracana do wielowymiarowych danych. The Cell element contains the CellOrdinal atrybut, which indicates the zero-based ordinal position of the komórka within the multidimensional dataset, and one element for each komórka właściwość value associated with the komórka. Każda wartość właściwość komórka w Cell element jest określony przez oddzielne element XML. Wartość właściwość komórka jest to XML element, a nazwa właściwość komórka zgodnie z definicją w CellInfo element nadrzędny element główny, odpowiada to nazwa elementu XML.

Następująca składnia zawiera wartość właściwość komórka:

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

Typ danych wartości właściwość komórek określono tylko dla właściwość komórka VALUE.Typy danych właściwość inne komórka są określane na podstawie definicji właściwość komórka, które są uwzględnione w CellInfo element. Elementy wartości właściwość można wykluczyć, jeśli określono wartość domyślną (dołączając Default element zawarty w definicji właściwość komórka CellInfo element) dla właściwość komórek, lub jeśli nie podano żadnej wartości domyślnej i wartość właściwość komórka jest równa null.

Błędy właściwość komórka

If a cell property cannot be returned due to an error that occurs on the instance of Microsoft SQL Server Analysis Services, such as a calculation error that prevents the value from being returned for a given cell, an Error element replaces the contents of the cell property in question.W poniższym przykładzie XML zawiera błąd właściwość komórka:

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

Obliczanie wartości komórka Ordinal

Odwołanie oś do komórka może być obliczona na podstawie CellOrdinal wartość atrybut. Koncepcyjnie, komórki są numerowane w zestawu danych, tak jakby znajdował się do danych p-wymiarowa tablica, gdzie p jest liczba osi.Komórki są zostały omówione w głównej wiersza zamówienia.

Załóżmy, że kwerendy żąda cztery środków na kolumny i crossjoin dwa stany z czterech kwartałów w wierszach.W wyniku zestawu danych po CellOrdinal Właściwość części wyświetlane tekstem pogrubionym wynik zestaw danych jest w zestawie {9, 10, 11, 13, 14, 15, 17, 18, 19}. Wynika to z zestaw komórek są numerowane w kolejności wierszy głównych, począwszy od CellOrdinal 0 dla górną lewą komórka.

Stan

Kwartał

Jednostki sprzedaży

Koszt magazynu

Sprzedaż z magazynu

Licznik sprzedaży

Kalifornia

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

Wzoru pokazano na rysunku oś k = 0 ma pl = 4 członków i oś k = 1 ma pl = 8 krotek.P = 2 jest całkowita liczba osi w kwerendzie.komórka, która jest {Kalifornia III kw., koszt Sklepu} jako S0, Suma początkowa jest i = 0 lub 1.Aby I = 0, spójna kolekcja porządkowa na oś 0 {magazynu koszt} wynosi 1.Aby I = 1, liczba porządkowa spójnej kolekcji {urzędu certyfikacji, Q3} wynosi 2.

Dla I = 0, Ei = 1, tak aby I = 0 suma wynosi 1 * 1 = 1 i I = 1, suma wynosi 2 (liczba porządkowa spójna kolekcja), godziny (wartość Ei obliczana jako 1 * 4) 4 lub 8.Suma 1 + 8 jest 9 komórka porządkowa dla tej komórka.

Example

Poniższy przykład ilustruje strukturę Cell element, włączając w to wartość, FORMATTED_VALUE i FORMAT_STRING komórek, wartości właściwość dla każdej z komórek.

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