Mengekspor laporan paginasi ke XML (Pembuat Laporan)
Berlaku untuk:
Microsoft Report Builder (SSRS) Power BI Report Builder Perancang Laporan di SQL Server Data Tools
Ekstensi penyajian XML mengembalikan laporan paginated dalam format XML. Skema untuk XML laporan khusus untuk laporan, dan hanya berisi data. Ekstensi penyajian XML tidak merender informasi tata letak dan tidak mempertahankan penomoran halaman. XML yang dihasilkan oleh ekstensi ini dapat diimpor ke dalam database, digunakan sebagai pesan data XML, atau dikirim ke aplikasi kustom.
Catatan
Anda dapat membuat dan memodifikasi file definisi laporan yang dipaginasi (.rdl) di Microsoft Report Builder, Power BI Report Builder, dan di Perancang Laporan di SQL Server Data Tools.
Item Laporan
Tabel berikut ini menjelaskan bagaimana item laporan dirender.
| Item | Perilaku penyajian |
|---|---|
| Laporan | Merender sebagai elemen tingkat atas dokumen XML. |
| Wilayah data | Merender sebagai elemen dalam elemen untuk kontainernya. Wilayah data mencakup tabel, matriks, dan daftar yang menampilkan data sebagai teks dan bagan, bilah data, grafik mini, pengukur, dan indikator yang memvisualisasikan data. |
| Bagian grup dan detail | Setiap instans dirender sebagai elemen dalam elemen untuk kontainernya. |
| Kotak teks | Merender sebagai atribut atau elemen dalam kontainernya. |
| Persegi | Merender sebagai elemen dalam kontainernya. |
| Grup kolom matriks | Merender sebagai elemen dalam grup baris. |
| Peta | Merender sebagai elemen dalam elemen untuk kontainernya. Lapisan peta adalah elemen anak dari peta dan setiap lapisan peta mencakup elemen untuk anggota peta dan atribut anggota peta mereka. |
| Grafik | Merender sebagai elemen dalam elemen untuk kontainernya. Seri adalah elemen turunan dari bagan, dan kategori adalah elemen turunan dari seri. Merender semua label bagan untuk setiap nilai bagan. Label dan nilai disertakan sebagai atribut. |
| Bilah data | Merender sebagai elemen dalam elemen untuk kontainernya, mirip dengan bagan. Biasanya, bilah data tidak menyertakan hierarki atau label, hanya nilai. |
| Grafik mini | Merender sebagai elemen dalam elemen untuk kontainernya, mirip dengan bagan. Biasanya, grafik mini tidak menyertakan hierarki atau label, hanya nilai. |
| Pengukur | Merender sebagai elemen dalam elemen untuk kontainernya. Merender sebagai elemen tunggal dengan nilai minimum dan maksimum skala, nilai awal dan akhir rentang, dan nilai pointer sebagai atribut. |
| Indikator | Merender sebagai elemen dalam elemen untuk kontainernya, mirip dengan pengukur. Merender sebagai elemen tunggal dengan nama status aktif, status yang tersedia, dan nilai data sebagai atribut. |
Laporan yang dirender menggunakan ekstensi penyajian XML juga mengikuti aturan berikut:
Elemen dan atribut XML dirender dalam urutan yang muncul dalam definisi laporan.
Penomoran halaman diabaikan.
Header dan footer halaman tidak dirender.
Item tersembunyi yang tidak dapat dibuat terlihat dengan beralih tidak dirender. Item yang awalnya terlihat dan item tersembunyi yang dapat dibuat terlihat melalui pengalih dirender.
Gambar, baris, dan item laporan kustom diabaikan.
Jenis data
Elemen atau atribut kotak teks diberi tipe data XSD berdasarkan nilai yang ditampilkan kotak teks.
| Jika semua nilai kotak teks adalah | Jenis data yang ditetapkan adalah |
|---|---|
| Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte | xsd:integer |
| Desimal (atau Desimal dan tipe data bilangan bulat atau byte apa pun) | xsd:desimal |
| Float (atau Desimal dan tipe data bilangan bulat atau byte apa pun) | xsd:float |
| Ganda (atau Desimal dan tipe data bilangan bulat atau byte apa pun) | xsd:double |
| Offset DateTime atau DateTime | xsd:dateTime |
| Waktu | xsd:string |
| Boolean | xsd:boolean |
| String, Karakter | xsd:string |
| Lainnya | xsd:string |
Aturan penyajian KHUSUS XML
Bagian berikut menjelaskan bagaimana ekstensi penyajian XML menginterpretasikan item dalam laporan.
Isi laporan
Laporan dirender sebagai elemen akar dokumen XML. Nama elemen berasal dari properti yang DataElementName diatur di panel Properti .
Definisi namespace XML dan atribut referensi skema juga disertakan dalam elemen laporan. Variabel dicatat dalam <>:
<<Report> xmlns="<SchemaName>" xmlns:xsi="<http://www.w3.org/2001/XMLSchema-instance>" xsi:<schemaLocation>="<SchemaNameReportURL>&rc%3aSchema=true" Name="ReportName">
Nilai untuk variabel adalah sebagai berikut:
| Nama | Nilai |
|---|---|
| Laporan | Report.DataElementName |
| ReportURL | URL absolut URLEncoded ke laporan di server. |
| Nama Skema | Report.SchemaName. Jika null, maka Report.Name. Jika Report.Name digunakan, nilai pertama-tama dikodekan dengan XmlConvert.EncodeLocalName. |
| ReportName | Nama laporannya. |
Kotak teks
Kotak teks dirender sebagai elemen atau atribut sesuai dengan DataElementStyle properti RDL. Nama elemen atau atribut berasal dari TextBox.DataElementName properti RDL.
Bagan, bilah data, dan grafik mini
Bagan, bilah data, dan grafik mini dirender dalam XML. Data disusun.
Pengukur dan indikator
Pengukur dan indikator dirender dalam XML. Data disusun.
Sublaporan
Sublaporan dirender sebagai elemen. Nama elemen diambil dari DataElementName properti RDL. Pengaturan TextBoxesAsElements properti laporan mengambil alih sublaporan. Atribut Namespace dan XSLT tidak ditambahkan ke elemen sublaporan.
Persegi panjang
Persegi dirender sebagai elemen. Nama elemen diambil dari properti DataElementName RDL.
Item laporan kustom
CustomReportItems (CRI) tidak terlihat oleh ekstensi penyajian. Jika item laporan kustom ada dalam laporan, ekstensi penyajian merendernya sebagai item laporan konvensional.
Gambar
Gambar tidak dirender.
Garis
Garis tidak dirender.
Tabel, matriks, dan daftar
Tabel, matriks, dan daftar, dirender sebagai elemen. Nama elemen berasal dari properti Tablix DataElementName RDL.
Baris dan kolom
Kolom dirender dalam baris.
Sudut tablix
Sudut tidak dirender. Hanya konten sudut yang dirender.
Sel tablix
Sel tablix dirender sebagai elemen. Nama elemen diambil dari properti RDL sel DataElementName .
Subtotal otomatis
Subtotal otomatis tablix tidak dirender.
Item baris dan kolom yang tidak diulang dengan grup
Item yang tidak diulang dengan grup, seperti label, subtotal, dan total, dirender sebagai elemen. Nama elemen berasal dari TablixMember.DataElementName properti RDL.
Properti TablixMember.DataElementOutput RDL mengontrol apakah item yang tidak direpeat dirender.
DataElementName Jika properti anggota Tablix tidak disediakan, nama untuk item nonrepeating dihasilkan secara dinamis dalam formulir ini:
RowX: Untuk baris yang tidak dipesan, di mana X adalah indeks baris berbasis nol dalam induk saat ini.
ColumnY: Untuk kolom nonrepeating, di mana Y ix indeks kolom berbasis nol dalam induk saat ini.
Header yang tidak berulang dirender sebagai anak dari baris atau kolom yang tidak diulang dengan grup.
Jika anggota nonrepeating tidak memiliki sel Tablix yang sesuai, itu tidak dirender. Hasil ini mungkin terjadi jika sel Tablix yang mencakup lebih dari satu kolom.
Baris dan kolom yang berulang dengan grup
Baris dan kolom yang diulang dalam grup dirender sesuai dengan Tablix.DataElementOutput aturan. Nama untuk elemen diambil dari DataElementName properti .
Setiap nilai unik dalam grup dirender sebagai elemen turunan dari grup. Nama untuk elemen diambil dari Group.DataElementName properti .
DataElementOutput Jika nilai properti sama dengan Output, header item berulang dirender sebagai turunan dari elemen detail.
Format kustom dan transformasi XSL
File XML yang dihasilkan oleh ekstensi penyajian XML dapat diubah menjadi hampir semua format menggunakan Transformasi XSL (XSLT). Fungsionalitas ini dapat digunakan untuk menghasilkan data dalam format yang belum didukung oleh ekstensi penyajian yang ada. Pertimbangkan untuk menggunakan ekstensi penyajian XML dan XSLT sebelum mencoba membuat ekstensi rendering Anda sendiri.
Nama duplikat
Jika ada nama elemen data duplikat dalam cakupan yang sama, perender akan menampilkan pesan kesalahan.
Transformasi XSLT
Perender XML dapat menerapkan transformasi XSLT sisi server ke data XML asli. Saat XSLT diterapkan, perender menghasilkan konten yang diubah alih-alih data XML asli. Transformasi terjadi pada server, bukan pada klien.
XSLT untuk diterapkan ke output didefinisikan baik dalam file definisi laporan dengan DataTransform properti laporan. Atau, dapat ditentukan dengan parameter XSLT DeviceInfo .
Jika salah satu nilai ini diatur, transformasi terjadi setiap kali perender XML digunakan. Saat Anda menggunakan langganan, XSLT harus ditentukan dalam properti RDL DataTransform .
Jika file XSLT ditentukan, oleh DataTransform properti definisi dan pengaturan informasi perangkat, XSLT yang ditentukan DataTransform terjadi terlebih dahulu, diikuti oleh XSLT yang ditetapkan oleh pengaturan informasi perangkat.
Pengaturan Informasi Perangkat
Anda dapat mengubah beberapa pengaturan default untuk perender ini dengan mengubah pengaturan informasi perangkat, termasuk pengaturan berikut:
Transformasi (XSLT) untuk diterapkan ke XML.
Jenis MIME dokumen XML.
Apakah akan menerapkan string format ke data.
Apakah akan mengindentasi output XML.
Apakah akan menyertakan nama skema XML.
Pengodean untuk dokumen XML.
Ekstensi file dokumen XML.
Untuk informasi selengkapnya, lihat Pengaturan informasi perangkat XML.
Konten terkait
- Penomoran halaman di Reporting Services (Report Builder dan SSRS)
- Perilaku perender (Pembuat Laporan dan SSRS)
- Fungsionalitas interaktif untuk ekstensi penyajian laporan yang berbeda (Report Builder dan SSRS)
- Merender item laporan (Pembuat Laporan dan SSRS)
- Tabel, matriks, dan daftar (Pembuat Laporan dan SSRS)
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk