Distribuzione di un'estensione per il rendering
Dopo avere scritto e compilato l'estensione per il rendering del report Reporting Services in una libreria di .NET Framework, è necessario renderla individuabile dal server di report e da Progettazione report. A tale scopo, copiare l'estensione nella directory appropriata e aggiungere voci ai file di configurazione di Reporting Services appropriati.
Elemento di estensione del rendering del file di configurazione
Dopo avere compilato un'estensione per il rendering in una DLL, è necessario aggiungere una voce al file rsreportserver.config, situato nella cartella C:\Programmi\Microsoft SQL Server\MSRS10.<NomeIstanza>\Reporting Services\ReportServer\Bin, se durante l'installazione è stato selezionato il percorso di installazione predefinito. L'elemento padre è <Render>. Sotto l'elemento Render è presente un elemento Extension per ogni estensione per il rendering. L'elemento Extension contiene due attributi, Name e Type.
Nella tabella riportata di seguito vengono descritti gli attributi relativi all'elemento Extension per le estensioni per il rendering.
Attributo |
Descrizione |
|---|---|
Name |
Nome univoco per l'estensione, ad esempio "EXCEL" per l'estensione per il rendering Microsoft Excel. La lunghezza massima consentita per l'attributo Name è 255 caratteri. Il nome deve essere univoco all'interno di tutte le voci dell'elemento Extension di un file di configurazione. Se è presente un nome duplicato, il server di report restituirà un errore. |
Type |
Elenco delimitato da virgole che include lo spazio dei nomi completo insieme al nome dell'assembly. |
Visible |
Il valore false indica che l'estensione per il rendering non deve essere visibile nelle interfacce utente. Se l'attributo non viene incluso, il valore predefinito è true. |
LogAllExecutionRequests |
Il valore false indica che una voce viene registrata solo per la prima esecuzione del report in una sessione. Se l'attributo non viene incluso, il valore predefinito è true. Questa impostazione determina ad esempio se registrare una voce solo per la prima pagina di cui viene eseguito il rendering in un report (quando il valore è false) o una voce per ogni pagina sottoposta a rendering nel report (quando il valore è true). |
Per ulteriori informazioni sul file RSReportServer.config, vedere File di configurazione RSReportServer.
Distribuzione dell'estensione nel server di report
Il server di report utilizza le estensioni per il rendering per esportare i report in altri formati. È necessario distribuire l'assembly dell'estensione per il rendering nel server di report come assembly privato. È inoltre necessario immettere una voce nel file di configurazione del server di report, rsreportserver.config.
Per distribuire l'assembly
Copiare l'assembly dal percorso di gestione temporanea nella directory bin del server di report in cui si desidera utilizzare l'estensione per il rendering. Il percorso predefinito della directory bin del server di report è C:\Programmi\Microsoft SQL Server\MSRS10<NomeIstanza>\Reporting Services\ReportServer\Bin.
Dopo aver copiato il file di assembly, aprire il file rsreportserver.config, situato nella directory bin del server di report. È necessario immettere una voce nel file di configurazione per il file di assembly dell'estensione. È possibile aprire il file in Microsoft Visual Studio .NET o in un semplice editor di testo, ad esempio Blocco note.
Per ulteriori informazioni, vedere File di configurazione RSReportServer.
Individuare l'elemento Render nel file Rsreportserver.config. È necessario immettere una voce per l'estensione appena creata nel percorso seguente:
<Extensions> <Render> <Your extension configuration information goes here> </Render> </Extensions>Aggiungere una voce per l'estensione per il rendering. La voce deve includere un elemento con valori per Name e Type e deve essere simile a quanto riportato di seguito:
<Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />Il valore per Name è il nome univoco dell'estensione per il rendering. Il valore per Type è un elenco delimitato da virgole che include una voce per lo spazio dei nomi completo dell'implementazione IRenderingExtension, seguito dal nome dell'assembly, senza l'estensione dll. Per impostazione predefinita, le estensioni per il rendering sono visibili. Per nascondere un'estensione dalle interfacce utente, come Gestione report, aggiungere un attributo Visible all'elemento Extension e impostarlo su false.
Verifica della distribuzione
È possibile verificare se l'estensione per il rendering è stata distribuita correttamente nel server di report tramite il metodo ListExtensions del servizio Web. È inoltre possibile aprire Gestione report e verificare che l'estensione sia inclusa nell'elenco dei tipi di esportazione disponibili per un report.