RSReportServer.Config で表示拡張機能パラメーターをカスタマイズする

RSReportServer 構成ファイルで表示拡張機能パラメーターを指定すると、Reporting Services レポートサーバーで実行されるレポートの既定のレポート表示動作をオーバーライドできます。表示拡張機能のパラメーターを変更して、次の目的を達成できます。

レポートツールバーのエクスポートリストに表示される表示拡張機能の名前の表示方法を変更するか (たとえば、"Web アーカイブ" を "MHTML" に変更する場合)、名前を別の言語にローカライズします。
同じ表示拡張機能の複数のインスタンスを作成して、さまざまなレポート表示オプション (画像表示拡張機能の縦モードと横モードバージョンなど) をサポートします。
異なる値を使用するように既定の表示拡張機能パラメーターを変更します (たとえば、イメージレンダリング拡張機能では既定の出力形式として TIFF が使用されます。代わりに EMF を使用するように拡張パラメーターを変更できます)。

表示拡張機能パラメーターを変更すると、レポートサーバーでのレンダリング操作にのみ影響します。レポートデザイナーのレポートプレビューでは、表示拡張機能の設定をオーバーライドすることはできません。

構成ファイルで表示拡張機能パラメーターを指定すると、レンダリング拡張機能がグローバルに影響を受けます。構成ファイルの設定は、特定のレンダリング拡張機能が使用されるたびに既定値の代わりに使用されます。特定のレポートまたは表示操作の表示拡張機能パラメーターを設定する場合は、 Render メソッドを使用するか、レポート URL でデバイス情報の設定を指定して、プログラムでデバイス情報を指定する必要があります。レンダリング操作のデバイス情報設定の指定と、デバイス情報設定の完全な一覧を表示する方法の詳細については、「デバイス情報設定をレンダリング拡張機能に渡す」を参照してください。

RSReportServer.config の検索と変更

レポート出力形式の構成設定は、RSReportServer.config ファイルの表示拡張機能パラメーターとして指定されます。構成ファイルで表示拡張機能パラメーターを指定するには、レンダリングパラメーターを設定する XML 構造を定義する方法を知っている必要があります。変更できる XML 構造体は 2 つあります。

OverrideNames要素は、表示拡張機能の表示名と言語を定義します。
DeviceInfo XML 構造体は、表示拡張機能で使用されるデバイス情報の設定を定義します。ほとんどの表示拡張機能パラメーターは、デバイス情報の設定として指定されます。

テキストエディターを使用してファイルを変更できます。 RSReportServer.config ファイルは、\Reporting Services\Report Server\Bin フォルダーにあります。構成ファイルの変更の詳細については、「 Reporting Services 構成ファイルの変更 (RSreportserver.config)」を参照してください。

表示名の変更

表示拡張機能の表示名は、レポートツールバーの [エクスポート] リストに表示されます。既定の表示名の例としては、Web アーカイブ、TIFF ファイル、Acrobat (PDF) ファイルなどがあります。構成ファイルで OverrideNames 要素を指定することで、既定の表示名をカスタム値に置き換えることができます。さらに、1 つのレンダリング拡張機能の 2 つのインスタンスを定義する場合は、 OverrideNames 要素を使用して、エクスポートリスト内の各インスタンスを区別できます。

表示名はローカライズされているため、既定の表示名をカスタム値に置き換える場合は、 Language 属性を設定する必要があります。それ以外の場合、指定した名前はすべて無視されます。設定する言語値は、レポートサーバーコンピューターに対して有効である必要があります。たとえば、レポートサーバーがフランスのオペレーティングシステムで実行されている場合は、属性値として "fr-FR" を指定する必要があります。

次の例は、英語のレポートサーバーでカスタム名を指定する方法を示しています。

<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>

デバイス情報の設定の変更

レポートサーバーに既に配置されている表示拡張機能によって使用される既定のデバイス情報設定を変更するには、 DeviceInfo XML 構造を構成ファイルに入力する必要があります。すべての表示拡張機能では、その拡張機能に固有のデバイス情報設定がサポートされます。デバイス情報設定の完全な一覧を表示するには、「デバイス情報設定を表示拡張機能に渡す」を参照してください。

次の例では、イメージ表示拡張機能の既定の設定を変更する XML 構造と構文の図を示します。

<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>

レンダリング拡張機能の複数のエントリの構成

同じ表示拡張機能の複数のインスタンスを作成して、さまざまなレポート表示オプションをサポートできます。定義する各インスタンスは、異なるパラメーター値の組み合わせを持つことができます。既存のレンダリング拡張機能の新しいインスタンスを定義する場合は、必ず次の操作を行ってください。

拡張機能の一意の名前を指定します。

各インスタンスには、 Name 属性の一意の値が必要です。次の例では、"IMAGE (EMF Landscape)" と "IMAGE (EMF Portrait)" という名前を使用して、2 つのインスタンスを区別します。

既に展開されているレンダリング拡張機能の名前を変更する場合は注意が必要です。レンダリング拡張機能をプログラムで指定する開発者は、拡張機能名を使用して、特定のレンダリング操作に使用するインスタンスを識別します。レポートサーバーでカスタム Reporting Services アプリケーションを実行している場合は、既存の拡張機能名を変更するか、新しい拡張機能を追加するかを開発者が認識していることを確認してください。
ユーザーが各出力形式の違いを理解できるように、一意の表示名を指定します。

同じ拡張機能の複数のバージョンを構成する場合は、 OverrideNamesの値を指定することで、各バージョンに一意の名前を付けることができます。それ以外の場合、すべてのバージョンの拡張機能は、レポートツールバーの [エクスポートオプション] リストに同じ名前で表示されます。

次の例は、既定の画像表示拡張機能 (TIFF 出力を生成) を使用して、横モードの EMF でレポートを出力する 2 番目のインスタンスと共に、縦モードで EMF を出力する方法を示しています。各拡張機能名は一意であることに注意してください。この例をテストするときは、表示/非表示オプション、マトリックス、ドリルスルーリンクなどの対話型機能を含まないレポートを選択してください (対話型機能は画像表示拡張機能では機能しません)。

<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>

こちらもご覧ください

RSReportServer 構成ファイル
 RSReportDesigner 構成ファイル
 CSV デバイス情報の設定
 Excel デバイス情報の設定
 HTML デバイス情報の設定
 イメージデバイス情報の設定
 MHTML デバイス情報の設定
 PDF デバイス情報の設定
 XML デバイス情報の設定

Last updated on 2017-03-08