Verwenden einer Benachrichtigungsklasse für eine Übermittlungserweiterung

Die Notification Klasse befindet sich im Microsoft.ReportingServices.Interfaces Namespace und stellt Abonnementinformationen dar, die übermittlungserweiterungen für die Übermittlung von Berichten verwenden. Die Notification Klasse stellt eine Reihe von Eigenschaften bereit, mit denen die Berichte für die Übermittlung gerendert werden können, der Status der Benachrichtigung bestimmt und Benutzerdaten festgelegt werden können.

Die Benachrichtigung ist das zentrale Objekt jeder Übermittlung.

Wenn ein Ereignis ausgelöst wird, das einem Abonnement zugeordnet ist, das Ihre benutzerdefinierte Übermittlungserweiterung verwendet, wird eine Benachrichtigung erstellt, die ein Report Objekt enthält. Das Report Objekt kapselt die Funktionalität, die zum Rendern eines bestimmten Berichts in einem unterstützten Renderingformat erforderlich ist, und enthält berichtsspezifische Eigenschaften, z. B. die URL zum Bericht auf dem Server und den Namen des Berichts. Weitere Informationen zur Report Klasse finden Sie unter Verwenden der Berichtsklasse für eine Übermittlungserweiterung.

Sie übergeben das Notification Objekt an die Deliver Methode Der Übermittlungserweiterung. Ihre Deliver Methode sollte spezifischen Code enthalten, um die Benachrichtigung zu verarbeiten und den Bericht zu übermitteln.

Ein Beispiel für die Verwendung der Notification Klasse finden Sie unter SQL Server Reporting Services-Produktbeispiele.

Wiederholungsfunktionalität

Reporting Services ermöglicht Es Ihnen, eine Wiederholungswarteschlange für Benachrichtigungen zu erstellen, die nicht sofort übermittelt werden können. Nachdem der Berichtsserver die Deliver Methode einer Übermittlungserweiterung aufgerufen hat, kann die Übermittlungserweiterung anfordern, dass der Berichtsserver die Übermittlung zu einem späteren Zeitpunkt erneut wiederholt. Wenn dies der Fall ist, platziert der Berichtsserver die Benachrichtigung in einer internen Warteschlange und ruft die Zustellung nach ablaufen eines bestimmten Zeitraums erneut ab. Administratoren können die maximale Anzahl von Wiederholungsversuchen konfigurieren, die der Berichtsserver ausführt, und den Zeitraum zwischen Wiederholungen im Abschnitt zur Übermittlungserweiterung der RSReportServer.config Datei mithilfe des MaxNumberOfRetries XML-Elements und des PeriodBetweenRetries-XML-Elements . Benachrichtigungen werden aus der Wiederholungswarteschlange entfernt, wenn die Zustellung später erfolgreich ist oder die maximale Anzahl von Wiederholungsversuchen erreicht ist. Wenn die Zustellung nach der maximalen Anzahl von Wiederholungen fehlschlägt, wird die Benachrichtigung verworfen.

Siehe auch

Implementieren einer Erweiterungsbibliothek für Die ÜbermittlungserweiterungReporting Services