Share via


Implementieren der IDeliveryExtension-Schnittstelle für Übermittlungserweiterungen

Mit der Klasse der Übermittlungserweiterungen können Sie ausgehend von den Inhalten der Benachrichtigungen Berichtsbenachrichtigungen an Benutzer übermitteln. Die Klasse der Übermittlungserweiterung bietet außerdem eine Infrastruktur zum Validieren der Benutzereinstellungen, die an die Übermittlungserweiterung übergeben werden. Zusätzlich sollte die Übermittlungserweiterung bestimmte Eigenschaften enthalten, mit denen Clients folgende Informationen abrufen können: den Namen der Erweiterung, die von der Erweiterung unterstützten Einstellungen und die Renderingformate, die für diese Übermittlungserweiterung zur Verfügung stehen.

Mithilfe der IdeliveryExtension-Schnittstelle können auch Clients Benutzerdaten validieren und die erforderlichen Übermittlungseinstellungen abrufen.

IDeliveryExtension-Schnittstellenprozess

Um eine Klasse der Übermittlungserweiterungen zu erstellen, implementieren Sie IDeliveryExtension und IExtension. Über die IDeliveryExtension-Schnittstelle kann die Übermittlungserweiterung Berichtsbenachrichtigungen mit der Deliver-Methode übermitteln und die eingehenden Erweiterungseinstellungen mit der ValidateUserData-Methode validieren. Durch die IExtension-Schnittstelle kann die Übermittlungserweiterung einen lokalisierten Erweiterungsnamen implementieren und erweiterungsspezifische Konfigurationsdaten verarbeiten, die in der SQL Server-Konfigurationsdatei gespeichert sind. Durch die Implementierung von IExtension enthält die Übermittlungserweiterung die Eigenschaft LocalizedName. Die SSRS-Übermittlungserweiterungen sollten unbedingt die LocalizedName-Eigenschaft unterstützen, sodass die Benutzer einen bekannten und lokalisierten Namen auf der Benutzeroberfläche, z. B. dem Berichts-Manager, vorfinden.

Die Übermittlungserweiterung muss auch die ExtensionSettings-Eigenschaft der IDeliveryExtension-Schnittstelle implementieren. Der Berichtsserver verwendet den von der ExtensionSettings-Eigenschaft zurückgegebenen Wert, um die für die Übermittlungserweiterung erforderlichen Einstellungen zu überprüfen. Clients, die mit den Übermittlungserweiterungen interagieren, verwenden die GetExtensionSettings-Methode des Berichtsserver-Webdiensts, um eine Liste der Einstellungen für die Übermittlungserweiterung zurückzugeben.

Sie können auch die Klasse der Übermittlungserweiterungen verwenden, um in der Datei RSReportServer.config gespeicherte, benutzerdefinierte Konfigurationsdaten abzurufen und zu verarbeiten. Weitere Informationen zur Verarbeitung benutzerdefinierter Konfigurationsdaten finden Sie in der Methode SetConfiguration.

Eine IDeliveryExtension-Beispielklassenimplementierung finden Sie unter SQL Server Reporting Services Product Samples.