Koleksi bawaan - Referensi Global dan Pengguna dalam laporan paginasi (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. Ini tidak termasuk 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 dan SSRS).
RenderFormat
Tabel berikut ini menjelaskan anggota untuk RenderFormat.
| Anggota | Jenis | Deskripsi |
|---|---|---|
| Nama | String | Nama perender seperti yang terdaftar dalam file konfigurasi RSReportServer. Tersedia selama bagian tertentu dari siklus pemrosesan/penyajian laporan. |
| IsInteractive | Boolean | 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.TotalPagesEkspresi 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 kotak dialog Visibilitas Kolom untuk kolom yang dipilih, hanya menampilkan kolom saat laporan diekspor ke Excel. Jika tidak, kolom disembunyikan.
EXCELOPENXMLmengacu pada format Excel yang disertakan dalam Office 2007.EXCELmengacu 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, hanya memperlihatkan data pengguna saat ini, atau untuk menampilkan UserID, misalnya, 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. Nilai ditentukan oleh ekstensi keamanan Report Builder, yang dapat menggunakan Autentikasi Windows atau autentikasi kustom. |
Menggunakan locale Pengaturan
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 dapat 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 Rekam Jepret atau Laporan Riwayat
Dalam beberapa kasus, laporan yang menyertakan Pengguna! Variabel UserID akan gagal menampilkan data laporan yang khusus untuk pengguna saat ini yang melihat laporan.
Lihat Juga
Ekspresi (Pembuat Laporan dan SSRS)
Kotak Dialog Ekspresi (Pembuat Laporan)
Jenis Data dalam Ekspresi (Pembuat Laporan dan SSRS)
Memformat Angka dan Tanggal (Pembuat Laporan dan SSRS)
Contoh Ekspresi (Pembuat Laporan dan SSRS)
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk