Bagikan melalui


Bahasa Definisi Laporan (SSRS)

Report Definition Language (RDL) adalah representasi XML dari definisi laporan SQL Server Reporting Services (SSRS). 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 menyesuaikan fungsi untuk mengontrol nilai item laporan, gaya, dan pemformatan dengan mengakses rakitan kode dalam file definisi laporan.

RDL mempromosikan interoperabilitas produk pelaporan komersial dengan menentukan skema umum yang memungkinkan pertukaran definisi laporan. RDL adalah:

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

Prasyarat

Protokol atau antarmuka terprogram apa pun yang berfungsi dengan XML dapat digunakan dengan RDL.

Spesifikasi RDL

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

Definisi Skema XML RDL

File RDL SSRS 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, yang merupakan jumlah kemunculan yang diizinkan. Elemen bisa sederhana atau kompleks. Elemen sederhana tidak memiliki elemen atau atribut turunan. Elemen kompleks memiliki elemen anak dan dapat memiliki atribut.

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.

RDL XSD tersedia dalam file ReportDefinition.xsd, yang terletak di folder Ekstras pada CD-ROM produk. Ini juga tersedia di server laporan melalui URL berikut: https://servername/reportserver/reportdefinition.xsd.

Membuat RDL

Buat alat dan aplikasi yang menghasilkan RDL berdasarkan skema XML mereka karena sifat RDL yang terbuka dan dapat diperluas.

Reporting Services menyediakan beberapa alat untuk membangun file RDL. Untuk informasi selengkapnya, lihat Alat Reporting Services.

  • Hasilkan RDL dari aplikasi dengan menggunakan kelas Microsoft .NET Framework dari System.Xml namespace layanan dan System.Linq .
  • Gunakan XmlTextWriter untuk menulis RDL. Dengan XmlTextWriter, Anda dapat menghasilkan definisi laporan lengkap dari awal hingga akhir di aplikasi .NET Framework apa pun. Untuk informasi selengkapnya tentang kelas XmlTextWriter dan System.Xml namespace layanan, lihat Panduan Pengembang Microsoft .NET Framework.

Pengembang dapat memperluas RDL dengan menambahkan item laporan kustom dengan properti kustom. Untuk informasi selengkapnya tentang Kueri Terintegrasi Bahasa (LINQ), cari "LINQ ke XML" di Microsoft Developer Network.

Ekstensi file standar untuk file definisi laporan adalah .rdl. Anda dapat mengembangkan file definisi laporan klien, yang memiliki ekstensi .rdlc. Jenis MIME untuk kedua ekstensi adalah teks/xml. Untuk informasi selengkapnya, lihat Laporan Reporting Services (SSRS).

Jenis RDL

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

Tipe 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.
Mengapung 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 dinormalisasi.
Ukuran Elemen ukuran harus berisi angka dengan karakter titik yang digunakan sebagai pemisah desimal opsional. Pendesain untuk unit panjang CSS seperti cm, mm, in, pt, atau pc harus mengikuti angka. Spasi antara angka dan penunjuk bersifat opsional. Untuk informasi selengkapnya, 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