Referensi koleksi ReportItems dalam laporan paginated (Pembuat Laporan)

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

Koleksi bawaan ReportItems adalah kumpulan kotak teks dari item laporan seperti baris wilayah data atau kotak teks pada permukaan desain laporan yang dipaginasi. Kumpulan ReportItems menyertakan kotak teks yang berada dalam lingkup header halaman, footer halaman, atau isi laporan saat ini. Koleksi ini ditentukan pada waktu proses oleh prosesor laporan dan perender laporan. Cakupan saat ini berubah saat prosesor laporan secara berturut-turut menggabungkan data laporan dan elemen tata letak item laporan sebagai halaman tampilan pengguna laporan. Anda dapat menggunakan koleksi bawaan ReportItems untuk menghasilkan header halaman gaya kamus yang memperlihatkan item pertama dan terakhir di setiap halaman.

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 properti Nilai ReportItems

Item dalam koleksi ReportItems hanya memiliki satu properti: Nilai. Nilai untuk item ReportItems dapat digunakan untuk menampilkan atau menghitung data dari bidang lain dalam laporan. Untuk mengakses nilai kotak teks saat ini, Anda dapat menggunakan visual basic bawaan global Me.Value atau hanya Value. Dalam fungsi laporan seperti Fungsi pertama dan agregat, gunakan sintaksis yang sepenuhnya memenuhi syarat.

Contohnya:

  • Ekspresi ini, ditempatkan dalam kotak teks, menampilkan nilai kotak teks ReportItem bernama Textbox1:

    =ReportItems!Textbox1.Value

  • Ekspresi ini, ditempatkan dalam properti Warna kotak teks ReportItem , menampilkan teks berwarna hitam saat nilainya adalah > 0; jika tidak, nilai ditampilkan dengan warna merah:

    =IIF(Me.Value > 0,"Black","Red")

  • Ekspresi ini, ditempatkan dalam kotak teks di header halaman atau footer halaman, menampilkan nilai pertama per halaman laporan yang dirender, untuk kotak teks bernama LastName:

    =First(ReportItems("LastName").Value)

Ekspresi header halaman gaya kamus

Anda dapat membuat header halaman untuk menampilkan pelanggan pertama di halaman dan pelanggan terakhir di halaman. Karena kotak teks di header halaman hanya dapat merujuk ke kumpulan bawaan ReportItems sekali dalam ekspresi, Anda perlu menambahkan dua kotak teks ke header halaman: satu untuk nama pelanggan pertama (=First(ReportItems!textboxLastName.Value) dan satu untuk nama pelanggan terakhir (=Last(ReportItems!textboxLastName.Value).

Di bagian header halaman atau footer halaman, hanya kotak teks di halaman saat ini yang tersedia sebagai anggota koleksi ReportItems . Misalnya, jika ReportItems!textboxLastName.Value merujuk ke kotak teks yang hanya muncul di halaman pertama untuk wilayah data multi-halaman, Anda akan melihat nilai untuk halaman pertama, tetapi semua halaman lain menampilkan #Error untuk memperlihatkan ekspresi tidak dapat dievaluasi seperti yang ditulis.

Cakupan untuk koleksi ReportItems

Saat laporan diproses, setiap kotak teks di isi laporan atau di wilayah data dievaluasi dalam konteks himpunan data, wilayah data, dan asosiasi grupnya. Cakupan untuk referensi ke koleksi ReportItems adalah cakupan saat ini atau titik apa pun yang lebih tinggi dari cakupan saat ini.

Misalnya, kotak teks dalam baris yang berada dalam grup induk tidak boleh berisi ekspresi yang mengacu pada nama kotak teks dalam baris grup anak. Ekspresi seperti itu tidak mengatasi nilai dalam laporan karena kotak teks baris turunan berada di luar cakupan. Untuk informasi selengkapnya, lihat Referensi fungsi agregat (Pembuat Laporan).

Koleksi bawaan dalam ekspresi (Pembuat Laporan)
Contoh ekspresi (Pembuat Laporan)
Penomoran halaman di Reporting Services (Penyusun Laporan)
Memfilter, mengelompokkan, dan mengurutkan data (Pembuat Laporan)