Condividi tramite


Implementazione dell'interfaccia IDeliveryExtension per un'estensione per il recapito

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. Questa classe deve inoltre contenere proprietà specifiche che i client possono utilizzare per ottenere informazioni sul nome dell'estensione, sulle impostazioni supportate dall'estensione e sui formati di rendering disponibili per l'estensione per il recapito.

L'interfaccia IDeliveryExtension consente la convalida dei dati utente e fornisce ai client informazioni sulle impostazioni di recapito necessarie

Processo dell'interfaccia IDeliveryExtension

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 utilizzando il metodo Deliver e di convalidare le impostazioni dell'estensione in ingresso utilizzando 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. È consigliabile che le estensioni per il recapito di SSRS supportino la proprietà LocalizedName, in modo che gli utenti possano visualizzare 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 esempio della classe IDeliveryExtension, vedere SQL Server Reporting Services Product Samples.