Fungsi Report Builder - referensi fungsi agregat dalam laporan paginated (Report Builder)

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

Untuk menyertakan nilai agregat dalam laporan paginated, Anda bisa menggunakan fungsi agregat bawaan dalam ekspresi. Fungsi agregat default untuk bidang numerik adalah SUM. Anda dapat mengedit ekspresi dan menggunakan fungsi agregat bawaan yang berbeda atau menentukan cakupan yang berbeda. Cakupan mengidentifikasi kumpulan data mana yang akan digunakan untuk perhitungan.

Saat prosesor laporan menggabungkan data laporan dan tata letak laporan, ekspresi untuk setiap item laporan dievaluasi. Saat Anda melihat setiap halaman laporan, Anda akan melihat hasil untuk setiap ekspresi dalam item laporan yang dirender.

Tabel berikut ini mencantumkan kategori fungsi bawaan yang bisa Anda sertakan dalam ekspresi:

Untuk menentukan cakupan yang valid untuk fungsi, lihat topik referensi fungsi individual. Untuk informasi selengkapnya dan misalnya, lihat Cakupan Ekspresi untuk Total, Agregat, dan Koleksi Bawaan (Penyusun Laporan dan SSRS).

Catatan

Anda dapat membuat dan mengubah file definisi laporan yang dipaginasi (.rdl) di Microsoft Report Builder, Power BI Report Builder, dan di Perancang Laporan di SQL Server Data Tools.

Fungsi Agregat Bawaan

Fungsi bawaan berikut menghitung nilai ringkasan untuk sekumpulan data numerik non-null dalam cakupan default atau cakupan bernama.

Fungsi Deskripsi
Avg Mengembalikan rata-rata semua nilai numerik non-null yang ditentukan oleh ekspresi, yang dievaluasi dalam cakupan yang diberikan.
Menghitung Mengembalikan hitungan nilai non-null yang ditentukan oleh ekspresi, dievaluasi dalam konteks cakupan yang diberikan.
CountDistinct Mengembalikan hitungan semua nilai non-null berbeda yang ditentukan oleh ekspresi, dievaluasi dalam konteks cakupan yang diberikan.
Max Mengembalikan nilai maksimum semua nilai numerik non-null yang ditentukan oleh ekspresi, dalam konteks cakupan yang diberikan. Anda dapat menggunakan ini untuk menentukan nilai maksimum sumbu bagan untuk mengontrol skala.
Min Mengembalikan nilai minimum semua nilai numerik non-null yang ditentukan oleh ekspresi, dalam konteks cakupan yang diberikan. Anda dapat menggunakan ini untuk menentukan nilai minimum sumbu bagan untuk mengontrol skala.
StDev Mengembalikan simpangan baku semua nilai numerik non-null yang ditentukan oleh ekspresi, dievaluasi dalam cakupan yang diberikan.
StDevP Mengembalikan simpangan baku populasi dari semua nilai numerik non-null yang ditentukan oleh ekspresi, dievaluasi dalam konteks cakupan yang diberikan.
Sum Mengembalikan jumlah semua nilai numerik non-null yang ditentukan oleh ekspresi, yang dievaluasi dalam cakupan yang diberikan.
union Mengembalikan gabungan semua nilai data spasial non-null dari jenis SqlGeometry atau SqlGeography yang ditentukan oleh ekspresi, dievaluasi dalam cakupan yang diberikan.
Var Mengembalikan varians semua nilai numerik non-null yang ditentukan oleh ekspresi, dievaluasi dalam cakupan yang diberikan.
VarP Mengembalikan varian populasi dari semua nilai numerik non-null yang ditentukan oleh ekspresi, dievaluasi dalam konteks cakupan yang diberikan.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Pembatasan Bidang, Koleksi, dan Fungsi Agregat Bawaan

Tabel berikut ini meringkas pembatasan di lokasi laporan tempat Anda bisa menambahkan ekspresi yang berisi referensi ke koleksi bawaan global.

Lokasi dalam Laporan Bidang Parameter ReportItems Nomor Halaman

TotalPages
DataSource

Dataset
Variabel RenderFormat
Header Halaman

Footer Halaman
Ya Ya Paling banyak satu

Catatan 1
Ya Ya Ya Ya
Isi Ya

Catatan 2
Ya Hanya item dalam cakupan saat ini atau lingkup yang berisi

Catatan 3
Tidak Ya Ya Ya
Parameter Laporan Tidak Hanya parameter sebelumnya dalam daftar

Catatan 4
Tidak Tidak Tidak Tidak Tidak
Bidang Ya Ya Tidak Tidak Tidak Tidak Tidak
Parameter Kueri Tidak Ya Tidak Tidak Tidak Tidak Tidak
Ekspresi Grup Ya Ya Tidak Tidak Ya Tidak Tidak
Urutkan Ekspresi Ya Ya Tidak Tidak Ya Ya

Catatan 5
Tidak
Ekspresi Filter Ya Ya Tidak Tidak Ya Ya

Catatan 6
Tidak
Kode Tidak Ya

Catatan 7
Tidak Tidak Tidak Tidak Tidak
Report.Language Tidak Ya Tidak Tidak Tidak Tidak Tidak
Variabel Ya Ya Tidak Tidak Ya Cakupan saat ini atau yang berisi Tidak
Agregat Ya Ya Hanya di header halaman/footer halaman Hanya dalam agregat item laporan Ya Tidak Tidak
Fungsi pencarian Ya Ya Ya Tidak Ya Tidak Tidak
  • Catatan 1. ReportItems harus ada di halaman laporan yang dirender, atau nilainya adalah Null. Jika visibilitas item laporan bergantung pada ekspresi yang mengevaluasi ke False, item laporan tidak ada di halaman.

  • Catatan 2. Jika referensi bidang digunakan dalam cakupan grup, dan referensi bidang tidak disertakan dalam ekspresi grup, maka nilai untuk bidang tidak terdefinisi, kecuali hanya ada satu nilai dalam lingkup. Untuk menentukan nilai, gunakan Pertama atau Terakhir dan cakupan grup.

  • Catatan 3. Ekspresi yang menyertakan referensi ke ReportItems dapat menentukan nilai untuk ReportItems lain dalam cakupan grup yang sama atau dalam lingkup grup yang berisi.

  • Catatan 4. Nilai properti untuk parameter sebelumnya mungkin null.

  • Catatan 5. Di Anggota hanya mengurutkan. Tidak dapat digunakan dalam ekspresi pengurutan wilayah data.

  • Catatan 6. Hanya di Filter anggota. Tidak dapat digunakan dalam wilayah data atau ekspresi filter himpunan data.

  • Catatan 7. Koleksi Parameter tidak diinisialisasi sampai setelah blok Kode diproses, sehingga metode tidak dapat digunakan untuk mengontrol parameter pada inisialisasi.

  • Catatan 8. Jenis data untuk semua agregat kecuali Count dan CountDistinct harus memiliki tipe data yang sama, atau null, untuk semua nilai.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Pembatasan Agregat Berlapis

Tabel berikut ini meringkas batasan di mana fungsi agregat dapat menentukan fungsi agregat lainnya sebagai agregat berlapis.

Konteks RunningValue RowNumber Pertama

Belakang
Sebelumnya Fungsi Jumlah dan Presort Lainnya Agregat ReportItem Fungsi pencarian Fungsi Agregat
Nilai Berjalan Tidak Tidak Tidak Tidak Ya Tidak Ya Tidak
Pertama

Belakang
Tidak Tidak Tidak Tidak Ya Tidak Tidak Tidak
Sebelumnya Ya Ya Ya Tidak Ya Tidak Ya Tidak
Fungsi Jumlah dan Presort lainnya Tidak Tidak Tidak Tidak Ya Tidak Ya Tidak
Agregat ReportItem Tidak Tidak Tidak Tidak Tidak Tidak Tidak Tidak
Fungsi pencarian Ya Ya

Catatan 1
Ya

Catatan 1
Ya

Catatan 1
Ya

Catatan 1
Ya

Catatan 1
Tidak Tidak
Fungsi Agregat Tidak Tidak Tidak Tidak Tidak Tidak Tidak Tidak
  • Catatan 1. Fungsi agregat hanya diizinkan di dalam ekspresi Sumber dari fungsi Pencarian jika fungsi Pencarian tidak terkandung dalam agregat. Fungsi agregat tidak diizinkan di dalam ekspresi Tujuan atau Hasil dari fungsi Pencarian.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Menghitung Nilai yang Berjalan

Fungsi bawaan berikut menghitung nilai yang sedang berjalan untuk sekumpulan data. RowNumber seperti RunningValue karena mengembalikan nilai yang berjalan dari hitungan yang bertambah untuk setiap baris dalam cakupan yang berisi. Parameter cakupan untuk fungsi-fungsi ini harus menentukan cakupan yang berisi, yang mengontrol kapan hitungan dimulai ulang.

Fungsi Deskripsi
RowNumber Mengembalikan jumlah baris yang berjalan untuk cakupan yang ditentukan. Fungsi RowNumber dimulai ulang dihitung pada 1, bukan 0.
RunningValue Mengembalikan agregat yang berjalan dari semua nilai numerik non-null yang ditentukan oleh ekspresi, dievaluasi untuk cakupan yang diberikan.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Mengambil Jumlah Baris

Fungsi bawaan berikut menghitung jumlah baris dalam cakupan yang diberikan. Gunakan fungsi ini untuk menghitung semua baris, termasuk baris dengan nilai null.

Fungsi Deskripsi
CountRows Mengembalikan jumlah baris dalam cakupan yang ditentukan, termasuk baris dengan nilai null.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Mencari Nilai dari Himpunan Data Lain

Fungsi pencarian berikut mengambil nilai dari himpunan data tertentu.

Fungsi Deskripsi
Fungsi Pencarian Mengembalikan nilai dari himpunan data untuk ekspresi tertentu.
Fungsi LookupSet Mengembalikan sekumpulan nilai dari himpunan data untuk ekspresi tertentu.
Fungsi Multilookup Mengembalikan kumpulan nilai pencocokan pertama untuk sekumpulan nama dari himpunan data yang berisi pasangan nama/nilai.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Mengambil Nilai Sort-Dependent

Fungsi bawaan berikut mengembalikan nilai pertama, terakhir, atau sebelumnya dalam cakupan tertentu. Fungsi-fungsi ini bergantung pada urutan urutan nilai data. Gunakan fungsi-fungsi ini, misalnya, untuk menemukan nilai pertama dan terakhir pada halaman untuk membuat header halaman gaya kamus. Gunakan Sebelumnya untuk membandingkan nilai dalam satu baris dengan nilai baris sebelumnya dalam cakupan tertentu, misalnya, untuk menemukan persentase nilai tahun ke tahun dalam tabel.

Fungsi Deskripsi
Pertama Mengembalikan nilai pertama dalam cakupan ekspresi yang ditentukan.
Terakhir Mengembalikan nilai terakhir dalam cakupan ekspresi yang ditentukan.
Sebelumnya Mengembalikan nilai atau nilai agregat yang ditentukan untuk instans item sebelumnya dalam cakupan yang ditentukan.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Mengambil Agregat Server

Fungsi bawaan berikut mengambil agregat kustom dari penyedia data. Misalnya, menggunakan jenis sumber data Analysis Services, Anda dapat mengambil agregat yang dihitung di server sumber data untuk digunakan dalam header grup.

Fungsi Deskripsi
Aggregat Mengembalikan agregat kustom dari ekspresi yang ditentukan, seperti yang ditentukan oleh penyedia data.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Pengujian untuk Cakupan

Fungsi bawaan berikut menguji konteks item laporan saat ini untuk melihat apakah itu adalah anggota cakupan tertentu.

Fungsi Deskripsi
InScope Menunjukkan apakah instans item saat ini berada dalam cakupan yang ditentukan.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Mengambil Tingkat Rekursif

Fungsi bawaan berikut mengambil tingkat saat ini ketika hierarki rekursif diproses. Gunakan hasil fungsi ini dengan properti Padding dalam kotak teks untuk mengontrol tingkat inden hierarki visual untuk grup rekursif. Untuk informasi selengkapnya, lihat Membuat Grup Hierarki Rekursif (Pembuat Laporan dan SSRS).

Fungsi Deskripsi
Level Mengembalikan tingkat kedalaman saat ini dalam hierarki rekursif.

Ikon panah digunakan dengan ikon Panah tautan Kembali ke Atas Kembali ke Atas

Lihat juga

Penggunaan Ekspresi dalam Laporan (Penyusun Laporan dan SSRS)
Contoh Ekspresi (Penyusun Laporan dan SSRS)
Cakupan Ekspresi untuk Total, Agregat, dan Koleksi Bawaan (Report Builder dan SSRS)