Bagikan melalui

Bahasa Definisi Laporan (RDL)

  • Artikel

BERLAKU UNTUK: Power BI Report Builder Power BI Desktop

Report Definition Language (RDL) adalah representasi XML dari definisi laporan paginated. Definisi laporan berisi informasi pengambilan data dan tata letak untuk laporan. RDL terdiri dari elemen XML yang cocok dengan tata bahasa XML yang dibuat untuk Power BI. Anda dapat menambahkan fungsi kustom Anda sendiri untuk mengontrol nilai item laporan, gaya, dan pemformatan dengan mengakses blok kode dalam file definisi laporan.

RDL mempromosikan interoperabilitas produk pelaporan komersial dengan menentukan skema umum yang memungkinkan pertukaran definisi laporan. Protokol atau antarmuka terprogram apa pun yang berfungsi dengan XML dapat digunakan dengan RDL. RDL adalah:

  • Skema XML untuk definisi laporan.
  • Format pertukaran untuk bisnis dan pihak ketiga.
  • Skema yang dapat diperluas dan terbuka yang mendukung namespace tambahan dan elemen kustom.

Spesifikasi RDL

Untuk mengunduh spesifikasi untuk versi skema tertentu, lihat Spesifikasi Bahasa Definisi Laporan.

Definisi skema XML RDL

File Report Definition Language (RDL) divalidasi dengan menggunakan file Definisi Skema XML (XSD). Skema menentukan aturan di mana elemen RDL dapat terjadi dalam file .rdl. Elemen mencakup jenis data dan kardinalitasnya, yaitu jumlah kemunculan yang diizinkan. Elemen bisa sederhana atau kompleks. Elemen sederhana tidak memiliki elemen atau atribut turunan. Elemen kompleks memang memiliki atribut turunan dan opsional.

Misalnya, skema mencakup elemen RDL ReportParameters, yang merupakan jenis kompleks ReportParametersType. Menurut konvensi, jenis kompleks untuk elemen adalah nama elemen yang diikuti dengan jenis kata. Elemen ReportParameters dapat dimuat oleh elemen Laporan (jenis kompleks), dan dapat berisi elemen ReportParameter. ReportParameterType adalah jenis sederhana yang hanya bisa menjadi salah satu nilai berikut: Boolean, DateTime, Integer, Float, atau String. Untuk informasi selengkapnya tentang jenis data Skema XML, lihat Skema XML Bagian 2: Datatypes Edisi Kedua.

Membuat RDL

Karena sifat RDL yang terbuka dan dapat diperluas, berbagai alat dan aplikasi dapat dibangun yang menghasilkan RDL berdasarkan skema XML-nya.

Power BI Report Builder adalah cara yang lebih disukai untuk menulis laporan paginasi berbasis RDL.

Salah satu cara term mudah untuk menghasilkan RDL dari aplikasi adalah dengan menggunakan kelas Microsoft .NET Framework dari System.Xml namespace layanan dan System.Linq namespace layanan. Satu kelas khususnya , kelas XmlTextWriter , dapat digunakan untuk menulis RDL. Dengan XmlTextWriter, Anda dapat menghasilkan definisi laporan lengkap dari awal hingga akhir di aplikasi .NET Framework apa pun. Pengembang juga dapat memperluas RDL dengan menambahkan item laporan kustom dengan properti kustom. Untuk informasi selengkapnya tentang kelas XmlTextWriter dan System.Xml namespace layanan, lihat Panduan Pengembang Microsoft .NET Framework. Untuk informasi selengkapnya tentang Kueri Terintegrasi Bahasa (LINQ), cari "LINQ ke XML" di MSDN.

Ekstensi file standar untuk file definisi laporan adalah .rdl. Jenis MIME adalah teks/xml.

Jenis RDL

Tabel berikut mencantumkan jenis yang digunakan dalam elemen dan atribut RDL.

Jenis Deskripsi
Biner Properti dengan nilai biner yang dikodekan base-64.
Boolean Properti dengan true atau false sebagai nilai objek. Kecuali ditentukan sebaliknya, nilai objek Boolean opsional yang dihilangkan adalah False.
Tanggal Properti dengan nilai tanggal atau tanggalwaktu yang ditentukan sepenuhnya yang ditentukan dalam format tanggal ISO8601: YYYY-MM-DD[THH:MM[:SS[. S]]].
Enum Properti dengan nilai teks string yang harus menjadi salah satu daftar nilai yang ditunjuk.
Float Properti dengan nilai float. Titik (.) digunakan sebagai pemisah desimal opsional.
Bilangan bulat Properti dengan nilai bilangan bulat (int32).
Bahasa Properti dengan nilai teks yang berisi kode bahasa dan budaya, seperti "en-us" untuk bahasa Inggris AS. Nilai harus berupa bahasa tertentu atau bahasa netral yang bahasa defaultnya ditentukan dalam Microsoft .NET Framework.
Nama Properti dengan nilai teks string. Nama harus unik dalam namespace item. Jika tidak ditentukan, namespace untuk item adalah yang paling dalam berisi objek yang memiliki nama.
NormalizedString Properti dengan nilai teks string yang telah dinormalisasi.
Ukuran Elemen ukuran harus berisi angka (dengan karakter titik yang digunakan sebagai pemisah desimal opsional). Angka harus diikuti oleh pendesain untuk unit panjang CSS seperti cm, mm, in, pt, atau pc. Spasi antara angka dan penunjuk bersifat opsional. Untuk informasi selengkapnya tentang pendesain ukuran, lihat Referensi Nilai dan Unit CSS.

Dalam RDL, nilai maksimum untuk Ukuran adalah 160 in. Ukuran minimum adalah 0 in.
String Properti dengan nilai teks string.
UnsignedInt Properti dengan nilai bilangan bulat yang tidak ditandatangani (uint32).
Varian Properti dengan jenis XML sederhana apa pun.

Jenis data RDL

Enumerasi DataType menentukan jenis data atribut, ekspresi, atau parameter dalam RDL. Tabel berikut ini memperlihatkan bagaimana jenis data common language runtime (CLR) sesuai dengan jenis data RDL.

Jenis CLR Jenis Data Yang Sesuai
Boolean Boolean
DateTime, DateTimeOffset DateTime
Int16, Int32, UInt16, Byte, SByte Bilangan bulat
Single, Double Float
String, Char, GUID, Timespan String

Konten terkait