部署传递扩展插件

传递扩展插件以 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 元素内的所有条目中必须唯一。 如果存在重复的名称,则报表服务器返回错误。

Type

以逗号分隔的列表,其中包含完全限定的命名空间以及程序集的名称。

Visible

值为 false 指示在用户界面中将不显示传递扩展插件。 如果未包含此属性,则默认值为 true。

有关 RSReportServer.config 文件的详细信息,请参阅 配置文件 (Reporting Services)

将扩展插件部署到报表服务器

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

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

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

    重要说明重要提示

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

  2. 在复制程序集文件后,打开 RSReportServer.config 文件。 RSReportServer.config 文件位于 %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<实例名>\Reporting Services\ReportServer 目录中。 还需要在配置文件中为传递扩展插件程序集文件生成一个条目。 您可以使用 Microsoft Visual 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 文件扩展名)。 默认情况下,传递扩展插件是可见的。 若要从用户界面(如报表管理器)中隐藏扩展插件,请将 Visible 属性添加到 Extension 元素,并将其设置为 false。

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

    <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\MSRS10_50.<InstanceName>\Reporting Services\ReportServer\bin\MyExtensionAssembly.dll"
           />
    </CodeGroup>
    

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

将扩展插件部署到报表管理器

如果您的传递扩展插件实现 ISubscriptionBaseUIUserControl 接口,则该传递扩展插件可用于报表管理器订阅页。 为了使该订阅用户界面可用,需要将扩展插件部署到报表管理器。

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

  1. 将程序集从临时位置复制到报表管理器的 bin 目录中。 报表管理器 bin 目录的默认位置为 %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<实例名>\Reporting Services\ReportManager\bin。

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

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

    <Extensions>
       <DeliveryUI>
          <Your extension configuration information goes here>
       </DeliveryUI>
    </Extensions>
    
  4. 为您的传递扩展插件添加一个条目。 您的条目应包括具有用于 Name 和 Type 的值的 Extension 元素并且如下所示:

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

    Name 的值是传递扩展插件的唯一名称。 Type 的值是逗号分隔的列表,包括实现 ISubscriptionBaseUIUserControl 接口的类的完全限定命名空间的条目,后随程序集的名称(不包括 .dll 文件扩展名)。

    重要说明重要提示

    对于报表服务器和报表管理器配置文件条目,Name 属性的值必须相同。 如果它们不同,则您的服务器配置将无效。

    最后,为您的自定义程序集添加一个代码组,以便为您的传递扩展插件授予 FullTrust 权限。 为此,需要将代码组添加到 RSmgrpolicy.config 文件,该文件默认位于 C:\Program Files\Microsoft SQL Server\MSRS10_50.<实例名>\Reporting Services\ReportManager 中。 代码组可能类似如下所示:

    <CodeGroup class="UnionCodeGroup"
       version="1"
       PermissionSetName="FullTrust"
       Name="MyExtensionCodeGroup"
       Description="Code group for my delivery UI extension">
          <IMembershipCondition class="UrlMembershipCondition"
             version="1"
             Url="C:\Program Files\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportManager\bin\MyExtensionAssembly.dll"
           />
    </CodeGroup>
    

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

验证部署

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

请参阅

参考

Reporting Services 扩展插件库

其他资源

实现传递扩展插件