Koleksi bawaan - referensi variabel laporan dan grup dalam laporan paginasi (Pembuat Laporan)

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

Saat Anda memiliki perhitungan kompleks yang digunakan lebih dari sekali dalam ekspresi dalam laporan paginasi, Anda mungkin ingin membuat variabel. Anda dapat membuat variabel laporan atau variabel grup. Nama variabel harus unik dalam laporan.

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.

Variabel Laporan

Gunakan variabel laporan untuk menyimpan nilai untuk perhitungan dependen waktu, seperti kurs mata uang atau stempel waktu, atau untuk perhitungan kompleks yang dirujuk beberapa kali. Secara default, variabel laporan dihitung sekali dan dapat digunakan dalam ekspresi di seluruh laporan. Variabel laporan bersifat baca-saja secara default. Anda dapat mengubah default untuk mengaktifkan variabel laporan sebagai baca-tulis. Nilai dalam variabel laporan dipertahankan sepanjang sesi, hingga laporan diproses lagi.

Untuk menambahkan variabel laporan, buka kotak dialog ReportProperties , klik Variabel, dan berikan nama dan nilai. Nama adalah string peka huruf besar/kecil yang dimulai dengan huruf dan tidak memiliki spasi. Nama dapat mencakup huruf, angka, atau garis bawah (_).

Untuk merujuk ke variabel dalam ekspresi, gunakan sintaks pengumpulan global, misalnya, =Variables!CustomTimeStamp.Value. Pada permukaan desain, nilai muncul dalam kotak teks sebagai <<Expr>>.

Anda dapat menggunakan variabel laporan dengan cara berikut:

• Penggunaan baca-saja Atur nilai sekali untuk membuat konstanta untuk sesi laporan, misalnya, untuk membuat stempel waktu.

  Karena ekspresi dalam kotak teks dievaluasi sesuai permintaan sebagai halaman pengguna melalui laporan, nilai dinamis (misalnya, ekspresi yang menyertakan Now() fungsi, yang mengembalikan waktu hari) dapat mengembalikan nilai yang berbeda jika Anda meneruskan dan mundur halaman dengan menggunakan tombol Kembali . Dengan mengatur nilai variabel laporan ke ekspresi =Now(), lalu menambahkan variabel ke ekspresi Anda, Anda memastikan nilai yang sama digunakan di seluruh pemrosesan laporan.

• Penggunaan baca-tulis Tetapkan nilai sekali dan serialisasi nilai dalam sesi laporan. Opsi baca-tulis untuk variabel memberikan alternatif yang lebih baik daripada menggunakan variabel statis di blok Kode dalam definisi laporan.

  Saat Anda menghapus opsi Baca-Saja untuk variabel, properti Bisa-Tulis untuk variabel diatur ke true. Untuk memperbarui nilai dari ekspresi, gunakan metode SetValue, misalnya, =Variables!MyVariable.SetValue("123").

  Catatan

  Anda tidak dapat mengontrol kapan prosesor laporan menginisialisasi variabel atau mengevaluasi ekspresi yang memperbarui variabel. Urutan eksekusi untuk inisialisasi variabel tidak terdefinisi.

Untuk informasi selengkapnya tentang sesi, lihat Mempratinjau Laporan di Pembuat Laporan.

Variabel Grup

Gunakan variabel grup untuk menghitung ekspresi kompleks sekali dalam cakupan grup. Variabel grup hanya valid dalam lingkup grup dan grup turunannya.

Misalnya, wilayah data menampilkan data inventori untuk item yang berada dalam kategori pajak yang berbeda dan Anda ingin menerapkan tarif pajak yang berbeda untuk setiap kategori. Anda akan mengelompokkan data pada Kategori dan menentukan variabel Pajak pada grup induk. Kemudian Anda akan menentukan variabel grup untuk ItemTax untuk setiap kategori pajak dan menetapkan masing-masing subgrup Kategori yang berbeda ke variabel grup yang benar. Contohnya:

• Untuk grup induk berdasarkan [Category], tentukan variabel Pajak dengan nilai [Tax]. Asumsikan nilai kategorinya adalah Makanan dan Pakaian.

• Untuk grup anak berdasarkan [Subcategory], tentukan variabel ItemsTax sebagai =Variables!Tax.Value * Sum(Fields!Price.Value). Asumsikan nilai subkategori untuk kategori Makanan adalah Minuman dan Roti. Asumsikan nilai subkategrasi untuk Pakaian adalah Kemeja dan Topi.

• Untuk kotak teks dalam baris dalam grup anak, tambahkan ekspresi =Variables!ItemsTax.Value.

  Kotak teks menampilkan total pajak untuk Minuman dan Roti menggunakan pajak Makanan dan untuk Kemeja dan Topi menggunakan pajak Pakaian.

Untuk menambahkan variabel grup, buka kotak dialog Properti Grup Tablix , klik Variabel, dan berikan nama dan nilai. Variabel grup dihitung sekali per nilai grup unik.

Untuk merujuk ke variabel dalam ekspresi, gunakan sintaks pengumpulan global, misalnya, =Variables!GroupDescription.Value. Pada permukaan desain, nilai muncul dalam kotak teks sebagai <<Expr>>.

Lihat juga

Filter, Grup, dan Urutkan Data (Penyusun Laporan dan SSRS)
Koleksi Bawaan dalam Ekspresi (Pembuat Laporan dan SSRS)
Contoh Ekspresi (Penyusun Laporan dan SSRS)