レンダリング拡張機能の展開

Reporting Services レポート表示拡張機能を作成して .NET Framework ライブラリにコンパイルしたら、レポートサーバーとレポートデザイナーで検出できるようにする必要があります。そのためには、拡張機能を適切なディレクトリにコピーし、適切な Reporting Services 構成ファイルにエントリを追加します。

Configuration File Rendering Extension 要素

レンダリング拡張機能が.DLLにコンパイルされたら、rsreportserver.config ファイルにエントリを追加します。既定では、場所は \Microsoft SQL Server\MSRS10_50.< %ProgramFiles%ですInstanceName>\Reporting Services\ReportServer。親要素は <Render> です。 Render 要素の下には、各レンダリング拡張機能の Extension 要素があります。 Extension要素には、Name と Type の 2 つの属性が含まれています。

次の表では、拡張機能を表示するための Extension 要素の属性について説明します。

特性	説明
名前	拡張機能の一意の名前。 Name 属性の最大文字数は 255 文字です。名前は、構成ファイルの Extensions 要素内のすべてのエントリで一意である必要があります。重複する名前が存在する場合、レポートサーバーはエラーを返します。
タイプ	アセンブリの名前と共に完全修飾名前空間を含むコンマ区切りのリスト。
表示	`false`の値は、表示拡張機能をユーザーインターフェイスに表示しないことを示します。属性が含まれていない場合、既定値は `true`。
LogAllExecutionRequests	`false`の値は、セッションでの最初のレポート実行に対してのみエントリがログに記録されることを示します。属性が含まれていない場合、既定値は `true`。たとえば、この設定では、レポートに表示された最初のページ ( `false`の場合) のエントリのみをログに記録するか、レポートに表示される各ページのエントリ ( `true`) をログに記録するかを決定します。

詳細については、「 RSReportServer 構成ファイル」を参照してください。

レポートサーバーへの拡張機能の展開

レポートサーバーでは、表示拡張機能を使用してレポートを他の形式にエクスポートします。表示拡張機能アセンブリは、プライベートアセンブリとしてレポートサーバーに配置する必要があります。また、レポートサーバー構成ファイルにエントリを作成する必要 rsreportserver.config。

アセンブリを配置するには

ステージングの場所から、表示拡張機能を使用するレポートサーバーの bin ディレクトリにアセンブリをコピーします。レポートサーバーの Bin ディレクトリの既定の場所は、\Microsoft SQL Server\MSRS10_50.< %ProgramFiles%ですInstanceName>\Reporting Services\ReportServer\Bin。
アセンブリファイルがコピーされたら、rsreportserver.config ファイルを開きます。 rsreportserver.config ファイルは、レポートサーバーの bin ディレクトリにも配置されます。拡張アセンブリファイルの構成ファイルにエントリを作成する必要があります。 Visual Studio または単純なテキストエディターを使用してファイルを開くことができます。

詳細については、「 RSReportServer 構成ファイル」を参照してください。
Rsreportserver.config ファイルで Render 要素を見つけます。新しく作成した拡張機能のエントリは、次の場所に作成する必要があります。
```
<Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>  
```
表示拡張機能のエントリを追加します。エントリには、 Name と Type の値を持つ要素が含まれている必要があり、次のようになります。
```
<Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />  
```
Name の値は、表示拡張機能の一意の名前です。 Type の値は、IRenderingExtension実装の完全修飾名前空間のエントリと、アセンブリの名前 (.dll ファイル拡張子を含まない) を含むコンマ区切りのリストです。既定では、表示拡張機能が表示されます。レポートマネージャーなどのユーザーインターフェイスで拡張機能を非表示にするには、 visible 属性を Extension 要素に追加し、 falseに設定します。

デプロイの確認

レポートマネージャーを開き、レポートで使用可能なエクスポートの種類の一覧に拡張機能が含まれていることを確認することもできます。

こちらもご覧ください

レンダリング拡張機能の実装
 表示拡張機能の概要
 IRenderingExtension インターフェイスの実装
 拡張機能のセキュリティに関する考慮事項

Last updated on 2017-06-13