Freigeben über


Verwenden einer Notification-Klasse 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 verfügt über mehrere Eigenschaften, die verwendet werden können, um die Berichte für die Übermittlung zu rendern, den Status der Benachrichtigung zu bestimmen und die Benutzerdaten festzulegen.

Die Benachrichtigung ist das zentrale Objekt einer jeden Übermittlung

Berichtsbenachrichtigungsprozess

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 über die 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 zum Verwenden der Notification-Klasse finden Sie unter SQL Server Reporting Services Product Samples.

Funktion zum Wiederholen

Mit Reporting Services können Sie für Benachrichtigungen, die nicht sofort übermittelt werden können, eine Wiederholungswarteschlange erstellen. Nachdem der Berichtsserver die Deliver-Methode einer Übermittlungserweiterung aufruft, kann die Übermittlungserweiterung anfordern, dass der Berichtsserver die Übermittlung zu einem späteren Zeitpunkt wiederholt. In diesem Fall stellt der Berichtsserver die Benachrichtigung in eine interne Warteschlange und wiederholt die Übermittlung nach einem bestimmten Zeitraum. Administratoren können konfigurieren, wie viele Wiederholungsversuche der Berichtsserver maximal ausführen soll, und den Zeitraum zwischen den Wiederholungen im Bereich der Übermittlungserweiterung der Datei RSReportServer.config festlegen, indem sie die XML-Elemente MaxNumberOfRetries und PeriodBetweenRetries verwenden. 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.