对传递扩展插件使用 Notification 类
Notification 类位于 Microsoft.ReportingServices.Interfaces 命名空间中,表示传递扩展插件用于传递报表的订阅信息。 该 Notification 类提供了许多属性,可用于呈现报表以供传递、确定通知的状态以及设置用户数据。
通知是任何传递的中心对象。
在引发与某一订阅关联的事件时,如果该订阅使用您的自定义传递扩展插件,则将创建包含 Report 对象的通知。 Report 对象封装将给定报表呈现给支持的呈现格式所需的功能,并且包含特定于报表的属性,例如指向服务器上报表的 URL 和报表的名称。 有关该 Report 类的详细信息,请参阅 使用报表类作为传递扩展插件。
您将 Notification 对象传递到传递扩展插件的 Deliver 方法。 您的 Deliver 方法应包含用于处理通知和传递报表的特定代码。
有关如何使用 Notification 类的示例,请参阅 SQL Server Reporting Services Product Samples(SQL Server Reporting Services 产品示例)。
重试功能
Reporting Services 允许为无法立即传递的通知创建重试队列。 在报表服务器调用某一传递扩展插件的 Deliver 方法后,该传递扩展可以请求报表服务器在以后的某个时间点重试该传递。 如果发生此事件,报表服务器会将通知置于内部队列中,并在经过特定时间段后重试传递。 管理员可以使用 MaxNumberOfRetries XML 元素和 PeriodBetweenRetries XML 元素,在 RSReportServer.config 文件的传递扩展插件部分中配置报表服务器执行的重试尝试的最大次数以及两次重试之间的时间段。 如果传递在以后成功,或者达到最大重试尝试数目,则通知将从重试队列中删除。 如果传递在尝试了最大重试数目后仍失败,则通知将被放弃。