Referensi Global dan Pengguna bawaan dalam laporan paginated (Pembuat Laporan)
Berlaku untuk: Microsoft Report Builder (SSRS) Power BI Report Builder Perancang Laporan di SQL Server Data Tools
Koleksi bidang bawaan, yang mencakup koleksi Global dan Pengguna, mewakili nilai global yang disediakan oleh Reporting Services saat laporan paginated diproses. Koleksi Global menyediakan nilai seperti nama laporan, waktu ketika pemrosesan laporan dimulai, dan nomor halaman saat ini untuk header atau footer laporan. Koleksi Pengguna menyediakan pengidentifikasi pengguna dan pengaturan bahasa. Nilai-nilai ini dapat digunakan dalam ekspresi untuk memfilter hasil 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.
Menggunakan koleksi Global
Koleksi Global berisi variabel global untuk laporan. Pada permukaan desain, variabel ini muncul diawali oleh & (ampersand), misalnya, [&ReportName]
. Tabel berikut ini menjelaskan anggota koleksi Global .
Anggota | Jenis | Keterangan |
---|---|---|
ExecutionTime | DateTime | Tanggal dan waktu laporan mulai dijalankan. |
Nomor Halaman | Bilangan bulat | Nomor halaman saat ini relatif terhadap hentian halaman yang mereset nomor halaman. Pada awal pemrosesan laporan, nilai awal diatur ke 1 . Kenaikan nomor halaman untuk setiap halaman yang dirender.Untuk memberi nomor halaman dalam hentian halaman untuk persegi panjang, wilayah data, grup wilayah data, atau peta, pada properti PageBreak , atur properti ResetPageNumber ke True. Tidak didukung pada grup hierarki kolom tablix. PageNumber hanya dapat digunakan dalam ekspresi di header halaman atau footer halaman. |
ReportFolder | String | Jalur lengkap ke folder yang berisi laporan. Item ini tidak menyertakan URL server laporan. |
ReportName | String | Nama laporan seperti yang disimpan dalam database server laporan. |
ReportServerUrl | String | URL server laporan tempat laporan dijalankan. |
TotalPages | Bilangan bulat | Jumlah total halaman relatif terhadap pemisah halaman yang mereset PageNumber. Jika tidak ada hentian halaman yang diatur, nilai ini sama dengan OverallTotalPages. TotalPages hanya dapat digunakan dalam ekspresi di header halaman atau footer halaman. |
PageName | String | Nama halaman. Di awal pemrosesan laporan, nilai awal diatur dari InitialPageName, properti laporan. Saat setiap item laporan diproses, nilai ini digantikan oleh nilai PageName yang sesuai dari persegi panjang, wilayah data, grup wilayah data, atau peta. Tidak didukung pada grup hierarki kolom tablix. PageName hanya dapat digunakan dalam ekspresi di header halaman atau footer halaman. |
OverallPageNumber | Bilangan bulat | Nomor halaman halaman saat ini untuk seluruh laporan. Nilai ini tidak terpengaruh oleh ResetPageNumber. OverallPageNumber hanya dapat digunakan dalam ekspresi di header halaman atau footer halaman. |
OverallTotalPages | Bilangan bulat | Halaman jumlah total untuk seluruh laporan. Nilai ini tidak terpengaruh oleh ResetPageNumber. OverallTotalPages hanya dapat digunakan dalam ekspresi di header halaman atau footer halaman. |
RenderFormat | RenderFormat | Informasi tentang permintaan penyajian saat ini. Untuk informasi selengkapnya, lihat RenderFormat di bagian berikutnya. |
Anggota koleksi Global mengembalikan varian. Jika Anda ingin menggunakan anggota koleksi ini dalam ekspresi yang memerlukan jenis data tertentu, Anda harus terlebih dahulu melemparkan variabel. Misalnya, untuk mengonversi varian waktu eksekusi menjadi format Tanggal, gunakan =CDate(Globals!ExecutionTime)
. Untuk informasi selengkapnya, lihat Jenis data dalam ekspresi (Pembuat Laporan).
RenderFormat
Tabel berikut ini menjelaskan anggota untuk RenderFormat.
Anggota | Tipe | Deskripsi |
---|---|---|
Nama | String | Nama perender seperti yang terdaftar dalam RSReportServer file konfigurasi.Tersedia selama bagian tertentu dari siklus pemrosesan/penyajian laporan. |
IsInteractive | Boolean | Menunjukkan apakah permintaan penyajian saat ini menggunakan format penyajian interaktif. |
Info Perangkat | Kumpulan nama/nilai baca-saja | Pasangan kunci/nilai untuk parameter deviceinfo untuk permintaan penyajian saat ini. Nilai string dapat ditentukan dengan menggunakan kunci atau indeks ke dalam koleksi. |
Contoh
Contoh berikut menunjukkan cara menggunakan referensi ke koleksi Global dalam ekspresi:
Ekspresi ini, ditempatkan dalam kotak teks di footer laporan, menyediakan nomor halaman dan total halaman dalam laporan:
=Globals.PageNumber & " of " & Globals.TotalPages
Ekspresi ini menyediakan nama laporan dan waktu dijalankan. Waktu diformat dengan string pemformatan Microsoft .NET Framework untuk tanggal pendek:
=Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
Ekspresi ini, ditempatkan dalam dialog Visibilitas Kolom untuk kolom yang dipilih, hanya menampilkan kolom saat laporan diekspor ke Excel. Jika tidak, kolom disembunyikan.
EXCELOPENXML
mengacu pada format Excel yang disertakan dalam Office 2007.EXCEL
mengacu pada format Excel yang disertakan dalam Office 2003.=IIF(Globals!RenderFormat.Name = "EXCELOPENXML" OR Globals!RenderFormat.Name = "EXCEL", false, true)
Menggunakan koleksi Pengguna
Kumpulan Pengguna berisi data tentang pengguna yang menjalankan laporan. Anda dapat menggunakan koleksi ini untuk memfilter data yang muncul dalam laporan. Misalnya, Anda hanya dapat menampilkan data pengguna saat ini, atau untuk menampilkan UserID, seperti dalam judul laporan. Pada permukaan desain, variabel ini muncul diawali oleh & (ampersand), misalnya, [&UserID]
.
Tabel berikut ini menjelaskan anggota kumpulan Pengguna .
Anggota | Jenis | Keterangan |
---|---|---|
Bahasa | String | Bahasa pengguna yang menjalankan laporan. Contohnya,en-US . |
UserID | String | ID pengguna yang menjalankan laporan. Jika Anda menggunakan Autentikasi Windows, nilai ini adalah akun domain pengguna saat ini. Ekstensi keamanan Report Builder menentukan nilai, yang dapat menggunakan Autentikasi Windows atau autentikasi kustom. |
Menggunakan pengaturan lokal
Anda dapat menggunakan ekspresi untuk merujuk ke pengaturan lokal pada komputer klien melalui nilai User.Language untuk menentukan bagaimana laporan muncul kepada pengguna. Misalnya, Anda dapat membuat laporan yang menggunakan ekspresi kueri yang berbeda berdasarkan nilai lokal. Kueri mungkin berubah untuk mengambil informasi yang dilokalkan dari kolom yang berbeda tergantung pada bahasa yang dikembalikan. Anda juga dapat menggunakan ekspresi dalam pengaturan bahasa laporan atau item laporan berdasarkan variabel ini.
Catatan
Meskipun Anda dapat mengubah pengaturan bahasa laporan, Anda harus berhati-hati tentang masalah tampilan apa pun yang mungkin terjadi. Misalnya, mengubah pengaturan lokal laporan dapat mengubah format tanggal dalam laporan, tetapi juga dapat mengubah format mata uang. Kecuali ada proses konversi untuk mata uang, ini dapat menyebabkan simbol mata uang yang salah ditampilkan dalam laporan. Untuk menghindari hal ini, atur informasi bahasa tentang item individual yang ingin Anda ubah, atau atur item dengan data mata uang ke bahasa tertentu.
Mengidentifikasi UserID untuk laporan rekam jepret atau riwayat
Dalam beberapa kasus, laporan yang menyertakan Pengguna! Variabel UserID gagal menampilkan data laporan yang khusus untuk pengguna saat ini yang melihat laporan.