Referensi pengumpulan parameter dalam laporan paginated (Pembuat Laporan)
Berlaku untuk:
Microsoft Report Builder (SSRS) Power BI Report Builder Perancang Laporan di SQL Server Data Tools
Parameter laporan paginated adalah salah satu koleksi bawaan yang dapat Anda referensikan dari ekspresi. Dengan menyertakan parameter dalam ekspresi, Anda dapat menyesuaikan data dan tampilan laporan berdasarkan pilihan yang dilakukan pengguna. Ekspresi dapat digunakan untuk properti item laporan atau properti kotak teks apa pun yang menyediakan (*Fx) atau <Expression> opsi. Ekspresi juga digunakan untuk mengontrol konten laporan dan tampilan dengan cara lain. Untuk informasi selengkapnya, lihat Contoh ekspresi (Pembuat Laporan).
Saat Anda membandingkan nilai parameter dengan nilai bidang himpunan data pada run time, jenis data untuk dua item yang Anda bandingkan harus sama. Parameter laporan dapat berupa salah satu jenis berikut: Boolean, DateTime, Integer, Float, atau Text, yang mewakili String jenis data yang mendasarinya. Jika perlu, Anda mungkin harus mengonversi jenis data nilai parameter agar sesuai dengan nilai himpunan data. Untuk informasi selengkapnya, lihat Jenis data dalam ekspresi (Pembuat Laporan).
Untuk menyertakan referensi parameter dalam ekspresi, Anda harus memahami cara menentukan sintaks yang benar untuk referensi parameter. Sintaks bervariasi tergantung pada apakah parameter adalah parameter nilai tunggal atau multinilai.
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.
Menggunakan parameter bernilai tunggal dalam ekspresi
Tabel berikut ini memperlihatkan contoh sintaks yang akan digunakan saat Anda menyertakan referensi ke parameter nilai tunggal dari jenis data apa pun dalam ekspresi.
| Contoh | Deskripsi |
|---|---|
=Parameters! <ParameterName> .IsMultiValue |
Mengembalikan False. Memeriksa apakah parameter multinilai. Jika True, parameternya adalah multivalue dan merupakan kumpulan objek. Jika False, parameter adalah nilai tunggal dan merupakan objek tunggal. |
=Parameters! <ParameterName> .Count |
Mengembalikan nilai bilangan bulat 1. Untuk parameter nilai tunggal, jumlahnya selalu 1. |
=Parameters! <ParameterName> .Label |
Mengembalikan label parameter, yang sering digunakan sebagai nama tampilan dalam daftar nilai yang tersedia. |
=Parameters! <ParameterName> .Value |
Mengembalikan nilai parameter. Jika properti Label tidak diatur, nilai ini muncul dalam daftar nilai yang tersedia. |
=CStr(Parameters! <ParameterName> .Value) |
Mengembalikan nilai parameter sebagai string. |
=Fields(Parameters! <ParameterName> .Value).Value |
Mengembalikan nilai untuk bidang yang memiliki nama yang sama dengan parameter . |
Untuk informasi selengkapnya tentang menggunakan parameter dalam filter, lihat Menambahkan filter himpunan data, filter wilayah data, dan filter grup (Pembuat Laporan).
Menggunakan parameter multinilai dalam ekspresi
Tabel berikut ini memperlihatkan contoh sintaks yang akan digunakan saat Anda menyertakan referensi ke parameter multinilai dari jenis data apa pun dalam ekspresi.
| Contoh | Deskripsi |
|---|---|
=Parameters! <MultivalueParameterName> .IsMultiValue |
Mengembalikan True atau False. Memeriksa apakah parameter multinilai. Jika True, parameternya adalah multinilai dan merupakan kumpulan objek. Jika False, parameter bernilai tunggal dan merupakan objek tunggal. |
=Parameters! <MultivalueParameterName> .Count |
Mengembalikan nilai bilangan bulat. Mengacu pada jumlah nilai. Untuk parameter nilai tunggal, jumlahnya selalu 1. Untuk parameter multinilai, jumlahnya adalah 0 atau lebih. |
=Parameters! <MultivalueParameterName> .Value(0) |
Mengembalikan nilai pertama dalam parameter multinilai. |
=Parameters! <MultivalueParameterName> .Value(Parameters! <MultivalueParameterName> .Count-1) |
Mengembalikan nilai terakhir dalam parameter multinilai. |
=Split("Value1,Value2,Value3",",") |
Mengembalikan array nilai. Buat array nilai untuk parameter String multinilai. Anda dapat menggunakan pemisah apa pun di parameter kedua untuk Memisahkan. Ekspresi ini dapat digunakan untuk mengatur default untuk parameter multinilai atau untuk membuat parameter multinilai untuk dikirim ke laporan sublaporan atau penelusuran. |
=Join(Parameters! <MultivalueParameterName> .Value,", ") |
Mengembalikan String yang terdiri dari daftar nilai yang dibatasi koma dalam parameter multinilai. Anda dapat menggunakan pemisah apa pun di parameter kedua untuk Bergabung. |
Untuk informasi selengkapnya tentang menggunakan parameter dalam filter, lihat Parameter laporan (Pembuat Laporan dan Perancang Laporan).