Referensi parameter akses URL

  • Artikel

Anda dapat menggunakan parameter berikut sebagai bagian dari URL untuk mengonfigurasi tampilan dan nuansa SQL Server 2016 (13.x) Reporting Services atau yang lebih baru (SSRS). Parameter yang paling umum tercantum di bagian ini. Parameter tidak peka huruf besar/kecil dan dimulai dengan prefiks parameter rs: jika diarahkan ke server laporan dan rc: jika diarahkan ke Penampil HTML. Anda juga dapat menentukan parameter yang khusus untuk perangkat atau ekstensi penyajian. Untuk informasi selengkapnya tentang parameter khusus perangkat, lihat Menentukan pengaturan informasi perangkat di URL.

Penting

Untuk server laporan mode SharePoint, penting bahwa URL menyertakan _vti_bin sintaks proksi untuk merutekan permintaan melalui SharePoint dan proksi HTTP Reporting Services. Proksi menambahkan konteks ke permintaan HTTP yang diperlukan untuk memastikan eksekusi laporan yang tepat untuk server laporan mode SharePoint. Misalnya, lihat Mengakses item server laporan dengan menggunakan akses URL.

Integrasi Reporting Services dengan SharePoint tidak lagi tersedia setelah SQL Server 2016.

Perintah Penampil HTML (rc:)

  • Perintah Penampil HTML digunakan untuk menargetkan Penampil HTML dan diawali dengan rc::

  • Toolbar: Menampilkan atau menyembunyikan bilah alat. Jika nilai parameter ini salah, semua opsi yang tersisa diabaikan. Jika Anda menghilangkan parameter ini, toolbar secara otomatis ditampilkan untuk format penyajian yang mendukungnya. Default parameter ini adalah true.

    Penting

    rc:Toolbar=false tidak berfungsi untuk string akses URL yang menggunakan alamat IP, bukan nama domain, untuk menargetkan laporan yang dihosting di situs SharePoint.

  • Parameter: Menampilkan atau menyembunyikan area parameter toolbar. Jika Anda mengatur parameter ini ke true, area parameter toolbar ditampilkan. Jika Anda mengatur parameter ini ke false, area parameter tidak ditampilkan dan tidak dapat ditampilkan oleh pengguna. Jika Anda mengatur parameter ini ke nilai Diciutkan, area parameter tidak ditampilkan tetapi dapat dialihkan oleh pengguna. Nilai default parameter ini adalah true.

    Misalnya, dalam mode asli:

    https://myrshost/reportserver?/Sales&rc:Parameters=Collapsed

    Misalnya, dalam mode SharePoint:

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Parameters=Collapsed

  • Zoom: Mengatur nilai zoom laporan sebagai persentase bilangan bulat atau konstanta string. Nilai string standar mencakup Lebar Halaman dan Halaman Siapa le. Versi Internet Explorer yang lebih lama dari Internet Explorer 5.0 dan semua browser non-Microsoft mengabaikan parameter ini. Nilai default parameter ini adalah 100.

    Misalnya, dalam mode asli:

    https://myrshost/reportserver?/Sales&rc:Zoom=Page Width

    Misalnya, dalam mode SharePoint:

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Zoom=Page Width

  • Bagian: Mengatur halaman mana dalam laporan yang akan ditampilkan. Nilai apa pun yang lebih besar dari jumlah halaman dalam laporan menampilkan halaman terakhir. Nilai apa pun yang kurang dari 0 menampilkan halaman 1 dari laporan. Nilai default parameter ini adalah 1.

    Misalnya dalam mode asli, untuk menampilkan halaman 2 laporan:

    https://myrshost/reportserver?/Sales&rc:Section=2

    Untuk contoh dalam mode SharePoint, untuk menampilkan halaman 2 laporan:

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Section=2

  • FindString: Mencari laporan untuk sekumpulan teks tertentu dan menyoroti teks.

    Penting

    rc:FindString tidak berfungsi kecuali Anda menyertakan rc:Toolbar=false ke string akses URL.

    Misalnya, dalam mode asli:

    https://myrshost/reportserver?/Sales&rc:Toolbar=false&rc:FindString=Mountain-400

    Misalnya, dalam mode SharePoint:

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rc:Toolbar=false&rc:FindString=Mountain-400

  • StartFind: Menentukan bagian terakhir yang akan dicari. Nilai default parameter ini adalah halaman terakhir dari laporan.

    Untuk contoh dalam mode asli yang mencari kemunculan pertama teks "Mountain-400" dalam laporan sampel Katalog Produk yang dimulai dengan halaman 1 dan berakhir dengan halaman 5:

    https://server/Reportserver?/SampleReports/Product Catalog&rs:Command=Render&rc:StartFind=1&rc:EndFind=5&rc:FindString=Mountain-400

  • EndFind: Mengatur jumlah halaman terakhir yang akan digunakan dalam pencarian. Misalnya, nilai 5 menunjukkan bahwa halaman terakhir yang akan dicari adalah halaman 5 dari laporan. Nilai default adalah jumlah halaman saat ini. Gunakan parameter ini dengan parameter StartFind . Lihat contoh sebelumnya.

  • FallbackPage: Mengatur jumlah halaman yang akan ditampilkan jika pencarian atau pemilihan peta dokumen gagal. Nilai default adalah jumlah halaman saat ini.

  • GetImage: Mendapatkan ikon tertentu untuk antarmuka pengguna Penampil HTML.

  • Ikon: Mendapatkan ikon ekstensi penyajian tertentu.

  • Lembar gaya: Menentukan lembar gaya yang akan diterapkan ke Penampil HTML.

  • Pengaturan Informasi Perangkat: Menentukan pengaturan informasi perangkat dalam bentuk rc:tag=value, di mana tag adalah nama pengaturan informasi perangkat khusus untuk ekstensi penyajian yang saat ini digunakan. (Lihat deskripsi untuk Parameter format .) Misalnya, Anda dapat menggunakan pengaturan informasi perangkat OutputFormat untuk ekstensi penyajian GAMBAR untuk merender laporan ke gambar JPEG dengan menggunakan parameter berikut dalam string akses URL: ...&rs:Format=IMAGE&rc:OutputFormat=JPEG. Untuk informasi selengkapnya tentang semua pengaturan informasi perangkat khusus ekstensi, lihat Pengaturan informasi perangkat untuk ekstensi penyajian (Reporting Services).

Perintah server laporan (rs:)

Perintah server laporan diawali dengan rs: dan digunakan untuk menargetkan server laporan:

  • Perintah: Melakukan tindakan pada item katalog, bergantung pada jenis itemnya. Nilai default ditentukan oleh jenis item katalog yang dirujuk dalam string akses URL. Nilai yang valid adalah:

    • ListChildren dan GetChildren: Menampilkan konten folder. Item folder ditampilkan dalam halaman navigasi item generik.

      Misalnya, dalam mode asli:

      https://myrshost/reportserver?/Sales&rs:Command=GetChildren

      Misalnya, instans bernama dalam mode asli:

      https://myssrshost/Reportserver_THESQLINSTANCE?/reportfolder&rs:Command=listChildren

      Misalnya, dalam mode SharePoint:

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales&rs:Command=GetChildren

    • Render: Laporan dirender di browser sehingga Anda dapat melihatnya.

      Misalnya, dalam mode asli:

      https://myrshost/reportserver?/Sales/YearlySalesByCategory&rs:Command=Render

      Misalnya, dalam mode SharePoint:

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/YearlySalesByCategory&rs:Command=Render

    • GetSharedDatasetDefinition: Menampilkan definisi XML yang terkait dengan himpunan data bersama. Properti himpunan data bersama, termasuk kueri, parameter himpunan data, nilai default, filter himpunan data, dan opsi data seperti kolase dan sensitivitas huruf besar/kecil, disimpan dalam definisi. Anda harus memiliki izin Baca Definisi Laporan pada himpunan data bersama untuk menggunakan nilai ini.

      Misalnya, dalam mode asli:

      https://localhost/reportserver/?/DataSet1&rs:command=GetShareddatasetDefinition

    • GetDataSourceContents: Menampilkan properti sumber data bersama tertentu sebagai XML. Jika browser Anda mendukung XML dan jika Anda adalah pengguna terautentikasi dengan izin Baca Konten pada sumber data, definisi sumber data akan ditampilkan.

      Misalnya, dalam mode asli:

      https://myrshost/reportserver?/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

      Misalnya, dalam mode SharePoint:

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/AdventureWorks2022&rs:Command=GetDataSourceContents

    • GetResourceContents: Merender sumber daya dan menampilkannya di halaman HTML jika sumber daya kompatibel dengan browser. Jika tidak, Anda diminta untuk membuka atau menyimpan file atau sumber daya ke disk.

      Misalnya, dalam mode asli:

      https://myrshost/reportserver?/Sales/StorePicture&rs:Command=GetResourceContents

      Misalnya, dalam mode SharePoint:

      https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/Sales/StorePicture.jpg&rs:Command=GetResourceContents

    • GetComponentDefinition: Menampilkan definisi XML yang terkait dengan item laporan yang diterbitkan. Anda harus memiliki izin Baca Konten pada item laporan yang diterbitkan untuk menggunakan nilai ini.

  • Format: Menentukan format untuk merender dan menampilkan laporan. Nilai umum meliputi:

    • HTML5

    • PPTX

    • ATOM

    • HTML4.0

    • MHTML

    • GAMBAR

    • EXCEL (untuk .xls)

    • EXCELOPENXML (untuk .xlsx)

    • WORD (untuk .doc)

    • WORDOPENXML (untuk .docx)

    • CSV

    • PDF

    • XML

    Nilai defaultnya adalah HTML5. Untuk informasi selengkapnya, lihat Mengekspor laporan menggunakan akses URL.

    Untuk daftar lengkapnya, lihat <bagian Render> ekstensi file rsreportserver.config server laporan. Untuk informasi tentang tempat menemukan file, lihat file konfigurasi RsReportServer.config.

    Misalnya, untuk mendapatkan salinan PDF laporan langsung dari server laporan mode asli:

    https://myrshost/ReportServer?/myreport&rs:Format=PDF

    Misalnya, untuk mendapatkan salinan PDF laporan langsung dari server laporan mode SharePoint:

    https://myspsite/subsite/_vti_bin/reportserver?https://myspsite/subsite/myrereport.rdl&rs:Format=PDF

  • ParameterLanguage: Menyediakan bahasa untuk parameter yang diteruskan dalam URL yang independen dari bahasa browser. Nilai defaultnya adalah bahasa browser. Nilainya bisa menjadi nilai budaya, seperti en-us atau de-de.

    Misalnya, dalam mode asli, untuk mengambil alih bahasa browser dan menentukan nilai budaya de-DE:

    https://myrshost/Reportserver?/SampleReports/Product+Line+Sales&rs:Command=Render&StartDate=4/10/2008&EndDate=11/10/2008&rs:ParameterLanguage=de-DE

  • Rekam jepret: Merender laporan berdasarkan rekam jepret riwayat laporan. Untuk informasi selengkapnya, lihat Merender rekam jepret riwayat laporan menggunakan akses URL.

    Misalnya, dalam mode asli, ambil rekam jepret riwayat laporan tanggal 2003-04-07 dengan stempel waktu 13:40:02:

    https://myrshost/reportserver?/SampleReports/Company Sales&rs:Snapshot=2003-04-07T13:40:02

  • Bertahan Aliran: Merender laporan dalam satu aliran yang bertahan. Parameter ini digunakan oleh perender Gambar untuk mengirimkan laporan yang dirender satu gugus sekaligus. Setelah menggunakan parameter ini dalam string akses URL, gunakan string akses URL yang sama dengan parameter GetNextStream alih-alih parameter Persist Aliran untuk mendapatkan gugus berikutnya di aliran yang bertahan. Perintah URL ini akhirnya mengembalikan aliran 0-byte untuk menunjukkan akhir aliran yang bertahan. Nilai default-nya adalah salah.

  • GetNextStream: Mendapatkan potongan data berikutnya dalam aliran persisten yang diakses dengan menggunakan parameter Persist Aliran. Untuk informasi selengkapnya, lihat deskripsi untuk Persist Aliran. Nilai default-nya adalah salah.

  • SessionID: Menentukan sesi laporan aktif yang dibuat antara aplikasi klien dan server laporan. Nilai parameter ini diatur ke pengidentifikasi sesi.

    Anda dapat menentukan ID sesi sebagai cookie atau sebagai bagian dari URL. Ketika server laporan telah dikonfigurasi untuk tidak menggunakan cookie sesi, permintaan pertama tanpa ID sesi tertentu menghasilkan pengalihan dengan ID sesi. Untuk informasi selengkapnya tentang sesi server laporan, lihat Mengidentifikasi status eksekusi.

  • ClearSession: Nilai true mengarahkan server laporan untuk menghapus laporan dari sesi laporan. Semua instans laporan yang terkait dengan pengguna terautentikasi dihapus dari sesi laporan. (Instans laporan didefinisikan sebagai laporan yang sama berjalan beberapa kali dengan nilai parameter laporan yang berbeda.) Nilai defaultnya adalah false.

  • ResetSession: Nilai true mengarahkan server laporan untuk mengatur ulang sesi laporan dengan menghapus asosiasi sesi laporan dengan semua rekam jepret laporan. Nilai default-nya adalah salah.

  • ShowHideToggle: Beralih ke tampilkan dan sembunyikan status bagian laporan. Tentukan bilangan bulat positif untuk mewakili bagian yang akan dialihkan.

Perintah bagian web Penampil Laporan (rv:)

Nama parameter laporan terpesan SQL Server berikut digunakan untuk menargetkan bagian web Penampil Laporan yang terintegrasi dengan SharePoint. Nama parameter ini diawali dengan rv:. Bagian web Penampil Laporan juga menerima parameter rs:ParameterLanguage .

  • Toolbar: Mengontrol tampilan toolbar untuk komponen web Penampil Laporan. Nilai defaultnya adalah Penuh. Nilai dapat berupa:

    • Penuh: Menampilkan toolbar lengkap.

    • Navigasi: Hanya menampilkan penomoran halaman di toolbar.

    • Tidak Ada: Tidak menampilkan toolbar.

    Misalnya, dalam mode SharePoint, untuk menampilkan hanya penomoran halaman di toolbar:

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:Toolbar=Navigation

  • HeaderArea: Mengontrol tampilan header untuk bagian web Penampil Laporan. Nilai defaultnya adalah Penuh. Nilai dapat berupa:

    • Penuh: Menampilkan header lengkap.

    • BreadCrumbsOnly: Hanya menampilkan navigasi breadcrumb di header untuk memberi tahu pengguna di mana mereka berada dalam aplikasi.

    • Tidak ada: Tidak menampilkan header.

    Misalnya, dalam mode SharePoint, untuk hanya menampilkan navigasi breadcrumb di header:

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:HeaderArea=BreadCrumbsOnly

  • DocMapAreaWidth: Mengontrol lebar tampilan, dalam piksel, dari area parameter di bagian web Penampil Laporan. Nilai defaultnya sama dengan default komponen web Penampil Laporan. Nilai harus berupa bilangan bulat non-negatif.

  • AsyncRender: Mengontrol apakah laporan dirender secara asinkron. Nilai default adalah true, yang menentukan bahwa laporan dirender secara asinkron. Nilai harus berupa nilai Boolean true atau false.

  • ParamMode: Mengontrol bagaimana area perintah parameter bagian web Penampil Laporan ditampilkan dalam tampilan halaman penuh. Nilai defaultnya adalah Penuh. Nilai yang valid adalah:

    • Penuh: Menampilkan area permintaan parameter.

    • Diciutkan: Menciutkan area permintaan parameter.

    • Tersembunyi: Menyembunyikan area permintaan parameter.

    Misalnya, dalam mode SharePoint, untuk menciutkan area permintaan parameter:

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ParamMode=Collapsed

  • DocMapMode: Mengontrol bagaimana area peta dokumen bagian web Penampil Laporan ditampilkan dalam tampilan halaman penuh. Nilai defaultnya adalah Penuh. Nilai yang valid adalah:

    • Penuh: Menampilkan area peta dokumen.

    • Diciutkan: Menciutkan area peta dokumen.

    • Tersembunyi: Menyembunyikan area peta dokumen.

  • DockToolBar: Mengontrol apakah toolbar bagian web Penampil Laporan ditambatkan ke bagian atas atau bawah. Nilai yang valid adalah Atas dan Bawah. Nilai defaultnya adalah Top.

    Misalnya, dalam mode SharePoint, untuk menambatkan toolbar ke bagian bawah:

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:DockToolBar=Bottom

  • ToolBarItemsDisplayMode: Mengontrol item toolbar mana yang ditampilkan. Ini adalah nilai enumerasi bitwise. Untuk menyertakan item toolbar, tambahkan nilai item ke nilai total. Misalnya, untuk tidak ada menu Tindakan , gunakan rv:ToolBarItemsDisplayMode=63 (atau 0x3F), yaitu 1+2+4+8+16+32. Hanya untuk item menu Tindakan , gunakan rv:ToolBarItemsDisplayMode=960 (atau 0x3C0). Nilai defaultnya adalah -1, yang mencakup semua item toolbar. Nilai yang valid adalah:

    • 1 (0x1): Tombol Kembali

    • 2 (0x2): Kontrol pencarian teks

    • 4 (0x4): Kontrol navigasi halaman

    • 8 (0x8): Tombol Refresh

    • 16 (0x10): Kotak daftar Zoom

    • 32 (0x20): Tombol Umpan Atom

    • 64 (0x40): Opsi menu Cetak di Tindakan

    • 128 (0x80): Submenu Ekspor dalam Tindakan

    • 256 (0x100): Opsi menu Buka dengan Pembuat Laporan di Tindakan

    • 512 (0x200): Opsi menu Berlangganan di Tindakan

    • 1024 (0x400): Opsi menu Pemberitahuan Data Baru di Tindakan

    Misalnya, dalam mode SharePoint untuk hanya menampilkan tombol Kembali , kontrol pencarian teks, kontrol navigasi halaman, dan tombol Refresh :

    https://myspsite/_vti_bin/reportserver?https://myspsite002%fShared+Documents%2fmyreport.rdl&rv:DocMapMode=Displayed&rv:ToolBarItemsDisplayMode=15

Konten terkait