Pengumpulan Bidang Himpunan Data (Penyusun Laporan dan SSRS)

  • Artikel

Bidang himpunan data mewakili data dari koneksi data. Bidang dapat mewakili data numerik atau non-numerik. Contohnya termasuk jumlah penjualan, total penjualan, nama pelanggan, pengidentifikasi database, URL, gambar, data spasial, dan alamat email. Pada permukaan desain, bidang muncul sebagai ekspresi dalam item laporan seperti kotak teks, tabel, dan bagan.

Laporan memiliki tiga jenis bidang dan menampilkannya di panel Data Laporan: bidang himpunan data, bidang terhitung himpunan data, dan bidang bawaan.

  • Bidang himpunan data. Metadata yang mewakili kumpulan bidang yang akan dikembalikan saat kueri himpunan data berjalan pada sumber data.

  • Bidang terhitung himpunan data. Bidang tambahan yang Anda buat untuk himpunan data. Setiap bidang terhitung dibuat dengan mengevaluasi ekspresi yang Anda tentukan.

  • Bidang bawaan. Metadata yang mewakili kumpulan bidang yang disediakan oleh Report Builder yang menyediakan informasi laporan seperti nama laporan atau waktu saat laporan diproses. Untuk informasi selengkapnya, lihat Referensi Global dan Pengguna Bawaan (Pembuat Laporan dan SSRS).

Nama bidang himpunan data disimpan sebagai bagian dari definisi himpunan data laporan. Untuk informasi selengkapnya, lihat Melaporkan Himpunan Data tersemat dan Himpunan Data Bersama (Pembuat 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.

Bidang dan Kueri Himpunan Data

Bidang himpunan data ditentukan oleh perintah kueri himpunan data dan oleh bidang terhitung apa pun yang Anda tentukan. Kumpulan bidang yang Anda lihat dalam laporan bergantung pada jenis himpunan data yang Anda miliki:

  • Himpunan data bersama. Kumpulan bidang adalah daftar bidang untuk kueri dalam definisi himpunan data bersama pada saat Anda langsung menambahkan himpunan data bersama ke laporan Anda, atau saat Anda menambahkan bagian laporan yang menyertakan himpunan data bersama. Kumpulan bidang lokal tidak berubah saat definisi himpunan data bersama berubah di server laporan. Untuk memperbarui kumpulan bidang lokal, Anda harus me-refresh daftar untuk himpunan data bersama lokal.

    Catatan

    Bagian laporan tidak digunakan lagi untuk semua rilis SQL Server Reporting Services yang dimulai dengan SQL Server Reporting Services 2019 dan semua rilis Power BI Report Server dimulai dengan Power BI Report Server September 2022.

  • Himpunan data yang disematkan. Kumpulan bidang adalah daftar bidang yang dikembalikan dari menjalankan kueri saat ini terhadap sumber data.

Untuk informasi selengkapnya lihat, Menambahkan, Mengedit, Menyegarkan Bidang di Panel Data Laporan (Penyusun Laporan dan SSRS)

Bidang Terhitung

Anda menentukan bidang terhitung secara manual dengan membuat ekspresi. Bidang terhitung dapat digunakan untuk membuat nilai baru yang tidak ada di sumber data. Misalnya, bidang terhitung dapat mewakili nilai baru, susunan urutan kustom untuk sekumpulan nilai bidang, atau bidang yang sudah ada yang dikonversi ke jenis data yang berbeda.

Bidang terhitung bersifat lokal untuk laporan dan tidak dapat disimpan sebagai bagian dari himpunan data bersama.

Untuk informasi selengkapnya, lihat Menambahkan, Mengedit, Merefresh Bidang di Panel Data Laporan (Penyusun Laporan dan SSRS).

Bidang Entitas dan Entitas

Jika Anda bekerja dengan sumber data model laporan, Anda menentukan entitas dan bidang entitas sebagai data laporan Anda. Di perancang kueri untuk model laporan, Anda bisa menjelajahi dan memilih entitas terkait secara interaktif dan memilih bidang yang ingin Anda sertakan dalam himpunan data laporan Anda. Setelah selesai mendesain kueri, Anda bisa melihat kumpulan pengidentifikasi entitas dan bidang entitas di panel Data Laporan. Pengidentifikasi entitas dihasilkan secara otomatis oleh model laporan dan biasanya tidak ditampilkan untuk pengguna akhir.

Menggunakan Properti Bidang yang Diperluas

Sumber data yang mendukung kueri multidimensi, seperti SQL Server Analysis Services, mendukung properti bidang pada bidang. Properti bidang muncul dalam tataan hasil untuk kueri, tetapi tidak terlihat di panel Data Laporan . Mereka masih tersedia untuk digunakan dalam laporan Anda. Untuk merujuk ke properti untuk bidang, seret bidang ke laporan, dan ubah nilai properti default ke nama bidang properti yang Anda inginkan. Misalnya, dalam kubus Analysis Services, Anda dapat menentukan format untuk nilai dalam sel kubus. Nilai yang diformat tersedia dengan menggunakan properti bidang FormattedValue. Untuk menggunakan nilai secara langsung alih-alih menggunakan nilai dan mengatur properti format kotak teks, seret bidang ke kotak teks dan ubah ekspresi =Fields!FieldName.Value default menjadi =Fields!FieldName.FormattedValue.

Catatan

Tidak semua properti Bidang dapat digunakan untuk semua sumber data. Properti Nilai dan IsMissing didefinisikan untuk semua sumber data. Properti lain yang telah ditentukan sebelumnya (seperti Key, UniqueName, dan ParentUniqueName untuk sumber data multidimensi) hanya didukung jika sumber data menyediakan properti tersebut. Properti kustom didukung oleh beberapa penyedia data. Untuk informasi selengkapnya, lihat topik khusus tentang properti bidang yang diperluas untuk jenis sumber data Anda di Himpunan Data Tersemat Laporan dan Himpunan Data Bersama (Pembuat Laporan dan SSRS). Misalnya, untuk sumber data SQL Server Analysis Services, lihat Properti Bidang yang Diperluas untuk Database Analysis Services (SSRS).

Memahami Ekspresi Default untuk Bidang

Kotak teks bisa menjadi item laporan kotak teks di isi laporan, atau kotak teks dalam sel di wilayah data tablix. Saat Anda menautkan bidang dengan kotak teks, lokasi kotak teks menentukan ekspresi default untuk referensi bidang. Di isi laporan, ekspresi nilai kotak teks harus menentukan agregat dan himpunan data. Jika hanya ada satu himpunan data dalam laporan, ekspresi default ini dibuat untuk Anda. Untuk bidang yang mewakili nilai numerik, fungsi agregat default adalah Jumlah. Untuk bidang yang mewakili nilai non-numerik, agregat defaultnya adalah Pertama.

Di wilayah data tablix, ekspresi bidang default bergantung pada keanggotaan baris dan grup kotak teks tempat Anda menambahkan bidang. Ekspresi bidang untuk bidang Penjualan, saat ditambahkan ke kotak teks di baris detail tabel, adalah [Sales]. Jika Anda menambahkan bidang yang sama ke kotak teks di header grup, ekspresi defaultnya adalah (Sum[Sales]), karena header grup menampilkan nilai ringkasan untuk grup, bukan nilai detail. Saat laporan berjalan, prosesor laporan mengevaluasi setiap ekspresi dan mengganti hasilnya dalam laporan.

Untuk informasi selengkapnya tentang ekspresi, lihat Ekspresi (Penyusun Laporan dan SSRS).

Tipe Data Bidang

Saat Anda membuat himpunan data, jenis data bidang pada sumber data mungkin tidak sama persis dengan jenis data yang digunakan dalam laporan. Jenis data dapat melalui satu atau dua lapisan pemetaan. Ekstensi pemrosesan data atau penyedia data dapat memetakan jenis data dari sumber data ke jenis data common language runtime (CLR). Jenis data yang dikembalikan oleh ekstensi pemrosesan data dipetakan ke subset jenis data common language runtime (CLR) dari .NET Framework.

Pada sumber data, data disimpan dalam jenis data yang didukung oleh sumber data. Misalnya, data dalam database SQL Server harus menjadi salah satu jenis data SQL Server yang didukung seperti nvarchar atau datetime. Saat Anda mengambil data dari sumber data, data melewati ekstensi pemrosesan data atau penyedia data yang terkait dengan jenis sumber data. Bergantung pada ekstensi pemrosesan data, data dapat dikonversi dari jenis data yang digunakan oleh sumber data menjadi jenis data yang didukung oleh ekstensi pemrosesan data. Reporting Services menggunakan jenis data yang didukung oleh runtime bahasa umum (CLR) yang diinstal dengan SQL Server Data Tools (SSDT). Penyedia data memetakan setiap kolom dalam kumpulan hasil dari jenis data asli ke jenis data .NET Framework common language runtime (CLR).

Pada setiap tahap, data diwakili oleh jenis data seperti yang dijelaskan dalam daftar berikut:

  • Sumber data Jenis data yang didukung oleh versi jenis sumber data yang Anda sambungkan.

    Misalnya, jenis data umum untuk sumber data SQL Server meliputi int, datetime, dan varchar. Jenis data yang diperkenalkan oleh SQL Server 2008 (10.0.x) menambahkan dukungan untuk tanggal, waktu, datetimetz, dan datetime2. Untuk informasi selengkapnya, lihat Jenis Data (Transact-SQL).

  • Penyedia data atau ekstensi pemrosesan data Jenis data yang didukung oleh versi penyedia data ekstensi pemrosesan data yang Anda pilih saat menyambungkan ke sumber data. Penyedia data berdasarkan .NET Framework menggunakan jenis data yang didukung oleh CLR. Untuk informasi selengkapnya tentang .NET Framework jenis data penyedia data, lihat Pemetaan Tipe Data (ADO.NET) dan Bekerja dengan Jenis Dasar di MSDN.

    Misalnya, jenis data umum yang didukung oleh .NET Framework menyertakan Int32 dan String. Tanggal dan waktu kalender didukung oleh struktur DateTime . .NET Framework 2.0 Paket Layanan 1 memperkenalkan dukungan untuk struktur DateTimeOffset untuk tanggal dengan offset zona waktu.

    Catatan

    Server laporan menggunakan penyedia data yang diinstal dan dikonfigurasi di server laporan. Klien penulisan laporan dalam mode Pratinjau menggunakan ekstensi pemrosesan data yang diinstal dan dikonfigurasi pada komputer klien. Anda harus menguji laporan Anda di klien laporan dan lingkungan server laporan.

  • Prosesor laporan Jenis data didasarkan pada versi CLR yang diinstal saat Anda menginstal Reporting Services.

    Misalnya, jenis data yang digunakan prosesor laporan untuk jenis tanggal dan waktu baru yang diperkenalkan di SQL Server 2008 (10.0.x) diperlihatkan dalam tabel berikut:

    Jenis Data SQL Tipe Data CLR Deskripsi
    Tanggal DateTime Tanggal saja
    Waktu TimeSpan Hanya waktu
    DateTimeTZ DateTimeOffset Tanggal dan waktu dengan offset zona waktu
    DateTime2 DateTime Tanggal dan waktu dengan milidetik pecahan

Untuk informasi selengkapnya tentang jenis database SQL Server, lihat Tipe Data (Mesin Database)dan Jenis dan Fungsi Data Tanggal dan Waktu (Transact-SQL).

Untuk informasi selengkapnya tentang menyertakan referensi ke bidang himpunan data dari ekspresi, lihat Jenis Data di Ekspresi (Penyusun Laporan dan SSRS).

Mendeteksi Bidang yang Hilang pada Durasi

Saat laporan diproses, kumpulan hasil untuk himpunan data mungkin tidak berisi nilai untuk semua kolom yang ditentukan karena kolom tidak lagi ada di sumber data. Anda bisa menggunakan properti bidang IsMissing untuk mendeteksi apakah nilai untuk bidang dikembalikan pada run-time. Untuk informasi selengkapnya, lihat Referensi Pengumpulan Bidang Himpunan Data (Penyusun Laporan dan SSRS).

Lihat juga

Kotak Dialog Properti Himpunan Data, Bidang (Pembuat Laporan)
Bagian Laporan dan Himpunan Data di Microsoft SQL Server Reporting Services Report Builder
Laporkan Himpunan Data Tersemat dan Himpunan Data Bersama (Penyusun Laporan dan SSRS)