Bagikan melalui

Elemen Sel (MDDataSet) (XMLA)

Berisi informasi tentang satu sel yang terkandung oleh elemen CellData induk.

Sintaks

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

Karakteristik elemen

Karakteristik Deskripsi
Tipe dan panjang data Tidak ada
Nilai default Tidak ada
Kardinalitas 0-n: Elemen opsional yang dapat terjadi lebih dari sekali.

Hubungan elemen

Hubungan Elemen
Elemen induk Data Sel
Elemen anak Nol atau lebih nilai properti sel atau Kesalahan

Atribut

Atribut Deskripsi
SelOrdinal Atribut UnsignedInt yang diperlukan. Posisi ordinal sel dalam dataset multidimensi.

Keterangan

Dalam elemen root induk, elemen Sumbu diikuti oleh elemen CellData , kumpulan elemen Sel yang berisi nilai properti untuk setiap sel yang dikembalikan dalam himpunan data multidimensi. Elemen Sel berisi atribut CellOrdinal , yang menunjukkan posisi ordinal berbasis nol dari sel dalam himpunan data multidimensi, dan satu elemen untuk setiap nilai properti sel yang terkait dengan sel. Setiap nilai properti sel dalam elemen Sel ditentukan oleh elemen XML terpisah. Nilai properti sel adalah data yang terkandung oleh elemen XML, dan nama properti sel, seperti yang didefinisikan dalam elemen CellInfo dari elemen root induk, sesuai dengan nama elemen XML.

Sintaks berikut menguraikan nilai properti sel:

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

Tipe data nilai properti sel ditentukan hanya untuk properti sel VALUE. Tipe data properti sel lainnya ditentukan oleh definisi properti sel yang termasuk dalam elemen CellInfo . Elemen nilai properti sel dapat dikecualikan jika nilai default telah ditentukan (dengan menyertakan elemen Default untuk definisi properti sel yang terdapat dalam elemen CellInfo ) untuk properti sel, atau jika tidak ada nilai default yang ditentukan dan nilai properti sel adalah null.

Kesalahan Properti Sel

Jika properti sel tidak dapat dikembalikan karena kesalahan yang terjadi pada instans Analysis Services, seperti kesalahan perhitungan yang mencegah nilai dikembalikan untuk sel tertentu, elemen Error menggantikan konten properti sel yang dimaksud. Contoh XML berikut menjelaskan kesalahan properti sel:

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

Menghitung Nilai Ordinal Sel

Referensi sumbu untuk sel dapat dihitung berdasarkan nilai atribut CellOrdinal . Secara konseptual, sel diberi nomor dalam dataset seolah-olah dataset adalah array p-dimensi, di mana p adalah jumlah sumbu. Sel ditangani dalam urutan baris-mayor.

Misalkan kueri meminta empat ukuran pada kolom dan persilangan dua status dengan empat perempat baris. Dalam mengikuti hasil himpunan data, properti CellOrdinal untuk bagian hasil himpunan data yang ditampilkan dalam teks tebal adalah himpunan {9, 10, 11, 13, 14, 15, 17, 18, 19}. Ini adalah himpunan karena sel diberi nomor dalam urutan baris-mayor, dimulai dengan CellOrdinal 0 untuk sel kiri atas.

Provinsi Kuartal Penjualan unit Biaya toko Penjualan toko Jumlah penjualan
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

Menerapkan rumus yang ditunjukkan pada gambar, sumbu k = 0 memiliki Uk = 4 anggota, dan sumbu k = 1 memiliki Uk = 8 tuples. P = 2 adalah jumlah total sumbu dalam kueri. Mengambil sel yang {California, Q3, Store Cost} sebagai S0, penjumlahan awal adalah i = 0 hingga 1. Untuk i = 0, tuple ordinal pada sumbu 0 {Store Cost} adalah 1. Untuk i = 1, ordinal tuple {CA, Q3} adalah 2.

Untuk i = 0, Ei = 1, jadi untuk i = 0 jumlahnya adalah 1 * 1 = 1 dan untuk i = 1, jumlahnya adalah 2 (tuple ordinal) kali 4 (nilai Ei dihitung sebagai 1 * 4), atau 8. Jumlah 1 + 8 kemudian 9, ordinal sel untuk sel itu.

Contoh

Contoh berikut menunjukkan struktur elemen Sel , termasuk nilai NILAI, FORMATTED_VALUE, dan FORMAT_STRING nilai properti sel untuk setiap sel.

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