Menyebarkan ekstensi pengiriman

  • Artikel

Ekstensi pengiriman menyediakan informasi konfigurasi mereka dalam bentuk file konfigurasi XML. File XML sesuai dengan skema XML yang ditentukan untuk ekstensi pengiriman. Ekstensi pengiriman menyediakan infrastruktur untuk mengatur dan memodifikasi file konfigurasi.

Jika ekstensi pengiriman diganti atau ditingkatkan, semua langganan yang mereferensikan ekstensi pengiriman tetap valid.

Setelah Menulis dan mengkompilasi ekstensi pengiriman Reporting Services ke pustaka Microsoft .NET Framework, Anda harus menyalin ekstensi ke direktori yang sesuai dan menambahkan entri ke file konfigurasi Reporting Services yang sesuai sehingga server laporan dapat menemukannya.

Elemen Ekstensi file konfigurasi

Ekstensi pengiriman yang Anda sebarkan ke server laporan perlu dimasukkan sebagai elemen Ekstensi dalam file konfigurasi. File konfigurasi untuk server laporan adalah RSReportServer.config.

Tabel berikut menjelaskan atribut untuk elemen Ekstensi untuk ekstensi pengiriman.

Atribut KETERANGAN
Nama Nama unik untuk ekstensi (misalnya, "Email Server Laporan" untuk ekstensi pengiriman email atau "Report Server FileShare" untuk ekstensi pengiriman berbagi file). Panjang maksimum untuk atribut Nama adalah 255 karakter. Nama harus unik di antara semua entri dalam elemen Ekstensi 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 pengiriman tidak boleh terlihat di antarmuka pengguna. Jika atribut tidak disertakan, nilai defaultnya adalah true.

Untuk informasi selengkapnya tentang file RSReportServer.config, lihat File konfigurasi Reporting Services.

Menyebarkan ekstensi ke server laporan

Server laporan menggunakan ekstensi pengiriman untuk memproses dan mengirimkan pemberitahuan atau laporan. Anda harus menyebarkan rakitan ekstensi pengiriman Anda ke server laporan sebagai rakitan privat. Anda juga perlu membuat entri dalam file konfigurasi server laporan, RSReportServer.config.

Menyebarkan perakitan ekstensi pengiriman ke server laporan

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

    Penting

    Jika Anda mencoba menimpa rakitan ekstensi pengiriman yang ada, Anda harus terlebih dahulu menghentikan layanan Server Laporan sebelum menyalin rakitan yang diperbarui. Mulai ulang layanan Anda setelah perakitan melalui penyalinan.

  2. Setelah file rakitan disalin, buka file RSReportServer.config. File RSReportServer.config terletak di %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServer direktori. Anda perlu membuat entri dalam file konfigurasi untuk file rakitan ekstensi pengiriman Anda. Anda dapat membuka file konfigurasi dengan Microsoft Visual Studio atau editor teks sederhana, seperti Notepad.

  3. Temukan elemen Pengiriman di file RSReportServer.config. Entri untuk ekstensi pengiriman yang baru dibuat harus dibuat di lokasi berikut:

    <Extensions>  
   <Delivery>  
      <Your extension configuration information goes here>  
   </Delivery>  
</Extensions>

  4. Tambahkan entri untuk ekstensi pengiriman Anda. Entri Anda harus menyertakan elemen Ekstensi dengan nilai untuk Nama dan Jenis, dan mungkin terlihat seperti berikut ini:

    <Extension Name="My Delivery Extension Name" Type="CompanyName.ExtensionName.MyDeliveryExtensionClass, AssemblyName" />

    Nilai untuk Nama adalah nama unik ekstensi pengiriman. Nilai untuk Jenis adalah daftar yang dipisahkan IDeliveryExtension koma yang menyertakan entri untuk namespace yang sepenuhnya memenuhi syarat dari kelas Anda yang mengimplementasikan antarmuka, diikuti dengan nama rakitan Anda (tidak termasuk ekstensi file .dll). Secara default, ekstensi pengiriman terlihat. Untuk menyembunyikan ekstensi dari antarmuka pengguna, seperti portal web, tambahkan atribut Terlihat ke elemen Ekstensi , dan atur ke false.

  5. Terakhir, tambahkan grup kode untuk rakitan kustom Anda yang memberikan izin FullTrust untuk ekstensi pengiriman Anda. Anda melakukan langkah ini dengan menambahkan grup kode ke file rssrvpolicy.config yang terletak secara default di %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServer. Grup kode Anda mungkin terlihat seperti contoh berikut:

    <CodeGroup class="UnionCodeGroup"  
   version="1"  
   PermissionSetName="FullTrust"  
   Name="MyExtensionCodeGroup"  
   Description="Code group for my delivery extension">  
      <IMembershipCondition class="UrlMembershipCondition"  
         version="1"  
         Url="C:\Program Files\Microsoft SQL Server\MSRS13.<InstanceName>\Reporting Services\ReportServer\bin\MyExtensionAssembly.dll"  
       />  
</CodeGroup>

    Keanggotaan URL hanyalah salah satu dari banyak kondisi keanggotaan yang mungkin Anda pilih untuk ekstensi pengiriman Anda. Untuk informasi selengkapnya tentang keamanan akses kode di SSRS, lihat Pengembangan aman (Reporting Services)

Verifikasi penyebaran

Anda dapat memverifikasi apakah ekstensi pengiriman Anda berhasil disebarkan ke server laporan dengan menggunakan metode layanan ListExtensions Web. Anda juga dapat membuka portal web dan memverifikasi bahwa ekstensi Anda disertakan dalam daftar ekstensi pengiriman yang tersedia untuk langganan. Untuk informasi selengkapnya tentang portal web dan langganan, lihat Langganan dan pengiriman (Reporting Services).

Konten terkait