部署呈现扩展插件

  • 项目

将 Reporting Services 报表呈现扩展插件写入并编译为 .NET Framework 库后，需要使其可由报表服务器和报表设计器发现。 为此，请将此扩展插件复制到适当的目录并向适当的 Reporting Services 配置文件添加条目。

配置文件呈现扩展插件元素

呈现扩展插件编译为 .DLL 后，将条目添加到 rsreportserver.config 文件中。 默认情况下，此位置为 %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer。 父元素为 \<Render>。 在 Render 元素下，是每个呈现扩展插件的扩展元素。 Extension 元素包含两个属性，即 Name 和 Type。

下表描述了呈现扩展插件的 Extension 元素的属性：

特性 描述
Name 扩展插件的唯一名称。 Name 属性的最大长度是 255 个字符。 该名称在配置文件的 Extensions 元素内的所有条目中必须唯一。 如果存在重复的名称，则报表服务器返回错误。
类型 以逗号分隔的列表，其中包含完全限定的命名空间以及程序集的名称。
Visible false 值指示呈现扩展插件不应在用户界面中可见。 如果未包含该属性，则默认值为 true。
LogAllExecutionRequests 值 false 表示在一个会话中只对第一次报表执行记录一个条目。 如果未包含该属性，则默认值为 true。

例如，此设置决定着是只对报表中呈现的第一页记录一个条目（设为 false时），还是对报表中呈现的每一页都记录一个条目（设为 true时）。

有关详细信息，请参阅 RsReportServer.config 配置文件。

将扩展部署到报表服务器

报表服务器使用呈现扩展插件将报表导出为其他格式。 您应将呈现扩展插件程序集作为专用程序集部署到报表服务器。 还需要在报表服务器配置文件 rsreportserver.config 中生成一个条目。

部署程序集

  1. 将程序集从临时位置复制到您要在其上使用此呈现扩展插件的报表服务器的 bin 目录中。 报表服务器 Bin 目录的默认位置为 %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer\Bin。

  2. 在复制程序集文件后，打开 rsreportserver.config 文件。 rsreportserver.config 文件也位于报表服务器 bin 目录中。 还需要在配置文件中为扩展插件程序集文件生成一个条目。 可使用 Visual Studio 或简单的文本编辑器打开该文件。

    有关详细信息，请参阅 RsReportServer.config 配置文件。

  3. 在 Rsreportserver.config 文件中找到 Render 元素。 应当在以下位置为新创建的扩展插件生成一个条目：

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

  4. 为呈现扩展插件添加一个条目。 此条目应包含一个具有 Name 和 Type值的元素，可能如下所示：

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

    Name 的值必须是呈现扩展插件的唯一名称。 Type 的值是一个以逗号分隔的列表，它包含 IRenderingExtension 实现的完全限定命名空间的一个条目，后跟程序集的名称（不包含 .dll 文件扩展名）。 默认情况下，呈现扩展插件是可见的。 若要从用户界面（如报表管理器）中隐藏扩展插件，请将 Visible 属性添加到 Extension 元素，并将其设置为 false。

验证部署

还可以打开报表管理器，并验证您的扩展插件是否包括在报表的可用导出类型列表中。

相关内容