Distribuzione di un'estensione per il rendering

Articolo
05/07/2013

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. Per impostazione predefinita, il percorso è %Programmi%\Microsoft SQL Server\MSRS_50.<nomeistanza>\Reporting Services\ReportServer. 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
Nome	Nome univoco dell'estensione. 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.
Tipo	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, 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 è %Programmi%\Microsoft SQL Server\MSRS10_50.<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 con Visual Studio o con un semplice editor di testo.

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>
      <extension configuration>
   </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 di 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(ExtensionTypeEnum) 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.

Vedere anche

Concetti

Implementazione di un'estensione per il rendering

Cenni preliminari sulle estensioni per il rendering

Implementazione dell'interfaccia IRenderingExtension

Considerazioni sulla sicurezza per le estensioni

Condividi tramite