Implementare l'interfaccia IDeliveryExtension per un'estensione per il recapito

  • Articolo

La classe di estensioni per il recapito viene utilizzata per recapitare le notifiche dei report agli utenti in base al contenuto delle notifiche. La classe di estensioni per il recapito fornisce anche l'infrastruttura per la convalida delle impostazioni utente passate all'estensione per il recapito. La classe di estensione per il recapito deve contenere proprietà specifiche che i client possono usare per ottenere informazioni sul nome dell'estensione. Deve inoltre avere le impostazioni supportate dall'estensione e i formati di rendering disponibili per l'estensione per il recapito.

Screenshot of the IDeliveryExtension interface process.

L'interfaccia IDeliveryExtension consente la convalida dei dati utente e per consentire ai client di ottenere informazioni sulle impostazioni di recapito necessarie.

Per creare un'estensione per il recapito, implementare IDeliveryExtension e IExtension. L'interfaccia IDeliveryExtension consente all'estensione per il recapito di recapitare notifiche dei report tramite il metodo Deliver e di convalidare le impostazioni dell'estensione in ingresso tramite il metodo ValidateUserData. L'interfaccia IExtension consente all'estensione per il recapito di implementare un nome di estensione localizzato e di elaborare le informazioni di configurazione specifiche dell'estensione archiviate nel file di configurazione di SQL Server. Grazie all'implementazione di IExtension, l'estensione per il recapito contiene la proprietà LocalizedName. Le estensioni per il recapito di SSRS devono supportare la proprietà LocalizedName , in modo che gli utenti riscontrino un nome familiare per l'estensione in un'interfaccia utente, ad esempio Gestione report.

L'estensione per il recapito deve implementare anche la proprietà ExtensionSettings dell'interfaccia IDeliveryExtension. Il server di report utilizza il valore restituito dalla proprietà ExtensionSettings per valutare le impostazioni necessarie per un'estensione per il recapito. I client che interagiscono con le estensioni per il recapito utilizzano il metodo GetExtensionSettings del servizio Web ReportServer per restituire un elenco di impostazioni per l'estensione per il recapito.

È inoltre possibile utilizzare la classe di estensioni per il recapito per recuperare ed elaborare i dati di configurazione personalizzati archiviati nel file RSReportServer.config. Per ulteriori informazioni sull'elaborazione dei dati di configurazione personalizzati, vedere il metodo SetConfiguration.

Per un'implementazione di classe IDeliveryExtension di esempio, vedere Esempi di Reporting Services in CodePlex (SQL Server Reporting Services SSRS).

Contenuto correlato