Поделиться через

  • Статья

Использование класса Notification для модуля доставки

Класс Notification находится в пространстве имен Microsoft.ReportingServices.Interfaces и представляет сведения о подписках, используемые модулями доставки при доставке отчетов. Класс Notification предоставляет ряд свойств, которые могут быть использованы при подготовке отчетов для доставки, при определении состояния уведомления и при указании пользовательских данных.

Уведомление является центральным объектом любой доставки

Процесс уведомления об отчетах

При возникновении события, связанного с подпиской, в которой применяется пользовательский модуль доставки, создается уведомление, содержащее объект Report. Объект Report инкапсулирует функции, необходимые для подготовки данного отчета к отображению в поддерживаемом формате, и содержит такие конкретные свойства отчета, как URL-адрес отчета на сервере, а также имя отчета. Дополнительные сведения о классе Report см. в разделе Использование класса Report в модуле доставки.

Объект Notification передается методу Deliver модуля доставки. Метод Deliver должен содержать конкретный код, обеспечивающий обработку уведомления и доставку отчета.

Пример использования класса Notification см. в разделе Образцы продуктов служб SQL Server Reporting Services.

Функция повторной передачи

Службы Службы Reporting Services предоставляют возможность создавать очереди повтора для уведомлений, которые не могут быть переданы немедленно. После вызова сервером отчетов метода Deliver модуля доставки этот модуль доставки может обратиться к серверу отчетов с запросом о повторной доставке в более поздний момент времени. В таком случае сервер отчетов помещает уведомление во внутреннюю очередь и по истечении определенного периода времени предпринимает новую попытку доставки. Администраторы могут настраивать максимальное число попыток повторной передачи, предпринимаемых сервером отчетов, а также период времени между повторными попытками, в разделе модуля доставки файла RSReportServer.config с помощью элемента XML MaxNumberOfRetries и элемента XML PeriodBetweenRetries. Уведомления удаляются из очереди повтора, если в дальнейшем доставка завершится успешно или будет достигнуто максимальное число попыток повторной передачи. Если после достижения максимального числа попыток повторной передачи доставка оканчивается неудачей, уведомление отменяется.