Mendesain laporan halaman Layanan Pelaporan dengan Perancang Laporan (SSRS)

Gunakan Perancang Laporan untuk membuat laporan paginasi dan solusi pelaporan Dengan fitur lengkap Reporting Services. Perancang Laporan menyediakan antarmuka grafis tempat Anda dapat menentukan sumber data. Ini juga menyediakan himpunan data dan kueri, posisi tata letak laporan untuk wilayah dan bidang data, dan 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. SQL Server Data Tools (SSDT) tidak disertakan dengan SQL Server. Unduh Alat Data SQL Server.

Manfaat proyek laporan

Proyek laporan bertindak sebagai kontainer untuk definisi laporan dan sumber daya. Gunakan proyek untuk:

• Atur laporan dan item terkait dalam satu kontainer.

• Uji solusi laporan yang menyertakan laporan dan item terkait secara lokal.

• Sebarkan item terkait bersama-sama. Gunakan properti proyek dan manajemen konfigurasi untuk menyebarkan ke beberapa lingkungan.

• Pertahankan sekumpulan salinan utama untuk laporan dan item terkait. Setelah penyebaran, laporan yang diterbitkan dapat diubah secara tidak sengaja.

Gunakan informasi dalam artikel ini untuk merancang laporan paginasi dan item terkait untuk satu proyek pelaporan dalam solusi SQL Server Data Tools (SSDT). Untuk informasi selengkapnya tentang solusi dan beberapa proyek di SQL Server Data Tools, lihat Reporting Services di SQL Server Data Tools.

Sumber data bersama

Gunakan SQL Server Data Tools untuk menentukan dan menyebarkan sumber data bersama untuk solusi pelaporan. Sumber data bersama dapat disebarkan secara independen dari item lain dalam proyek dengan menggunakan properti OverwriteDataSources dan TargetDataSourceFolder . 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 yang digunakan dalam laporan. Untuk informasi selengkapnya, lihat Panel Data Laporan. Anda tidak dapat menggunakan Alat Data SQL Server untuk membuka sumber data yang diterbitkan ke server laporan atau situs SharePoint, tetapi tidak disertakan dalam solusi Alat Data SQL Server. Untuk fitur tersebut, gunakan lingkungan penulisan Report Builder (SSRS).

SQL Server Data Tools adalah alat klien. Anda dapat menguji solusi pelaporan secara lokal di komputer Anda, menyebarkannya ke lingkungan pengujian untuk menguji solusi server, lalu menyebarkannya ke lingkungan produksi. Setelah penyebaran, verifikasi bahwa ekstensi pemrosesan sumber data dan kredensial sumber data dikonfigurasi untuk lingkungan server laporan. Anda dapat menggunakan Configuration Manager untuk membantu mengelola properti untuk penyebaran yang berbeda. Untuk informasi selengkapnya, lihat Reporting Services di SQL Server Data Tools (SSDT).

Untuk informasi selengkapnya, lihat Membuat string koneksi data - Pembuat Laporan & SSRS.

Himpunan data bersama

Gunakan SQL Server Data Tools untuk menentukan dan menyebarkan himpunan data bersama untuk solusi pelaporan. Himpunan data bersama dapat disebarkan secara independen dari item lain dalam proyek dengan menggunakan properti OverwriteDatasets 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 himpunan data bersama yang digunakan dalam laporan. Untuk informasi selengkapnya, lihat Panel Data Laporan. Anda tidak dapat menggunakan Alat Data SQL Server untuk membuka himpunan data yang diterbitkan langsung dari server laporan atau situs SharePoint. Untuk fitur tersebut, gunakan lingkungan penulisan Report Builder (SSRS) dalam mode Himpunan Data Bersama.

SQL Server Data Tools adalah alat klien. Anda bisa menggunakan perancang kueri untuk membantu membuat dan menguji hasil kueri Anda secara lokal di Pratinjau. Setelah penyebaran, Anda dapat mengelola himpunan data bersama secara independen dari sumber data bersama dan laporan yang bergantung padanya. Untuk informasi selengkapnya, lihat Melaporkan Himpunan Data tersemat dan Himpunan Data Bersama (Pembuat Laporan dan SSRS), Alat Desain Kueri (SSRS), dan Mengelola Himpunan Data Bersama.

Laporan bernomor

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

Catatan

Jika Anda menerbitkan ke server laporan dalam mode SharePoint, beberapa fitur solusi laporan tidak dapat diuji 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 Laporan yang Diterbitkan pada Server Laporan dalam Mode SharePoint (SSRS).

Anda bisa menambahkan laporan ke proyek dengan cara berikut:

• Tambahkan proyek laporan baru. Secara default, laporan kosong terbuka di Perancang Laporan. Untuk informasi selengkapnya, lihat Menambahkan Laporan Baru atau Yang Sudah Ada ke Proyek Laporan (SSRS).

• Tambahkan proyek Panduan Laporan. Anda membuat laporan dengan cara langkah demi langkah terpandu. Panduan 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 atau Yang Sudah Ada ke Proyek Laporan (SSRS).

• Tambahkan item baru jenis Laporan. Laporan kosong terbuka di Perancang Laporan.

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

• Mengimpor laporan Microsoft Access. Impor semua laporan dari database Access (.mdb, .accdb) atau file proyek (.adp). Perancang Laporan mengonversi setiap laporan dalam database atau file proyek ke 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) dan Fitur Laporan Akses yang Didukung (SSRS).

  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 di RDL. Saat Anda menulis laporan di Perancang Laporan, laporan disimpan dalam format XML sebagai file Report Definition Language (RDL). Anda dapat mengedit file ini di Perancang Laporan, editor teks, atau alat apa pun tempat Anda dapat mengedit XML.

  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 (SSRS).

  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 bahwa karakter khusus XML yang digunakan dalam elemen dikodekan dengan benar. Saat Anda menerbitkan laporan, server laporan menggunakan skema untuk memvalidasi XML yang terkandung dalam file RDL.

  Untuk menyertakan elemen yang bukan bagian dari skema RDL, letakkan di Elemen Kustom. Ekstensi penyajian kustom dapat membaca elemen Kustom. Tapi, ekstensi penyajian yang disediakan Reporting Services mengabaikan elemen . Misalnya, Anda dapat menggunakan elemen Kustom untuk menyimpan komentar dalam laporan.

  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).

Bagian laporan dapat disebarkan secara independen dari item lain dalam proyek dengan menggunakan TargetReportPartFolder dan properti lainnya. Untuk informasi selengkapnya, lihat Mengatur Properti Penyebaran (Reporting Services).

Sumber daya

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

Tata letak laporan yang dipaginasi

Untuk membuat tata letak laporan, seret item laporan dan wilayah data dari Kotak Alat ke permukaan desain dan susun. Seret bidang himpunan data ke item di permukaan desain untuk menambahkan data ke laporan. Untuk menata data dalam grup di wilayah data tablix, seret bidang himpunan data ke panel Pengelompokan. Karena alat penulisan laporan pada dasarnya adalah cara untuk membuat definisi laporan, pendekatan untuk desain laporan mirip antara Report Builder dan Perancang Laporan.

Mempratinjau laporan paginated

Gunakan Pratinjau untuk memverifikasi data laporan dan desain tata letak. Saat Anda mempratinjau laporan, prosesor laporan memvalidasi skema definisi laporan dan sintaks ekspresi dan 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 <reportname>.rdl.data dalam direktori yang sama dengan file definisi laporan. File tidak dihapus ketika Anda menutup Perancang Laporan.

Anda bisa mempratinjau laporan dengan cara berikut:

• Tampilan pratinjau. Pilih tab Pratinjau . Laporan berjalan secara lokal, dan menggunakan fungsionalitas pemrosesan dan penyajian laporan yang sama yang disediakan dengan 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. Jalankan 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, pilih Mulai Debugging.

  • Pada toolbar standar Visual Studio, pilih tombol Mulai .

  • Tekan F5.

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

  Catatan

  Untuk menggunakan mode Debug, Anda harus mengatur item mulai. Di Penjelajah Solusi, klik kanan proyek laporan, klik Properti, dan di StartItem, pilih nama laporan yang akan ditampilkan.

  Jika Anda ingin mempratinjau laporan tertentu yang bukan item mulai untuk proyek, pilih konfigurasi yang membangun laporan tetapi tidak menyebarkannya (misalnya, konfigurasi DebugLocal), klik kanan laporan, lalu pilih Jalankan. Anda harus memilih konfigurasi yang tidak menyebarkan laporan. Jika tidak, laporan tidak 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 oleh 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. Pilih tombol Pratinjau Cetak pada toolbar pratinjau. Laporan ditampilkan seolah-olah berada di halaman fisik. Tampilan ini menyerupan output yang dihasilkan oleh ekstensi rendering 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, mengatur lebar halaman.

  Pratinjau cetak membantu Anda mengidentifikasi banyak 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.

  • Pemisah halaman antar grup tidak berfungsi seperti yang Anda inginkan.

  • Header dan footer tidak ditampilkan seperti yang diharapkan.

  • Tata letak laporan perlu modifikasi untuk membaca dengan lebih baik dalam format cetak.

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, penting untuk dipahami bahwa Anda merancang laporan dengan menggunakan skema definisi laporan yang didukung versi Reporting Services saat ini di SQL Server Data Tools (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 tingkat bawah, 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 disebarkan ada di folder build.

Catatan

Untuk ekspresi penelusuran kesalahan dan kesalahan penyebaran, Anda harus melihat definisi laporan di folder build. Jangan gunakan Tampilkan Sumber. Lihat Sumber menampilkan sumber definisi laporan dari folder proyek.

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

Menyimpan laporan secara lokal

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

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

Menyebarkan atau menerbitkan laporan yang dipaginasi

Dari SQL Server Data Tools, Anda dapat menyebarkan laporan atau item proyek lainnya ke beberapa versi server laporan Reporting Services. Gunakan konfigurasi proyek untuk mengontrol peningkatan definisi laporan ke versi skema yang kompatibel dengan server laporan target. Properti yang dikontrol oleh konfigurasi proyek mencakup 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 dan format ini memengaruhi bagaimana beberapa tata letak laporan dan fungsi fitur interaktivitas. Untuk informasi selengkapnya tentang pertimbangan desain untuk berbagai format output, lihat Laporan Ekspor (Pembuat Laporan dan SSRS).

Melaporkan validasi dan tingkat kesalahan

Laporan divalidasi sebelum pratinjau dan selama penyebaran. Banyak masalah build dapat terjadi saat laporan dibuat. Laporan mungkin berisi string seperti ekspresi atau kueri yang tidak kompatibel dengan versi Reporting Services yang ditentukan konfigurasi proyek, misalnya.

Gunakan properti ErrorLevel untuk mengelola peringatan dan kesalahan build. Properti ErrorLevel dapat berisi nilai 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 SQL Server Data Tools (SSDT).

Masalah dengan tingkat keparahan kurang dari atau sama dengan nilai ErrorLevel dilaporkan sebagai kesalahan; jika tidak, mereka dilaporkan sebagai peringatan.

Tabel berikut mencantumkan tingkat kesalahan.

Tingkat kesalahan	Deskripsi
0	Masalah build yang paling parah dan tidak dapat ditolak 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	Digunakan hanya untuk menerbitkan peringatan.

Saat Anda mencoba mempratinjau atau menyebarkan laporan yang berisi item laporan baru di SQL Server 2016 (13.x) Reporting Services atau yang lebih baru (SSRS), item laporan tersebut dapat dihapus dari laporan. Secara default, properti ErrorLevel dari konfigurasi diatur ke 2, yang akan menyebabkan build laporan gagal saat peta dihapus. Namun, jika Anda mengubah nilai properti ErrorLevel menjadi 0 atau 1, peta dihilangkan, peringatan dikeluarkan, dan proses build berlanjut.

Konten terkait

Mengunduh Alat Data SQL Server
Layanan Pelaporan di Alat Data SQL Server
Alat desain kueri
Penyebaran dan dukungan versi di SQL Server Data Tools

Ada pertanyaan lagi? Coba tanyakan forum Reporting Services