Mengekspor laporan paginasi Power BI ke XML (Power BI Report Builder)
BERLAKU UNTUK: 
Power BI Report Builder 
Power BI Desktop
Ekstensi penyajian XML mengembalikan laporan paginasi Power BI dalam format XML. Skema untuk XML laporan khusus untuk laporan, dan hanya berisi data. Informasi tata letak tidak dirender dan penomoran halaman tidak dikelola oleh ekstensi penyajian XML. 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 mengubah file definisi laporan yang dipaginasi (.rdl) di Power BI Report Builder.
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 DataElementName yang diatur di panel Properti.
Definisi namespace XML dan atribut referensi skema juga disertakan dalam elemen laporan. Variabel dicatat dalam jenis wajah tebal:
<Laporkan 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, pertama-tama dikodekan dengan XmlConvert.EncodeLocalName. |
| ReportName | Nama laporannya. |
Kotak teks
Kotak teks dirender sebagai elemen atau atribut sesuai dengan properti RDL DataElementStyle. Nama elemen atau atribut berasal dari properti TextBox.DataElementName 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 properti DataElementName RDL. Pengaturan properti TextBoxesAsElements dari 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 DataElementName RDL sel.
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 properti TablixMember.DataElementName RDL.
Properti TablixMember.DataElementOutput RDL mengontrol apakah item yang tidak berulang dirender.
Jika properti DataElementName dari anggota Tablix tidak disediakan, nama untuk item yang tidak berulang dibuat secara dinamis dalam formulir ini:
RowX Untuk baris yang tidak berulang, di mana X adalah indeks baris berbasis nol dalam induk saat ini.
ColumnY Untuk kolom yang tidak berulang, 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 yang tidak berulang tidak memiliki sel Tablix yang sesuai, itu tidak dirender. Ini dapat terjadi dalam kasus sel Tablix di mana sel tersebut mencakup lebih dari satu kolom.
Baris dan kolom yang berulang dengan grup
Baris dan kolom yang berulang dalam grup dirender sesuai dengan aturan Tablix.DataElementOutput. Nama untuk elemen diambil dari properti DataElementName.
Setiap nilai unik dalam grup dirender sebagai elemen turunan dari grup. Nama untuk elemen diambil dari properti Group.DataElementName.
Jika nilai properti DataElementOutput 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 properti DataTransform laporan atau dengan parameter XSLT DeviceInfo . Jika salah satu nilai ini diatur, transformasi terjadi setiap kali perender XML digunakan. Saat menggunakan langganan, XSLT harus ditentukan dalam properti RDL DataTransform.
Jika file XSLT ditentukan, oleh properti definisi DataTransform dan pengaturan informasi perangkat, XSLT yang ditentukan dalam DataTransform terjadi terlebih dahulu, diikuti oleh XSLT yang diatur oleh pengaturan informasi perangkat.
File XSLT harus tersedia melalui internet melalui https tanpa memerlukan autentikasi.
Pengaturan informasi perangkat
Anda dapat mengubah beberapa pengaturan default untuk perender ini dengan mengubah pengaturan informasi perangkat, termasuk yang berikut ini:
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 (Power BI Report Builder)
- Perilaku Penyajian (Pembangun Laporan Power BI)
- Fungsionalitas Interaktif untuk Ekstensi Penyajian Laporan yang Berbeda (Power BI Report Builder)
- Menyajikan Item Laporan (Pembangun Laporan Power BI)
- Tabel, Matriks, dan Daftar (Power BI Report Builder)