Bagikan melalui

Referensi variabel laporan dan grup dalam laporan paginated (Pembuat Laporan)

  • Artikel

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 paginated, Anda mungkin ingin membuat variabel. Anda dapat membuat variabel laporan atau variabel grup. Nama variabel harus unik dalam laporan.

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.

Variabel laporan

Gunakan variabel laporan untuk menyimpan nilai untuk perhitungan dependen waktu, seperti tarif 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 dialog ReportProperties , pilih 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 koleksi 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 halaman maju dan mundur 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 SetValue metode , 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 Pratinjau laporan di Pembuat Laporan.

Variabel grup

Gunakan variabel grup untuk menghitung ekspresi kompleks sekali dalam cakupan grup. Variabel grup hanya valid dalam cakupan 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 subkategensi 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 dialog Properti Grup Tablix, pilih Variabel, dan berikan nama dan nilai. Variabel grup dihitung sekali per nilai grup unik.

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

Konten terkait