Verwenden einer Benachrichtigungsklasse für eine Übermittlungserweiterung

Die Notification-Klasse befindet sich im Microsoft.ReportingServices.Interfaces-Namespace und stellt Abonnementdaten dar, die die Übermittlungserweiterungen für die Übermittlung von Berichten verwenden. Die Notification Klasse stellt viele Eigenschaften bereit, die zum Rendern der Berichte für die Übermittlung verwendet werden können, bestimmen den Status der Benachrichtigung und festlegen von Benutzerdaten.

Die Benachrichtigung ist das zentrale Objekt jeder Übermittlung.

Wenn ein Ereignis eintritt, das zu einem Abonnement gehört, das Ihre benutzerdefinierte Übermittlungserweiterung verwendet, wird eine Benachrichtigung mit einem Report-Objekt erstellt. Das Report-Objekt umfasst Funktionen, die benötigt werden, um einen bestimmten Bericht in einem unterstützten Renderingformat zu rendern, und enthält berichtsspezifische Eigenschaften, wie die URL zum Bericht auf dem Server und den Namen des Berichts. Weitere Informationen zur Report Klasse finden Sie unter Verwenden der Report-Klasse für eine Übermittlungserweiterung.

Sie übergeben das Notification-Objekt an die Deliver-Methode Ihrer Übermittlungserweiterung. Die Deliver-Methode sollte speziellen Code zur Verarbeitung der Benachrichtigung und zur Übermittlung des Berichts enthalten.

Ein Beispiel zur Verwendungsweise der Notification-Klasse finden Sie unter SQL Server Reporting Services-Produktbeispiele.

Wiederholen der Funktionalität

Mit Reporting Services können Sie eine Wiederholungswarteschlange für Benachrichtigungen erstellen, die nicht sofort zugestellt werden können. Nachdem der Berichtsserver die Deliver-Methode einer Übermittlungserweiterung aufruft, kann die Übermittlungserweiterung anfordern, dass der Berichtsserver die Übermittlung zu einem späteren Zeitpunkt wiederholt. Wenn dieses Ereignis auftritt, platziert der Berichtsserver die Benachrichtigung in einer internen Warteschlange und ruft die Übermittlung nach einem bestimmten Zeitraum erneut ab. Administratoren können die maximale Anzahl von Wiederholungsversuchen, die der Berichtsserver ausführen soll, und den Zeitraum zwischen den Wiederholungen im Bereich der Übermittlungserweiterung der Datei „RSReportServer.config“ konfigurieren. Dazu verwenden sie die XML-Elemente MaxNumberOfRetries und PeriodBetweenRetries. Benachrichtigungen werden aus der Wiederholungswarteschlange entfernt, wenn die Übermittlung später erfolgreich oder die maximale Anzahl an Wiederholungsversuchen erreicht ist. Wenn die Übermittlung nach der maximalen Anzahl von Wiederholungen fehlschlägt, wird die Benachrichtigung entfernt.

Zugehöriger Inhalt

• Implementieren einer Übermittlungserweiterung
• Reporting Services-Erweiterungsbibliothek