Menyebarkan ekstensi penyajian

  • Artikel

Setelah Anda menulis dan mengkompilasi ekstensi penyajian laporan Reporting Services Anda ke dalam pustaka .NET Framework, Anda perlu membuatnya dapat ditemukan oleh server laporan dan dengan Perancang Laporan. Untuk melakukannya, salin ekstensi ke direktori yang sesuai dan tambahkan entri ke file konfigurasi Reporting Services yang sesuai.

Elemen Ekstensi penyajian file konfigurasi

Setelah ekstensi penyajian dikompilasi ke dalam .DLL, Anda menambahkan entri ke dalam file rsreportserver.config. Secara default, lokasinya adalah %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer. Elemen induknya adalah \<Render>. Di bawah elemen Render, adalah elemen Ekstensi untuk setiap ekstensi penyajian. Elemen Ekstensi berisi dua atribut, Nama dan Jenis.

Tabel berikut ini menjelaskan atribut untuk elemen Ekstensi untuk ekstensi penyajian:

Atribut KETERANGAN
Nama Nama unik untuk ekstensi. Panjang maksimum untuk atribut Nama adalah 255 karakter. Nama harus unik di antara semua entri dalam elemen Ekstensi dari file konfigurasi. Jika ada nama duplikat, server laporan mengembalikan kesalahan.
Jenis Daftar yang dipisahkan koma yang menyertakan namespace layanan yang sepenuhnya memenuhi syarat bersama dengan nama rakitan.
Dapat dilihat Nilai false menunjukkan bahwa ekstensi penyajian tidak boleh terlihat di antarmuka pengguna. Jika atribut tidak disertakan, nilai defaultnya adalah true.
LogAllExecutionRequests Nilai false menunjukkan bahwa entri dicatat hanya untuk eksekusi laporan pertama dalam sesi. Jika atribut tidak disertakan, nilai defaultnya adalah true.

Misalnya, pengaturan ini menentukan apakah akan mencatat entri hanya untuk halaman pertama yang dirender dalam laporan (ketika salah) atau entri untuk setiap halaman yang dirender dalam laporan (jika benar).

Untuk informasi selengkapnya, lihat file konfigurasi RsReportServer.config.

Menyebarkan ekstensi ke server laporan

Server laporan menggunakan ekstensi penyajian untuk mengekspor laporan ke format lain. Anda harus menyebarkan rakitan ekstensi penyajian Anda ke server laporan sebagai rakitan privat. Anda juga perlu membuat entri dalam file konfigurasi server laporan, rsreportserver.config.

Menyebarkan assembly

  1. Salin assembly Anda dari lokasi penahapan Anda ke direktori bin server laporan tempat Anda ingin menggunakan ekstensi penyajian. Lokasi default direktori Bin server laporan adalah %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer\Bin.

  2. Setelah file rakitan disalin, buka file rsreportserver.config. File rsreportserver.config juga terletak di direktori bin server laporan. Anda perlu membuat entri dalam file konfigurasi untuk file rakitan ekstensi Anda. Anda dapat membuka file dengan Visual Studio atau editor teks sederhana.

    Untuk informasi selengkapnya, lihat file konfigurasi RsReportServer.config.

  3. Temukan elemen Render di file Rsreportserver.config. Entri untuk ekstensi yang baru Dibuat harus dibuat di lokasi berikut:

    <Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>

  4. Tambahkan entri untuk ekstensi penyajian Anda. Entri Anda harus menyertakan elemen yang memiliki nilai untuk Nama dan Jenis, dan mungkin terlihat seperti berikut ini:

    <Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />

    Nilai untuk Nama adalah nama unik ekstensi penyajian. Nilai untuk Jenis adalah daftar yang dipisahkan koma yang menyertakan entri untuk namespace yang sepenuhnya memenuhi syarat dari implementasi Anda IRenderingExtension , diikuti dengan nama assembly Anda (tidak termasuk ekstensi file .dll). Secara default, ekstensi penyajian terlihat. Untuk menyembunyikan ekstensi dari antarmuka pengguna, seperti Report Manager, tambahkan atribut Visible ke elemen Extension , dan atur ke false.

Verifikasi penyebaran

Anda juga dapat membuka Manajer Laporan dan memverifikasi bahwa ekstensi Anda disertakan dalam daftar jenis ekspor yang tersedia untuk laporan.

Konten terkait