Fungsi Pembuat Laporan - referensi fungsi agregat dalam laporan paginated (Pembuat Laporan)

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 dapat 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:

• Fungsi Agregat Bawaan

• Pembatasan pada Bidang, Koleksi, dan Fungsi Agregat Bawaan

• Pembatasan Agregat Berlapis

• Menghitung Nilai yang Berjalan

• Mengambil Jumlah Baris

• Mencari Nilai dari Himpunan Data Lain

• Mengambil nilai sortir-dependen

• Mengambil Agregat Server

• Mengambil Tingkat Rekursif

• Pengujian untuk Cakupan

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

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.

Fungsi Agregat Bawaan

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

Fungsi	Keterangan
Avg	Mengembalikan rata-rata semua nilai numerik non-null yang ditentukan oleh ekspresi, dievaluasi dalam cakupan yang diberikan.
Hitung	Mengembalikan hitungan nilai non-null yang ditentukan oleh ekspresi, dievaluasi dalam konteks cakupan yang diberikan.
CountDistinct	Mengembalikan hitungan semua nilai non-null yang berbeda yang ditentukan oleh ekspresi, dievaluasi dalam konteks cakupan yang diberikan.
Maks	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.
Jumlah	Mengembalikan jumlah semua nilai numerik non-null yang ditentukan oleh ekspresi, dievaluasi dalam cakupan yang diberikan.
union	Mengembalikan gabungan semua nilai data spasial non-null 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 varians populasi dari semua nilai numerik non-null yang ditentukan oleh ekspresi, dievaluasi dalam konteks cakupan yang diberikan.

Kembali ke Atas

Pembatasan pada Bidang, Koleksi, dan Fungsi Agregat Bawaan

Tabel berikut ini meringkas batasan 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 cakupan yang berisi Catatan 3	Tidak	Ya	Ya	Ya
Parameter Laporan	No	Hanya parameter sebelumnya dalam daftar Catatan 4	Tidak	No	No	No	Tidak
Bidang	Ya	Ya	No	No	No	No	Tidak
Parameter Kueri	Tidak	Ya	No	No	No	No	Tidak
Ekspresi Grup	Ya	Ya	No	No	Ya	No	Tidak
Urutkan Ekspresi	Ya	Ya	No	No	Ya	Ya Catatan 5	No
Ekspresi Filter	Ya	Ya	No	No	Ya	Ya Catatan 6	No
Kode	Tidak	Ya Catatan 7	Tidak	No	No	No	Tidak
Report.Language	Tidak	Ya	No	No	No	No	Tidak
Variabel	Ya	Ya	No	No	Ya	Cakupan saat ini atau berisi	No
Agregat	Ya	Ya	Hanya di header halaman/footer halaman	Hanya dalam agregat item laporan	Ya	No	Tidak
Fungsi pencarian	Ya	Ya	Ya	No	Ya	No	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 cakupan. Untuk menentukan nilai, gunakan Pertama atau Terakhir dan cakupan grup.

• Catatan 3. Ekspresi yang menyertakan referensi ke ReportItems dapat menentukan nilai untuk ReportItem lain dalam cakupan grup yang sama atau dalam cakupan 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.

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	First Last	Sebelumnya	Fungsi Jumlah dan Presort Lainnya	Agregat ReportItem	Fungsi pencarian	Fungsi Agregat
Nilai Berjalan	Tidak	No	No	No	Ya	No	Ya	Tidak
First Last	Tidak	No	No	No	Ya	No	No	Tidak
Sebelumnya	Ya	Ya	Ya	No	Ya	No	Ya	Tidak
Fungsi Jumlah dan Presort lainnya	Tidak	No	No	No	Ya	No	Ya	Tidak
Agregat ReportItem	Tidak	No	No	No	No	No	No	Tidak
Fungsi pencarian	Ya	Ya Catatan 1	Ya Catatan 1	Ya Catatan 1	Ya Catatan 1	Ya Catatan 1	Tidak	Tidak
Fungsi Agregat	Tidak	No	No	No	No	No	No	Tidak

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

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 saat hitungan dimulai ulang.

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

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	Keterangan
CountRows	Mengembalikan jumlah baris dalam cakupan yang ditentukan, termasuk baris dengan nilai null.

Kembali ke Atas

Mencari Nilai dari Himpunan Data Lain

Fungsi pencarian berikut mengambil nilai dari himpunan data tertentu.

Fungsi	Keterangan
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.

Kembali ke Atas

Mengambil nilai sortir-dependen

Fungsi bawaan berikut mengembalikan nilai pertama, terakhir, atau sebelumnya dalam cakupan tertentu. Fungsi-fungsi ini bergantung pada urutan pengurutan nilai data. Gunakan fungsi-fungsi ini, misalnya, untuk menemukan nilai pertama dan terakhir di 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 demi tahun dalam tabel.

Fungsi	Keterangan
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.

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	Keterangan
Aggregat	Mengembalikan agregat kustom dari ekspresi yang ditentukan, seperti yang ditentukan oleh penyedia data.

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.

Kembali ke Atas

Mengambil Tingkat Rekursif

Fungsi bawaan berikut mengambil tingkat saat ini saat 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
Tingkat	Mengembalikan tingkat kedalaman saat ini dalam hierarki rekursif.

Kembali ke Atas

Lihat Juga

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