部署传递扩展插件

  • 项目

传递扩展插件以 XML 配置文件的形式提供其配置信息。 该 XML 文件符合为传递扩展插件定义的 XML 架构。 传递扩展插件提供用于设置和修改配置文件的基础结构。

如果替换或升级某一传递扩展插件，则引用该传递扩展插件的所有订阅仍保持有效。

将 Reporting Services 传递扩展插件写入并编译到 Microsoft .NET Framework 库后，必须将该扩展复制到相应的目录，并将条目添加到相应的 Reporting Services 配置文件，以便报表服务器可以找到它。

配置文件扩展元素

部署到报表服务器的传递扩展插件需要作为配置文件中的 Extension 元素输入。 用于报表服务器的配置文件是 RSReportServer.config。

下表介绍传递扩展插件的 Extension 元素的属性。

特性 描述
Name 扩展插件的唯一名称（例如，“Report Server E-Mail”用于电子邮件传递扩展插件，“Report Server FileShare”用于文件共享传递扩展插件）。 Name 属性的最大长度是 255 个字符。 该名称在配置文件的 Extension 元素内的所有条目中必须唯一。 如果存在重复的名称，则报表服务器返回错误。
类型 以逗号分隔的列表，其中包含完全限定的命名空间以及程序集的名称。
Visible 值为 false 表示传递扩展插件不应在用户界面中可见。 如果未包含该属性，则默认值为 true。

有关 RSReportServer.config 文件的详细信息，请参阅 Reporting Services 配置文件。

将扩展部署到报表服务器

报表服务器使用传递扩展插件处理和传递通知或报表。 您应将传递扩展插件程序集作为专用程序集部署到报表服务器。 还需要在报表服务器配置文件 RSReportServer.config 中生成一个条目。

将传递扩展插件程序集部署到报表服务器

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

    重要

    如果您在尝试覆盖现有传递扩展插件程序集，则必须首先停止报表服务器服务，然后复制更新的程序集。 在复制程序集后重新启动您的服务。

  2. 在复制程序集文件后，打开 RSReportServer.config 文件。 RSReportServer.config 文件位于 %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServer 目录中。 还需要在配置文件中为传递扩展插件程序集文件生成一个条目。 可以使用 MicrosoftVisual Studio 或诸如记事本之类的简单文本编辑器打开该配置文件。

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

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

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

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

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

  5. 最后，为自定义程序集添加一个代码组，以便为传递扩展插件授予 FullTrust 权限。 为此，将代码组添加到默认情况下位于 %ProgramFiles%\Microsoft SQL Server\MSRS13.\<InstanceName>\Reporting Services\ReportServer的 rssrvpolicy.config 文件中。 代码组可能如以下示例所示：

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

    URL 成员身份仅是您可能为传递扩展插件选择的多个成员身份条件之一。 有关 SSRS 中的代码访问安全性的详细信息，请参阅 安全开发（Reporting Services）

验证部署

您可以使用 Web 服务 ListExtensions 方法，验证是否已向报表服务器成功地部署了传递扩展插件。 还可以打开 Web 门户，并验证扩展插件是否包括在用于订阅的可用传递扩展插件列表中。 有关 Web 门户和订阅的详细信息，请参阅订阅和传递（Reporting Services）。

相关内容