Bagikan melalui

Mendesain laporan halaman Layanan Pelaporan dengan Perancang Laporan (SSRS)

  • Artikel

Berlaku untuk: SQL Server 2016 (13.x) Reporting Services dan yang lebih baru

Anda dapat menggunakan Perancang Laporan untuk membuat laporan paginated SQL Server Reporting Services (SSRS) berperingkat lengkap dan solusi pelaporan. Perancang Laporan menyediakan:

  • Cara bagi Anda untuk menentukan sumber data, himpunan data, dan kueri.
  • Kemampuan untuk merancang dan menyesuaikan tata letak wilayah dan bidang data.
  • Fitur interaktif seperti parameter dan kumpulan laporan yang bekerja sama.

Perancang Laporan adalah fitur SQL Server Data Tools (SSDT), lingkungan Microsoft Visual Studio untuk membuat solusi kecerdasan bisnis.

Penginstalan SSDT

SSDT tidak disertakan dengan SQL Server. Anda perlu menginstal SSDT secara terpisah. Untuk petunjuknya, lihat Menginstal SSDT dengan Visual Studio.

Untuk menggunakan templat Perancang Laporan, Anda juga perlu menginstal ekstensi SSRS untuk Visual Studio. Untuk petunjuknya, lihat Menginstal ekstensi untuk Analysis Services, Integration Services, dan Reporting Services.

Manfaat proyek laporan

Di Perancang Laporan, Anda dapat menggunakan proyek untuk mengatur laporan. Proyek laporan bertindak sebagai kontainer untuk definisi laporan dan sumber daya. Anda bisa menggunakan proyek untuk tugas-tugas berikut:

  • Mengatur laporan dan item terkait dalam satu kontainer.
  • Menguji solusi laporan yang menyertakan laporan dan item terkait secara lokal.
  • Menyebarkan item terkait bersama-sama. Anda dapat menggunakan properti proyek dan manajemen konfigurasi untuk menyebarkan item ke beberapa lingkungan.
  • Mempertahankan sekumpulan salinan utama untuk laporan dan item terkait, karena setelah penyebaran, laporan yang diterbitkan dapat dimodifikasi secara tidak sengaja.

Anda dapat menggunakan informasi dalam artikel ini untuk merancang laporan paginasi dan item terkait untuk satu proyek pelaporan dalam solusi SSDT. Untuk informasi selengkapnya tentang solusi dan beberapa proyek di SSDT, lihat Layanan Pelaporan di SQL Server Data Tools (SSDT).

Sumber data dan himpunan data bersama

SSDT menyediakan cara untuk menentukan dan menyebarkan sumber data bersama dan himpunan data bersama untuk solusi pelaporan.

  • Untuk menyebarkan sumber data bersama secara independen dari item lain dalam proyek, Anda dapat menggunakan OverwriteDataSources properti dan TargetDataSourceFolder .
  • Untuk menyebarkan himpunan data bersama secara independen dari item lain dalam proyek, Anda dapat menggunakan OverwriteDatasets properti dan TargetDatasetFolder .

Untuk informasi selengkapnya, lihat Mengatur properti penyebaran (Reporting Services).

Di Perancang Laporan, Anda bekerja di panel Data Laporan dan di Penjelajah Solusi untuk menentukan sumber data dan himpunan data bersama yang Anda gunakan dalam laporan. Untuk informasi selengkapnya, lihat panel Data Laporan.

Jika sumber data diterbitkan ke server laporan atau situs SharePoint tetapi tidak disertakan dalam solusi SSDT, Anda tidak dapat menggunakan SSDT untuk membuka sumber data tersebut. Demikian pula, Anda tidak dapat menggunakan SSDT untuk membuka himpunan data yang diterbitkan langsung dari server laporan atau situs SharePoint. Untuk membuka sumber data atau himpunan data dalam skenario ini, Anda dapat menggunakan Pembuat Laporan. Untuk informasi selengkapnya, lihat Lingkungan penulisan Pembuat Laporan (SSRS). Untuk himpunan data, gunakan lingkungan tersebut dalam mode himpunan data bersama.

SSDT adalah alat klien. Anda dapat menggunakannya untuk:

  • Uji solusi pelaporan Anda secara lokal di komputer Anda.
  • Uji solusi server Anda dengan menyebarkan solusi pelaporan Anda ke lingkungan pengujian.
  • Sebarkan solusi pelaporan Anda ke lingkungan produksi.
  • Bantu buat dan uji hasil kueri Anda secara lokal dengan menggunakan kemampuan pratinjau perancang kueri SSDT.

Setelah penyebaran:

Untuk informasi selengkapnya tentang menyertakan data dalam laporan yang dipaginasi, lihat Membuat string koneksi data di Pembuat Laporan.

Laporan bernomor

Laporan penomoran halaman adalah file yang disimpan dalam proyek laporan. Anda dapat menggunakan file laporan paginated sebagai laporan yang berdiri sendiri, sublaporan, atau sebagai target untuk tindakan penelusuran dari laporan utama. Untuk menyebarkan laporan secara independen dari item lain dalam proyek, Anda dapat menggunakan TargetReportFolder properti dan properti lainnya. Untuk informasi selengkapnya, lihat Mengatur properti penyebaran (Reporting Services).

Catatan

Jika Anda menerbitkan ke server laporan dalam mode SharePoint, Anda tidak dapat menguji beberapa fitur solusi laporan dalam proyek Perancang Laporan. Referensi ke laporan, sublaporan, dan laporan penelusuran harus menggunakan URL yang sepenuhnya memenuhi syarat yang dapat diuji hanya setelah Anda menyebarkan proyek laporan. Untuk informasi selengkapnya, lihat Contoh URL untuk item di server laporan - mode SharePoint.

Jika Anda menginstal ekstensi SSRS di Visual Studio, seperti yang dijelaskan sebelumnya dalam penginstalan SSDT, Anda dapat menggunakan templat Proyek Server Laporan untuk membuat proyek baru. Kemudian Anda dapat menambahkan laporan ke proyek Anda dengan salah satu cara berikut:

  • Gunakan wizard laporan. Anda membuat laporan dengan cara langkah demi langkah terpandu. Wizard laporan menyederhanakan definisi data dan desain laporan ke dalam serangkaian langkah yang memberi Anda laporan yang sudah selesai. Anda bisa menambahkan gaya untuk mengkustomisasi wizard untuk organisasi Anda sendiri. Untuk informasi selengkapnya, lihat Menambahkan laporan baru dengan menggunakan panduan laporan.

  • Tambahkan item baru jenis laporan. Laporan kosong terbuka di Perancang Laporan. Untuk informasi selengkapnya, lihat Menambahkan laporan kosong baru.

  • Tambahkan item yang sudah ada. File definisi laporan (.rdl) yang ada terbuka di Perancang Laporan. Membuka laporan atau proyek dari versi SSRS yang lebih lama mungkin secara otomatis meningkatkan proyek ke versi saat ini dan laporan ke skema saat ini. Untuk informasi selengkapnya, lihat Laporan peningkatan (SSRS).

  • Mengimpor laporan Microsoft Access. Proses impor mengimpor semua laporan dari database Access (.mdb, .accdb) atau file proyek (.adp). Perancang Laporan mengonversi setiap laporan dalam database atau file proyek menjadi Report Definition Language (RDL) dan menyimpannya dalam proyek laporan. Tidak semua fungsionalitas laporan Access ditransfer ke file definisi laporan (.rdl). Untuk informasi selengkapnya, lihat Mengimpor laporan dari Microsoft Access (Reporting Services).

    Catatan

    Anda harus menginstal Access 2002 atau versi yang lebih baru pada komputer yang sama yang Perancang Laporan diinstal untuk menggunakan fitur impor. Sumber data untuk laporan Access harus tersedia saat laporan diimpor.

  • Bekerja langsung dalam file RDL. Laporan disimpan dalam format XML sebagai file RDL. Anda dapat mengedit file ini di Perancang Laporan, editor teks, atau editor XML apa pun.

    Saat Mengedit sumber definisi laporan di Perancang Laporan, Anda bekerja dalam skema RDL saat ini untuk versi SQL Server tempat Anda menginstal alat pengembangan. Saat Anda membuat proyek, versi skema mungkin berubah tergantung pada properti penyebaran Anda. Untuk informasi selengkapnya, lihat Penyebaran dan dukungan versi di SQL Server Data Tools (SSDT).

    Mengedit RDL secara langsung dapat mengakibatkan laporan yang tidak dapat diterbitkan ke server laporan atau tidak dapat dijalankan. Seperti halnya file XML apa pun, pastikan Anda mengodekan karakter khusus XML dengan benar yang Anda gunakan dalam elemen. Saat Anda menerbitkan laporan, server laporan menggunakan skema untuk memvalidasi XML dalam file RDL.

    Untuk menyertakan elemen yang bukan bagian dari skema RDL, letakkan dalam elemen kustom. Ekstensi penyajian kustom dapat membaca elemen kustom. Tetapi ekstensi penyajian yang disediakan SSRS mengabaikan elemen . Misalnya, Anda dapat menggunakan elemen kustom untuk menyimpan komentar dalam laporan Anda.

    Untuk informasi selengkapnya, lihat Report Definition Language (SSRS).

Bagian laporan

Catatan

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

Di Perancang Laporan, Anda bisa membuat tabel, bagan, dan item laporan paginasi lainnya dalam proyek. Setelah membuatnya, Anda bisa menerbitkannya sebagai bagian laporan ke server laporan atau situs SharePoint yang terintegrasi dengan server laporan. Tindakan ini memungkinkan Anda dan orang lain untuk menggunakannya kembali dalam laporan lain. Untuk informasi selengkapnya, lihat Bagian laporan di Perancang Laporan (SSRS).

Anda dapat menyebarkan bagian laporan secara independen dari item lain dalam proyek dengan menggunakan TargetReportPartFolder properti dan properti lainnya. Untuk informasi selengkapnya, lihat Mengatur properti penyebaran (Reporting Services).

Sumber

Anda dapat menambahkan file ke proyek Anda yang terkait dengan laporan Anda tetapi tidak diproses oleh server laporan. Misalnya, Anda dapat menambahkan gambar, atau Anda dapat menambahkan shapefiles Environmental Systems Research Institute, Inc. (ESRI) untuk data spasial. Untuk mengetahui informasi selengkapnya, lihat Sumber daya.

Tata letak laporan yang dipaginasi

Untuk membuat tata letak laporan, Anda menyeret item laporan dan wilayah data dari kotak alat Perancang Laporan ke permukaan desain dan menyusunnya. Dengan menyeret bidang himpunan data ke item di permukaan desain, Anda dapat menambahkan data ke laporan. Untuk menata data dalam grup di wilayah data tablix, Anda menyeret bidang himpunan data ke panel Pengelompokan. Karena alat penulisan laporan pada dasarnya adalah cara untuk membuat definisi laporan, pendekatan untuk desain laporan mirip dalam Report Builder dan Perancang Laporan.

Mempratinjau laporan paginated

Anda dapat menggunakan tampilan Pratinjau untuk memverifikasi data laporan dan desain tata letak. Saat Anda mempratinjau laporan, prosesor laporan memvalidasi skema definisi laporan dan sintaks ekspresi. Ini juga mencantumkan masalah di jendela Output .

Catatan

Saat Anda mempratinjau laporan, data untuk laporan di-cache ke file di komputer lokal. Saat Anda mempratinjau laporan yang sama lagi dengan menggunakan kueri, parameter, dan kredensial yang sama, Perancang Laporan mengambil salinan cache daripada menjalankan ulang kueri. File data disimpan sebagai <report-name>.rdl.data dalam direktori yang sama dengan file definisi laporan. File tidak dihapus saat Anda menutup Perancang Laporan.

Anda bisa mempratinjau laporan dengan cara berikut:

  • Tampilan pratinjau. Jika Anda memilih tab Pratinjau , laporan akan berjalan secara lokal. Ini menggunakan fungsionalitas pemrosesan dan penyajian laporan yang sama dengan yang disediakan server laporan. Laporan yang ditampilkan adalah gambar interaktif. Anda dapat memilih parameter, memilih tautan, melihat peta dokumen, dan memperluas dan menciutkan area tersembunyi laporan. Anda juga dapat mengekspor laporan ke salah satu format penyajian yang terinstal.

  • Pratinjau mandiri. Anda dapat menjalankan laporan lokal di browser. Dengan menggunakan konfigurasi debug, Anda juga dapat menggunakan mode ini untuk men-debug rakitan kustom yang Anda tulis. Ada tiga cara untuk menjalankan proyek dalam mode debug:

    • Pada menu Debug , Anda dapat memilih Mulai Penelusuran Kesalahan.
    • Pada toolbar standar Visual Studio, Anda dapat memilih tombol Mulai .
    • Anda dapat memilih F5.

    Jika Anda menggunakan konfigurasi proyek yang membangun laporan tetapi tidak menyebarkannya, laporan yang ditentukan dalam StartItem properti konfigurasi saat ini terbuka di jendela pratinjau terpisah.

    Catatan

    Anda harus mengatur item mulai untuk menggunakan mode debug. Untuk mengatur item mulai, Anda masuk ke Penjelajah Solusi, klik kanan proyek laporan, dan pilih Properti. Kemudian di StartItem, Anda memilih nama laporan yang akan ditampilkan.

    Jika Anda ingin mempratinjau laporan tertentu yang bukan item mulai untuk proyek, Anda dapat memilih konfigurasi yang membangun laporan tetapi tidak menyebarkannya. Misalnya, Anda dapat menggunakan konfigurasi DebugLocal. Kemudian Anda mengklik kanan laporan dan memilih Jalankan. Anda harus memilih konfigurasi yang tidak menyebarkan laporan. Jika tidak, laporan diterbitkan ke server laporan alih-alih ditampilkan secara lokal di jendela pratinjau.

  • Pratinjau cetak. Saat Anda pertama kali melihat laporan dalam mode pratinjau atau di jendela pratinjau, tampilan laporan menyerupan laporan yang dihasilkan ekstensi penyajian HTML. Pratinjau bukan HTML, tetapi tata letak dan penomoran halaman laporan mirip dengan output HTML.

    Anda dapat mengubah tampilan untuk mewakili laporan yang dicetak dengan beralih ke mode pratinjau cetak. Saat Anda memilih Pratinjau Cetak pada toolbar Pratinjau, laporan ditampilkan seolah-olah berada di halaman fisik. Tampilan ini menyerupan output yang dihasilkan oleh ekstensi penyajian gambar dan PDF. Pratinjau cetak bukan file gambar atau PDF, tetapi tata letak dan penomoran halaman laporan mirip dengan output dalam format tersebut. Anda dapat memilih ukuran gambar laporan, misalnya, dan mengatur lebar halaman.

    Pratinjau cetak membantu Anda mengidentifikasi masalah penyajian yang mungkin Anda temui saat mencetak laporan. Masalah umum penyajian meliputi:

    • Halaman kosong tambahan karena laporan terlalu lebar agar pas pada ukuran kertas yang Anda tentukan untuk laporan.
    • Halaman kosong tambahan karena laporan berisi matriks yang secara dinamis diperluas untuk melebihi lebar kertas yang ditentukan.
    • Hentian halaman di antara grup yang tidak berfungsi seperti yang Anda inginkan.
    • Header dan footer yang tidak muncul seperti yang diharapkan.
    • Tata letak laporan yang memerlukan modifikasi agar tampak lebih baik dalam format yang dicetak.

Menyimpan dan menyebarkan laporan paginated

Dalam Perancang Laporan, Anda bisa menyimpan laporan dan file proyek lainnya secara lokal, atau menyebarkannya ke server laporan atau situs SharePoint. Sumber data bersama, himpunan data bersama, laporan, sumber daya laporan, dan bagian laporan dapat disebarkan secara independen atau bersama-sama tergantung pada properti penyebaran proyek yang Anda konfigurasi. Untuk informasi selengkapnya, lihat Properti konfigurasi dan penyebaran.

Dalam Perancang Laporan, Anda merancang laporan dengan menggunakan skema definisi laporan yang didukung versi SSRS saat ini di SSDT. Anda bisa mengatur properti penyebaran proyek untuk server laporan atau situs SharePoint tertentu. Saat Anda menyimpan laporan, Perancang Laporan menyimpan definisi laporan ke direktori build dalam skema yang cocok dengan versi di server laporan target. Untuk membuat laporan yang dapat diterbitkan di server laporan yang menggunakan versi SSRS sebelumnya, Perancang Laporan menghilangkan item laporan yang tidak ada dalam skema target. Tindakan ini terjadi secara otomatis dan tanpa meminta. Ketika tindakan ini terjadi, definisi laporan asli dipertahankan di folder proyek. Definisi laporan yang dimodifikasi yang Perancang Laporan sebarkan ada di folder build.

Catatan

Untuk ekspresi penelusuran kesalahan dan kesalahan penyebaran, Anda harus melihat definisi laporan di folder build. Jangan gunakan Tampilkan Kode pada menu pintasan file laporan untuk melihat definisi laporan dalam kasus ini. Saat Anda memilih Tampilkan Kode, Anda membuka sumber definisi laporan dari folder proyek.

Untuk informasi selengkapnya, lihat Penyebaran dan dukungan versi di SQL Server Data Tools (SSDT).

Menyimpan laporan secara lokal

Ketika Anda mengerjakan laporan atau item proyek lain di Perancang Laporan, file disimpan ke komputer lokal Anda atau ke berbagi file di komputer lain yang dapat Anda akses.

Jika Anda menggunakan perangkat lunak kontrol sumber, tindakan menyimpan laporan mungkin memeriksanya ke server kontrol sumber. Untuk informasi selengkapnya, lihat Kontrol sumber.

Menyebarkan atau menerbitkan laporan yang dipaginasi

Dari SSDT, Anda dapat menyebarkan laporan atau item proyek lainnya ke beberapa versi server laporan SSRS. Gunakan konfigurasi proyek untuk mengontrol peningkatan definisi laporan ke versi skema yang kompatibel dengan server laporan target. Konfigurasi proyek mengontrol properti tertentu, termasuk server laporan target, folder tempat proses build menyimpan definisi laporan untuk pratinjau dan penyebaran untuk sementara waktu, dan tingkat kesalahan. Untuk informasi selengkapnya, lihat Properti konfigurasi dan penyebaran dan Mengatur properti penyebaran (Reporting Services).

Mengekspor laporan paginasi ke format file yang berbeda

Laporan dapat diekspor ke berbagai format. Format ini memengaruhi bagaimana beberapa tata letak laporan dan fungsi fitur interaktivitas. Untuk informasi selengkapnya tentang pertimbangan desain untuk berbagai format output, lihat Mengekspor laporan paginated (Pembuat Laporan).

Melaporkan validasi dan tingkat kesalahan

Laporan divalidasi sebelum pratinjau dan selama penyebaran. Banyak masalah dapat terjadi ketika laporan dibuat. Misalnya, laporan dapat berisi string seperti ekspresi atau kueri yang tidak kompatibel dengan versi SSRS yang ditentukan konfigurasi proyek.

ErrorLevel Gunakan properti untuk mengelola peringatan dan kesalahan build. Anda dapat menetapkan ErrorLevel nilai properti dari 0 hingga 4 inklusif. Nilai menentukan masalah build mana yang dilaporkan sebagai kesalahan dan yang dilaporkan sebagai peringatan. Nilai defaultnya adalah 2. Peringatan dan kesalahan ditulis ke jendela Output SSDT.

Masalah dengan tingkat keparahan yang kurang dari atau sama dengan nilai dilaporkan ErrorLevel sebagai kesalahan. Masalah lain dilaporkan sebagai peringatan.

Tabel berikut mencantumkan tingkat kesalahan.

Tingkat kesalahan Deskripsi
0 Masalah build paling parah yang mencegah pratinjau dan penyebaran laporan
1 Masalah build parah yang mengubah tata letak laporan secara drastis
2 Masalah build yang kurang parah yang mengubah tata letak laporan secara signifikan
3 Masalah build kecil yang mengubah tata letak laporan dengan cara kecil yang mungkin tidak terlihat
4 Peringatan tentang masalah penerbitan

Anda dapat mencoba mempratinjau atau menyebarkan laporan yang berisi item laporan yang tidak didukung di versi SSRS Anda. Tetapi item laporan tersebut terkadang dihapus dari laporan dan kesalahan tingkat 2 dikeluarkan. Jika properti Anda ErrorLevel diatur ke nilai default 2, build gagal dalam kasus ini.

Anda bisa mengatasi masalah ini dengan mengubah nilai menjadi ErrorLevel 0 atau 1. Kemudian ketika item dihilangkan, peringatan dikeluarkan, dan proses build berlanjut.

Konten terkait