Langganan dan pengiriman (Reporting Services)

Langganan Reporting Services adalah konfigurasi yang memberikan laporan pada waktu tertentu atau sebagai respons terhadap suatu peristiwa. Ini juga dalam format file yang Anda tentukan. Misalnya, setiap hari Rabu, simpan laporan MonthlySales.rdl sebagai dokumen Microsoft Word ke berbagi file. Langganan dapat digunakan untuk menjadwalkan dan mengotomatiskan pengiriman laporan dan dengan sekumpulan nilai parameter laporan tertentu.

Anda dapat membuat beberapa langganan untuk satu laporan untuk memvariasikan opsi langganan. Misalnya, Anda dapat menentukan nilai parameter yang berbeda untuk menghasilkan tiga versi laporan. Laporan ini adalah laporan seperti laporan penjualan wilayah Barat, penjualan wilayah Timur, dan semua penjualan.

Diagram of an example SSRS subscription flow.

Langganan tidak tersedia di setiap edisi SQL Server. Untuk daftar fitur yang didukung SQL Server, lihat Edisi dan fitur yang didukung SQL Server 2022.

Dalam topik ini:

Topik di bagian ini:

Skenario langganan dan pengiriman

Untuk setiap langganan, ekstensi pengiriman yang Anda pilih menentukan opsi pengiriman yang dapat Anda konfigurasi. Ekstensi pengiriman adalah modul yang mendukung beberapa cara distribusi. Reporting Services mencakup beberapa ekstensi pengiriman dan ekstensi pengiriman mungkin tersedia melalui vendor pihak ketiga.

Jika Anda adalah pengembang, Anda dapat membuat ekstensi pengiriman kustom untuk mendukung skenario lain. Untuk informasi selengkapnya, lihat Menerapkan ekstensi pengiriman.

Tabel berikut ini menjelaskan skenario langganan Reporting Services umum.

Skenario Deskripsi
Laporan Email Laporan email ke pengguna dan grup individual. Buat langganan dan tentukan alias grup atau alias email untuk menerima laporan yang ingin Anda distribusikan. Anda dapat meminta Reporting Services menentukan data langganan pada waktu proses. Jika Anda ingin mengirim laporan yang sama ke grup yang memiliki daftar anggota yang berubah, Anda bisa menggunakan kueri untuk mendapatkan daftar langganan pada waktu proses.
Menampilkan Laporan di luar baris Pengguna dapat memilih salah satu format berikut untuk output langganan:

- File XML dengan data laporan
- CSV (dibatasi koma)
-PDF
- MHTML (arsip web)
-Microsoft Excel
- File TIFF
- Microsoft Word

Laporan yang ingin Anda arsipkan dapat dikirim langsung ke folder bersama yang Anda cadangkan pada jadwal malam hari. Laporan besar yang memakan waktu terlalu lama untuk dimuat di browser dapat dikirim ke folder bersama dalam format yang dapat dilihat di aplikasi desktop.
Pramuat cache Jika Anda memiliki beberapa instans laporan berparameter atau sejumlah besar pengguna laporan yang melihat laporan, Anda dapat memuat laporan sebelumnya di cache. Pramuat mengurangi waktu pemrosesan yang diperlukan untuk menampilkan laporan.
Laporan berbasis data Gunakan langganan berbasis data untuk menyesuaikan output laporan, opsi pengiriman, dan pengaturan parameter laporan pada waktu proses. Langganan menggunakan kueri untuk mendapatkan nilai input dari sumber data pada waktu proses. Anda dapat menggunakan langganan berbasis data untuk melakukan operasi penggabungan email yang mengirim laporan ke daftar pelanggan yang ditentukan pada saat langganan diproses.

Langganan standar dan berbasis data

Reporting Services mendukung dua jenis langganan: standar dan berbasis data. Pengguna individual membuat dan mengelola langganan standar. Langganan standar terdiri dari nilai statis yang tidak dapat bervariasi selama pemrosesan langganan. Untuk setiap langganan standar, ada tepat satu set opsi presentasi laporan, opsi pengiriman, dan parameter laporan.

Langganan berbasis data mendapatkan informasi langganan pada waktu proses dengan mengkueri sumber data eksternal yang menyediakan nilai yang digunakan untuk menentukan penerima, parameter laporan, atau format aplikasi. Anda mungkin menggunakan langganan berbasis data jika Anda memiliki daftar penerima yang besar atau jika Anda ingin memvariasikan output laporan untuk setiap penerima. Untuk menggunakan langganan berbasis data, Anda harus memiliki keahlian dalam membangun kueri dan pemahaman tentang bagaimana parameter digunakan. Administrator server laporan biasanya membuat dan mengelola langganan ini. Untuk informasi lebih lanjut, baca artikel berikut:

Persyaratan langganan

Sebelum Anda bisa membuat langganan ke laporan, prasyarat berikut harus dipenuhi:

Persyaratan Deskripsi
Izin Anda harus memiliki akses ke laporan. Sebelum bisa berlangganan laporan, Anda harus memiliki izin untuk melihatnya.

Untuk server laporan mode asli, penetapan peran berikut memengaruhi langganan:

- Tugas "Kelola langganan individual" memungkinkan pengguna membuat, memodifikasi, dan menghapus langganan untuk laporan tertentu. Dalam peran yang telah ditentukan sebelumnya, tugas ini adalah bagian dari peran Browser dan Pembuat Laporan. Penetapan peran yang menyertakan tugas ini memungkinkan pengguna untuk mengelola hanya langganan yang mereka buat.
- Tugas "Kelola semua langganan" memungkinkan pengguna mengakses dan memodifikasi semua langganan. Tugas ini diperlukan untuk membuat langganan berbasis data. Dalam peran yang telah ditentukan sebelumnya, hanya peran Pengelola Konten yang menyertakan tugas ini.
Kredensial tersimpan Untuk membuat langganan, laporan harus menggunakan kredensial tersimpan atau tanpa kredensial untuk mengambil data pada waktu proses. Anda tidak dapat berlangganan laporan yang dikonfigurasi untuk menggunakan kredensial yang ditiru atau didelegasikan pengguna saat ini untuk menyambungkan ke sumber data eksternal. Kredensial yang disimpan dapat berupa akun Windows atau akun pengguna database. Untuk informasi selengkapnya, lihat Menentukan informasi kredensial dan koneksi untuk sumber data laporan

Anda harus memiliki izin untuk menampilkan laporan dan membuat langganan individual. Peristiwa Terjadwal dan Pengiriman Laporan harus diaktifkan di server laporan. Untuk informasi selengkapnya, lihat Membuat dan mengelola langganan untuk server laporan mode asli.
Nilai dependen pengguna dalam laporan Hanya untuk langganan standar, Anda dapat membuat langganan ke laporan yang menggabungkan informasi akun pengguna dalam filter atau sebagai teks yang muncul di laporan. Dalam laporan, nama akun pengguna ditentukan melalui Pengguna! Ekspresi UserID yang diselesaikan ke pengguna saat ini. Saat Anda membuat langganan, pengguna yang membuat langganan adalah pengguna yang dianggap sebagai pengguna saat ini.
Tidak ada keamanan item model Anda tidak dapat berlangganan laporan Pembuat Laporan yang menggunakan model sebagai sumber data jika model berisi pengaturan keamanan item model. Hanya laporan yang menggunakan keamanan item model yang disertakan dalam pembatasan ini.
Nilai Parameter Jika laporan menggunakan parameter, nilai parameter harus ditentukan dengan laporan itu sendiri, atau dalam langganan yang Anda tentukan. Jika Anda menentukan nilai default dalam laporan, Anda dapat mengatur nilai parameter untuk menggunakan default.

Ekstensi pengiriman

Langganan diproses di server laporan dan didistribusikan melalui ekstensi pengiriman yang disebarkan di server. Secara default, Anda dapat membuat langganan yang mengirim laporan ke folder bersama atau ke alamat email. Jika server laporan dikonfigurasi untuk mode terintegrasi SharePoint, Anda juga bisa mengirim laporan ke pustaka SharePoint.

Saat pengguna membuat langganan, mereka dapat memilih salah satu ekstensi pengiriman yang tersedia untuk menentukan bagaimana laporan dikirimkan. Reporting Services mencakup ekstensi pengiriman berikut.

Ekstensi Pengiriman Deskripsi
Berbagi File Windows Mengirimkan laporan sebagai file aplikasi statis ke folder bersama yang dapat diakses di jaringan.
Email Mengirimkan pemberitahuan atau laporan sebagai lampiran email atau tautan URL.
Pustaka SharePoint Mengirimkan laporan sebagai file aplikasi statis ke pustaka SharePoint yang dapat diakses dari situs SharePoint. Situs harus diintegrasikan dengan server laporan yang berjalan dalam mode terintegrasi SharePoint.
Null Penyedia pengiriman null adalah ekstensi pengiriman yang sangat khusus yang digunakan untuk memuat cache dengan laporan parameter yang siap dilihat Metode ini tidak tersedia untuk pengguna dalam langganan individual. Pengiriman null digunakan oleh administrator dalam langganan berbasis data untuk meningkatkan performa server laporan dengan memuat cache sebelumnya.

Catatan

Pengiriman laporan adalah bagian yang dapat diperluas dari arsitektur Reporting Services. Vendor pihak ketiga dapat membuat ekstensi pengiriman kustom untuk merutekan laporan ke lokasi atau perangkat yang berbeda. Untuk informasi selengkapnya tentang ekstensi pengiriman kustom, lihat Menerapkan ekstensi pengiriman.

Bagian langganan

Definisi langganan terdiri dari bagian-bagian berikut:

  • Penunjuk ke laporan yang dapat berjalan tanpa pengawas (yaitu, laporan yang menggunakan kredensial tersimpan atau tanpa kredensial).

  • Metode pengiriman (misalnya, email) dan pengaturan untuk mode pengiriman (seperti alamat email).

  • Ekstensi penyajian untuk menyajikan laporan dalam format tertentu.

  • Kondisi untuk memproses langganan, yang dinyatakan sebagai peristiwa.

    Biasanya, kondisi untuk menjalankan laporan berbasis waktu. Misalnya, Anda mungkin ingin menjalankan laporan tertentu setiap Hari Selasa pukul 15.00 UTC. Namun, jika laporan berjalan sebagai rekam jepret, Anda dapat menentukan bahwa langganan berjalan setiap kali rekam jepret di-refresh.

  • Parameter yang digunakan saat menjalankan laporan.

    Parameter bersifat opsional dan hanya ditentukan untuk laporan yang menerima nilai parameter. Karena langganan biasanya dimiliki pengguna, nilai parameter yang ditentukan bervariasi dari langganan ke langganan. Misalnya, manajer penjualan untuk divisi yang berbeda menggunakan parameter yang mengembalikan data untuk divisi mereka. Semua parameter harus memiliki nilai yang ditentukan secara eksplisit, atau memiliki nilai default yang valid.

Informasi langganan disimpan dengan laporan individual dalam database server laporan. Anda tidak dapat mengelola langganan secara terpisah dari laporan yang terkait dengan langganan tersebut. Langganan tidak dapat diperluas untuk menyertakan deskripsi, teks kustom lainnya, atau elemen lainnya. Langganan hanya dapat berisi item yang tercantum sebelumnya.

Cara langganan diproses

Reporting Services mencakup penjadwalan dan prosesor pengiriman, yang menyediakan fungsionalitas untuk menjadwalkan laporan dan mengirimkannya kepada pengguna. Server laporan merespons peristiwa yang dipantaunya secara berkelanjutan. Ketika peristiwa terjadi yang cocok dengan kondisi yang ditentukan untuk langganan, server laporan membaca langganan untuk menentukan cara memproses dan mengirimkan laporan. Server laporan meminta ekstensi pengiriman yang ditentukan dalam langganan. Setelah ekstensi pengiriman berjalan, server laporan mengekstrak informasi pengiriman dari langganan dan meneruskannya ke ekstensi pengiriman untuk diproses.

Ekstensi pengiriman merender laporan dalam format yang ditentukan dalam langganan lalu mengirimkan laporan atau pemberitahuan ke tujuan yang ditentukan. Jika laporan tidak dapat dikirimkan, entri dicatat ke file log server laporan. Jika Anda ingin mendukung operasi coba lagi, Anda dapat mengonfigurasi server laporan untuk memasang ulang pengiriman jika upaya pertama gagal.

Memproses langganan standar

Langganan standar menghasilkan satu instans laporan. Laporan dikirimkan ke satu folder bersama atau ke alamat email yang ditentukan dalam langganan. Tata letak laporan dan data tidak bervariasi. Jika laporan menggunakan parameter, langganan standar diproses dengan satu nilai untuk setiap parameter dalam laporan.

Memproses langganan berbasis data

Langganan berbasis data dapat menghasilkan banyak instans laporan yang dikirimkan ke beberapa tujuan. Tata letak laporan tidak bervariasi, tetapi data dalam laporan dapat bervariasi jika nilai parameter diteruskan dari kumpulan hasil pelanggan. Opsi pengiriman yang memengaruhi cara laporan dirender dan apakah laporan dilampirkan atau ditautkan ke email. Opsi ini juga dapat bervariasi dari pelanggan ke pelanggan saat nilai diteruskan dari kumpulan baris.

Langganan berbasis data dapat menghasilkan sejumlah besar pengiriman. Server laporan membuat pengiriman untuk setiap baris dalam kumpulan baris yang dikembalikan dari kueri langganan.

Karakteristik pengiriman laporan

Laporan yang dikirimkan melalui langganan standar biasanya dirender sebagai laporan statis. Laporan ini didasarkan pada rekam jepret eksekusi laporan terbaru, atau dihasilkan sebagai laporan statis untuk menyelesaikan pengiriman. Jika Anda memilih opsi Sertakan Tautan dalam langganan ke laporan yang berjalan sesuai permintaan, server laporan menjalankan laporan saat Anda memilih hyperlink.

Catatan

Laporan yang dikirimkan melalui URL tetap tersambung ke server laporan dan dapat diperbarui atau dihapus di antara tampilan. Opsi pengiriman yang Anda pilih untuk langganan Anda menentukan apakah laporan dikirimkan sebagai URL, disematkan dalam isi pesan email, atau dikirim sebagai lampiran.

Laporan yang dikirimkan melalui langganan berbasis data mungkin diregenerasi saat langganan sedang diproses. Server laporan tidak mengunci instans laporan tertentu atau himpunan datanya untuk menyelesaikan langganan berbasis data. Jika langganan menggunakan nilai parameter yang berbeda untuk pelanggan yang berbeda, server laporan meregenerasi laporan untuk menghasilkan hasil yang diperlukan. Data yang mendasar mungkin diperbarui setelah salinan laporan pertama dibuat dan dikirimkan. Saat Anda memperbarui laporan, pengguna yang mendapatkan laporan nanti dalam proses mungkin melihat data yang didasarkan pada kumpulan hasil yang berbeda. Anda dapat menggunakan laporan yang berjalan sebagai rekam jepret untuk memastikan bahwa instans laporan yang sama dikirimkan ke semua pelanggan. Namun, jika pembaruan terjadwal ke rekam jepret terjadi saat langganan sedang diproses, pengguna mungkin masih mendapatkan data yang berbeda dalam laporan mereka.

Memicu pemrosesan langganan

Server laporan menggunakan dua jenis peristiwa untuk memicu pemrosesan langganan: peristiwa berbasis waktu yang ditentukan dalam jadwal atau peristiwa pembaruan rekam jepret.

Pemicu berbasis waktu menggunakan jadwal khusus laporan atau jadwal bersama untuk menentukan kapan langganan berjalan. Untuk laporan sesuai permintaan dan cache, jadwal adalah satu-satunya opsi pemicu.

Peristiwa pembaruan rekam jepret menggunakan pembaruan terjadwal rekam jepret laporan untuk memicu langganan. Anda dapat menentukan langganan yang dipicu setiap kali laporan diperbarui dengan data baru. Langganan dipicu berdasarkan properti eksekusi laporan yang ditetapkan pada laporan.

Kontrol terprogram langganan

Model objek Reporting Services memungkinkan Anda mengaudit dan mengontrol langganan dan pemrosesan langganan secara terprogram. Lihat artikel berikut ini untuk contoh dan memulai:

Membuat langganan berbasis data (tutorial SSRS)
Jadwal
Server laporan Reporting Services (mode asli)
Memantau langganan Reporting Services