Akses URL (SSRS)
Akses URL server laporan di SQL Server Reporting Services (SSRS) memungkinkan Anda mengirim perintah ke server laporan melalui permintaan URL. Fungsionalitas ini memungkinkan Anda menyesuaikan bagaimana Anda merender laporan pada server laporan mode asli atau di pustaka SharePoint. Misalnya, Anda dapat melihat laporan dengan menggunakan sekumpulan nilai parameter laporan tertentu, atau Anda mungkin melihat halaman tertentu yang menarik dalam laporan. Anda dapat menentukan parameter ini dalam URL dengan menggunakan parameter akses URL yang telah ditentukan sebelumnya.
Anda dapat menyesuaikan cara server laporan memproses laporan dengan menyertakan parameter untuk format penyajian atau untuk menentukan tampilan dan nuansa penampil laporan. Anda kemudian dapat mengirim URL ini ke orang lain sehingga mereka dapat mengakses laporan Anda dengan cara yang sama di browser.
Tindakan lain yang dapat Anda lakukan melalui akses URL meliputi:
- Akses item server laporan dengan menggunakan akses URL.
- Menentukan pengaturan informasi perangkat dalam URL
- Mengatur bahasa untuk parameter laporan dalam URL
- Merender rekam jepret riwayat laporan dengan menggunakan akses URL.
- Cari laporan dengan menggunakan akses URL.
Konsep akses URL
Server laporan memproses parameter yang terkandung dalam permintaan URL ke server laporan. Cara server laporan menangani permintaan URL bergantung pada parameter, awalan parameter, dan jenis item yang disertakan dalam URL. MELAPORKAN URL server mematuhi panduan pemformatan URL yang diusulkan oleh standar draf World Wide Web Consortium W3C/IETF bersama. Fungsionalitas URL Reporting Services kompatibel dengan sebagian besar browser internet atau aplikasi yang mendukung alamat URL standar.
Sintaks akses URL
Permintaan URL dapat berisi beberapa parameter yang tercantum dalam urutan apa pun. Anda memisahkan parameter dengan menggunakan ampersand (&
) dan pasangan nama/nilai dengan tanda sama dengan (=
).
Memahami berbagai komponen string akses URL sangat penting untuk mengirim perintah secara efektif ke server laporan SSRS. String akses URL meliputi:
https://[rswebserviceurl]
: URL layanan web server laporan.?
: Menunjukkan awal string kueri yang berisi parameter.[pathinfo]
: Jalur ke laporan atau item di server.[&prefix:param=value]
: Satu atau beberapa parameter dengan awalan opsional yang menyesuaikan penyajian atau perilaku laporan.
https://[rswebserviceurl]?[pathinfo][&prefix:param=value]...[&prefix:param=value]
Deskripsi sintaks
Bagian berikut memberikan deskripsi terperinci tentang beberapa parameter yang digunakan dalam string akses URL. Untuk daftar lengkapnya, lihat Referensi parameter akses URL.
rswebserviceurl
URL layanan web server laporan.
Untuk mode asli, ini adalah URL layanan web instans server laporan layanan web yang dikonfigurasi di Reporting Services Configuration Manager. Untuk informasi selengkapnya, lihat Mengonfigurasi URL server laporan (Report Server Configuration Manager).
Contohnya:
https://myrshost/reportserver https://machine.adventure-works.com/reportserver_MYNAMEDINSTANCE
Untuk mode terintegrasi SharePoint, ini adalah URL proksi Reporting Services di situs SharePoint yang terintegrasi dengan Reporting Services.
Contohnya:
https://myspsite/subsite/_vti_bin/reportserver
Tip
Penting bagi URL untuk menyertakan
_vti_bin
sintaks proksi untuk merutekan permintaan melalui SharePoint dan proksi HTTP Reporting Services. Proksi menambahkan beberapa konteks ke permintaan HTTP, konteks yang diperlukan untuk memastikan eksekusi laporan yang tepat untuk server laporan mode SharePoint.
pathinfo
Nama jalur relatif item dalam database server laporan mode asli, atau URL item yang sepenuhnya memenuhi syarat dalam katalog SharePoint.
Jalur item katalog. Untuk mode asli, ini adalah jalur relatif item dalam database server laporan, dimulai dengan garis miring (/
). Contohnya:
/AdventureWorks2022/Employee_Sales_Summary_2022
Untuk mode terintegrasi SharePoint, ini adalah URL item yang sepenuhnya memenuhi syarat di pustaka SharePoint, termasuk ekstensi item. Contohnya:
https://myspsite/subsite/AdventureWorks2022/Employee_Sales_Summary_2022.rdl
&awalan:param=value
Dalam string akses URL, Anda menambahkan parameter dan nilai terkaitnya untuk menyesuaikan penyajian atau perilaku laporan. Anda membuat parameter dalam pasangan nama/nilai dengan menggunakan sintaks param=value
, dipisahkan oleh ampersand (&
).
Gunakan awalan opsional seperti rs:
atau rc:
untuk menargetkan proses tertentu dalam server laporan.
Catatan
Jika awalan untuk parameter akses URL tidak disertakan, parameter diproses oleh server laporan sebagai parameter laporan. Parameter laporan tidak menggunakan awalan parameter dan peka huruf besar/kecil.
Contoh berikut menunjukkan URL lengkap seperti yang dijelaskan dalam artikel ini:
https://myrshost/reportserver?/AdventureWorks2022/Employee_Sales_Summary_2022&rs:Command=Render&rc:Toolbar=false&ReportMonth=3&ReportYear=2008