Menyesuaikan parameter ekstensi rendering di RSReportServer.Config

  • Artikel

Anda dapat menentukan parameter ekstensi penyajian dalam file konfigurasi RSReportServer untuk mengambil alih perilaku penyajian laporan default untuk laporan yang berjalan di server laporan Reporting Services. Anda dapat memodifikasi parameter ekstensi penyajian untuk mencapai tujuan berikut:

  • Ubah bagaimana nama ekstensi penyajian muncul di daftar Ekspor toolbar laporan (misalnya, untuk mengubah "Arsip web" menjadi "MHTML"), atau lokalkan nama ke bahasa yang berbeda.

  • Buat beberapa instans ekstensi penyajian yang sama untuk mendukung opsi presentasi laporan yang berbeda (misalnya, versi mode potret dan lanskap dari ekstensi Penyajian gambar).

  • Ubah parameter ekstensi penyajian default untuk menggunakan nilai yang berbeda (misalnya, ekstensi Rendering gambar menggunakan TIFF sebagai format output default; Anda dapat memodifikasi parameter ekstensi untuk menggunakan EMF sebagai gantinya).

Mengubah parameter ekstensi penyajian hanya memengaruhi operasi penyajian di server laporan. Anda tidak dapat mengambil alih pengaturan ekstensi penyajian dalam pratinjau laporan di Perancang Laporan.

Menentukan parameter ekstensi penyajian dalam file konfigurasi memengaruhi ekstensi penyajian secara global. Pengaturan dalam file konfigurasi digunakan sebagai pengganti nilai default setiap kali ekstensi penyajian tertentu digunakan. Jika Anda ingin mengatur parameter ekstensi penyajian untuk laporan atau operasi render tertentu, Anda harus menentukan informasi perangkat secara terprogram menggunakan Render metode atau dengan menentukan pengaturan informasi perangkat pada URL laporan. Untuk informasi selengkapnya tentang menentukan pengaturan informasi perangkat untuk operasi render, dan untuk melihat daftar lengkap pengaturan informasi perangkat, lihat Meneruskan pengaturan informasi perangkat ke ekstensi penyajian.

Menemukan dan memodifikasi RSReportServer.config

Pengaturan konfigurasi untuk format output laporan ditentukan sebagai parameter ekstensi penyajian dalam file RSReportServer.config. Untuk menentukan parameter ekstensi penyajian dalam file konfigurasi, Anda harus tahu cara menentukan struktur XML yang mengatur parameter penyajian. Ada dua struktur XML yang dapat Anda ubah:

  • Elemen OverrideNames menentukan nama tampilan dan bahasa ekstensi penyajian.

  • Struktur XML DeviceInfo menentukan pengaturan informasi perangkat yang digunakan oleh ekstensi penyajian. Sebagian besar parameter ekstensi penyajian ditentukan sebagai pengaturan informasi perangkat.

Anda dapat menggunakan editor teks untuk mengubah file. File RSReportServer.config dapat ditemukan di folder \Reporting Services\Report Server\Bin. Untuk informasi selengkapnya tentang mengubah file konfigurasi, lihat Mengubah file konfigurasi Reporting Services (RSreportserver.config).

Mengubah nama tampilan

Nama tampilan untuk ekstensi penyajian muncul di daftar Ekspor toolbar laporan. Contoh nama tampilan default termasuk arsip Web, file TIFF, dan file Acrobat (PDF). Anda dapat mengganti nama tampilan default dengan nilai kustom dengan menentukan elemen OverrideNames dalam file konfigurasi. Selain itu, jika Anda mendefinisikan dua instans dari satu ekstensi rendering, Anda dapat menggunakan elemen OverrideNames untuk membedakan setiap instans dalam daftar Ekspor.

Karena nama tampilan dilokalkan, Anda harus mengatur atribut Bahasa jika Anda mengganti nama tampilan default dengan nilai kustom. Jika tidak, nama apa pun yang Anda tentukan akan diabaikan. Nilai bahasa yang Anda tetapkan harus valid untuk komputer server laporan. Misalnya, jika server laporan berjalan pada sistem operasi Prancis, Anda harus menentukan "fr-FR" sebagai nilai atribut.

Contoh berikut mengilustrasikan cara memberikan nama kustom di server laporan bahasa Inggris:

<Extension Name="XML" Type="Microsoft.ReportingServices.Rendering.DataRenderer.XmlDataReport,Microsoft.ReportingServices.DataRendering">  
   <OverrideNames>  
     <Name Language="en-US">My Custom Display Name for XML Rendering</Name>  
   </OverrideNames>  
</Extension>

Mengubah pengaturan informasi perangkat

Untuk mengubah pengaturan informasi perangkat default yang digunakan oleh ekstensi penyajian yang sudah disebarkan di server laporan, Anda harus mengetik struktur XML DeviceInfo ke dalam file konfigurasi. Setiap ekstensi rendering mendukung pengaturan informasi perangkat yang unik untuk ekstensi tersebut. Untuk melihat daftar lengkap pengaturan informasi perangkat, lihat Meneruskan pengaturan informasi perangkat ke ekstensi penyajian.

Contoh berikut memberikan ilustrasi struktur dan sintaks XML yang memodifikasi pengaturan default ekstensi Penyajian gambar:

<Render>  
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">Image (EMF)</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <ColorDepth>32</ColorDepth>  
                <DpiX>300</DpiX>  
                <DpiY>300</DpiY>  
                <OutputFormat>EMF</OutputFormat>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

Mengonfigurasi beberapa entri untuk ekstensi penyajian

Anda dapat membuat beberapa instans ekstensi rendering yang sama untuk mendukung opsi presentasi laporan yang berbeda. Setiap instans yang Anda tentukan dapat memiliki kombinasi nilai parameter yang berbeda. Saat menentukan instans baru dari ekstensi penyajian yang ada, pastikan untuk melakukan hal berikut:

  • Tentukan nama unik untuk ekstensi.

    Setiap instans harus memiliki nilai unik untuk atribut Name . Contoh berikut menggunakan nama "IMAGE (EMF Landscape)" dan "IMAGE (EMF Portrait)" untuk membedakan antara kedua instans.

    Berhati-hatilah saat mengubah nama ekstensi penyajian yang sudah disebarkan. Pengembang yang menentukan ekstensi penyajian secara terprogram menggunakan nama ekstensi untuk mengidentifikasi instans mana yang akan digunakan untuk operasi render tertentu. Jika Anda menjalankan aplikasi Reporting Services kustom di server laporan Anda, pastikan pengembang mengetahui apakah Anda memodifikasi nama ekstensi yang sudah ada atau menambahkan yang baru.

  • Tentukan nama tampilan unik sehingga pengguna dapat memahami perbedaan untuk setiap format output.

    Jika mengonfigurasi beberapa versi ekstensi yang sama, Anda dapat memberi setiap versi nama unik dengan memberikan nilai untuk OverrideNames. Jika tidak, semua versi ekstensi akan tampak memiliki nama yang sama dalam daftar Opsi ekspor pada toolbar laporan.

Contoh berikut menggambarkan cara menggunakan ekstensi Penyajian Gambar default (yang menghasilkan output TIFF) untuk menghasilkan EMF dalam mode Potret bersama instans kedua yang menghasilkan laporan dalam EMF dalam mode Lanskap. Perhatikan bahwa setiap nama ekstensi unik. Saat menguji contoh ini, ingatlah untuk memilih laporan yang tidak berisi fitur interaktif seperti opsi perlihatkan/sembunyikan, matriks, atau tautan penelusuran (fitur interaktif tidak berfungsi di ekstensi Penyajian gambar):

<Render>  
    <Extension Name="IMAGE (EMF Landscape)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Landscape Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>8.5in</PageHeight>  
                <PageWidth>11in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
    <Extension Name="IMAGE (EMF Portrait)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Portait Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>11in</PageHeight>  
                <PageWidth>8.5in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

Konten terkait