本文内容
传递扩展插件以 XML 配置文件的形式提供其配置信息。 该 XML 文件符合为传递扩展插件定义的 XML 架构。 传递扩展插件提供用于设置和修改配置文件的基础结构。
如果替换或升级某一传递扩展插件,则引用该传递扩展插件的所有订阅仍保持有效。
在将 传递扩展插件写入和编译到某一 .NET 库中后,必须将该扩展插件复制到相应的目录中,并且向适当的 配置文件添加一个条目,以便报表服务器可以定位它。
配置文件扩展插件元素
部署到报表服务器的传递扩展插件需要作为配置文件中的 元素输入。 用于报表服务器的配置文件是 .。
下表介绍传递扩展插件的 元素的属性。
特性说明
Name
扩展插件的唯一名称(例如,“ E-Mail”用于电子邮件传递扩展插件,“ ”用于文件共享传递扩展插件)。 Name 属性的最大长度是 255 个字符。 该名称在配置文件的 元素内的所有条目中必须唯一。 如果存在重复的名称,则报表服务器返回错误。
类型
以逗号分隔的列表,其中包含完全限定的命名空间以及程序集的名称。
值为 false 指示在用户界面中将不显示该传递扩展插件。 如果未包含此属性,则默认值为 true。
有关 . 文件的详细信息,请参阅 配置文件。
将扩展插件部署到报表服务器
报表服务器使用传递扩展插件处理和传递通知或报表。 您应将传递扩展插件程序集作为专用程序集部署到报表服务器。 还需要在报表服务器配置文件 . 中生成一个条目。
将传递扩展插件程序集部署到报表服务器
将程序集从临时位置复制到您要在其上使用此传递扩展插件的报表服务器的 bin 目录中。 报表服务器 bin 目录的默认位置为 %% SQL . \bin。
重要
如果您在尝试覆盖现有传递扩展插件程序集,则必须首先停止报表服务器服务,然后复制更新的程序集。 在复制程序集后重新启动您的服务。
在复制程序集文件后,打开 . 文件。 . 文件位于 %% SQL . 目录中。 还需要在配置文件中为传递扩展插件程序集文件生成一个条目。 可以使用 或诸如记事本之类的简单文本编辑器打开该配置文件。
在 . 文件中找到 元素。 应当在以下位置为新创建的传递扩展插件生成一个条目:
复制
<code data-author-content=" ">
为您的传递扩展插件添加一个条目。 此条目应包含一个具有 Name 和 Type 值的 元素,可能如下所示 :
复制
<code data-author-content=" ">
Name 的值是传递扩展插件的唯一名称。 Type 的值是以逗号分隔的列表,包括实现 接口的类的完全限定命名空间的条目,后跟程序集的名称(不包括 .dll 文件扩展名)。 默认情况下,传递扩展插件是可见的。 若要从用户界面(如 Web 门户)中隐藏扩展插件,请将 属性添加到 元素,并将其设置为 false。
最后,为自定义程序集添加一个代码组,以便为传递扩展插件授予 权限。 为此,需要将代码组添加到 . 文件,该文件默认位于 %% SQL . 中。 代码组可能如下所示:
复制
<code data-author-content=" <IMembershipCondition class="UrlMembershipCondition" version="1" Url="C:Program FilesMicrosoft SQL ServerMSRS13.Reporting ServicesReportServerbinMyExtensionAssembly.dll" /> "> <IMembershipCondition class="UrlMembershipCondition" version="1" Url="C:Program FilesMicrosoft SQL ServerMSRS13.Reporting ServicesReportServerbinMyExtensionAssembly.dll" />
URL 成员身份仅是您可能为传递扩展插件选择的多个成员身份条件之一。 有关 SSRS 中的代码访问安全性的详细信息,请参阅安全开发 ( )
验证部署
您可以使用 Web 服务 方法,验证是否已向报表服务器成功地部署了传递扩展插件。 还可以打开 Web 门户,并验证扩展插件是否包括在用于订阅的可用传递扩展插件列表中。 有关 Web 门户和订阅的详细信息,请参阅订阅和传递 ( )。
另请参阅
实现传递扩展插件
扩展插件库
发表回复