Distribuzione di un'estensione per il rendering

Articolo
06/13/2017

Dopo avere scritto e compilato l'estensione per il rendering del report di 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\MSRS10_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 seguente vengono descritti gli attributi per l'elemento per le estensioni per il Extension 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 è 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 è 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 altre informazioni, vedere RSReportServer Configuration File.

Distribuzione dell'estensione nel server di report

Il server di report usano 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 usare 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 altre informazioni, vedere RSReportServer Configuration File.
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 Typee 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 con valori delimitati 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, ad esempio Gestione report, aggiungere un attributo Visible all'elemento Extension e impostarlo su false.

Verifica della distribuzione

È inoltre possibile aprire Gestione report e verificare che l'estensione sia inclusa nell'elenco dei tipi di esportazione disponibili per un report.

Vedere anche

Implementazione di un'estensione per il rendering
Panoramica delle estensioni per il rendering
Implementazione dell'interfaccia IRenderingExtension
Considerazioni sulla sicurezza per le estensioni

Condividi tramite