Bahasa Definisi Laporan (SSRS)
Report Definition Language (RDL) adalah representasi XML dari definisi laporan SQL Server Reporting Services. 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 Reporting Services. Anda dapat menambahkan fungsi kustom Anda sendiri untuk mengontrol nilai item laporan, gaya, dan pemformatan dengan mengakses rakitan kode dalam file definisi laporan.
RDL mempromosikan interoperabilitas produk pelaporan komersial dengan mendefinisikan 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 SQL Server Reporting Services 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 anak. Elemen kompleks memang memiliki atribut turunan dan opsional.
Misalnya, skema menyertakan 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: Tipe Data Edisi Kedua.
RDL XSD tersedia dalam file ReportDefinition.xsd, yang terletak di folder Ekstra pada CD-ROM produk. Ini juga tersedia di server laporan melalui URL berikut: https://servername/reportserver/reportdefinition.xsd.
Membuat RDL
Karena sifat RDL yang terbuka dan dapat diperluas, berbagai alat dan aplikasi dapat dibangun yang menghasilkan RDL berdasarkan skema XML-nya.
Reporting Services menyediakan beberapa alat untuk membangun file RDL. Untuk informasi selengkapnya, lihat Alat Reporting Services.
Salah satu cara termampu untuk menghasilkan RDL dari aplikasi adalah dengan menggunakan kelas System.Xml Microsoft .NET Framework 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 Language-Integrated Query (LINQ), cari "LINQ ke XML" di MSDN.
Ekstensi file standar untuk file definisi laporan adalah .rdl. Anda juga dapat mengembangkan file definisi laporan klien, yang memiliki ekstensi .rdlc. Jenis MIME untuk kedua ekstensi adalah teks/xml. Untuk informasi selengkapnya tentang laporan, lihat Laporan Reporting Services (SSRS).
Jenis RDL
Tabel berikut ini 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. |
| Mengambang | 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 .NET Framework Microsoft. |
| Nama | Properti dengan nilai teks string. Nama harus unik dalam namespace dari 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 penentu untuk unit panjang CSS seperti cm, mm, in, pt, atau pc. Spasi antara angka dan penunjuk bersifat opsional. Untuk informasi selengkapnya tentang penentu 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 runtime bahasa umum (CLR) sesuai dengan jenis data RDL.
| Tipe CLR | Tipe Data Terkait |
|---|---|
| Boolean | Boolean |
| DateTime, DateTimeOffset | DateTime |
| Int16, Int32, UInt16, Byte, SByte | Bilangan bulat |
| Single, Double | Mengambang |
| String, Char, GUID, Timespan | Untai |
Lihat juga
Menemukan Versi Skema Definisi Laporan (SSRS)
Menggunakan Rakitan Kustom dengan Laporan
Item Laporan Kustom
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