Koleksi bawaan - Referensi pengumpulan parameter dalam laporan yang dipaginasi (Pembuat Laporan)

Berlaku untuk: ✔️ Perancang Laporan Pembangun ✔️ Laporan Power BI Microsoft Report Builder (SSRS) ✔️ di SQL Server Data Tools

Parameter laporan yang dipaginasi 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 opsi (Fx) atau <Ekspresi> . Ekspresi juga digunakan untuk mengontrol konten dan tampilan laporan dengan cara lain. Untuk informasi selengkapnya, lihat Contoh Ekspresi (Penyusun Laporan dan SSRS).

Saat Anda membandingkan nilai parameter dengan nilai bidang himpunan data pada durasi, 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 (Penyusun Laporan dan SSRS).

Untuk menyertakan referensi parameter dalam ekspresi, Anda harus memahami cara menentukan sintaks yang benar untuk referensi parameter, yang bervariasi tergantung pada apakah parameter adalah parameter nilai tunggal atau multinilai.

Catatan

Anda dapat membuat dan mengubah file definisi laporan paginasi (.rdl) di Microsoft Report Builder, Power BI Report Builder, dan di Perancang Laporan di SQL Server Data Tools.

Menggunakan Parameter Single-Valued dalam Ekspresi

Tabel berikut ini memperlihatkan contoh sintaks untuk 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 multinilai dan merupakan kumpulan objek. Jika False, parameternya 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 drop-down nilai yang tersedia.
=Parameters!<ParameterName>.Value Mengembalikan nilai parameter. Jika properti Label belum diatur, nilai ini muncul di daftar drop-down 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 (Penyusun Laporan dan SSRS).

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 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, hitungannya 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).

Lihat juga

Ekspresi (Penyusun Laporan dan SSRS)
Filter yang Umum Digunakan (Penyusun Laporan dan SSRS)
Menambahkan, Mengubah, atau Menghapus Parameter Laporan (Penyusun Laporan dan SSRS)
Tutorial: Menambahkan Parameter ke Laporan Anda (Microsoft SQL Server Reporting Services Report Builder)
Tutorial Pembuat Laporan
Koleksi Bawaan dalam Ekspresi (Pembuat Laporan dan SSRS)