Distribuire un'estensione per il rendering

  • Articolo

Dopo aver scritto e compilato l'estensione per il rendering dei report di Reporting Services in una libreria .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 Estensione per il rendering dei file di configurazione

Dopo che un'estensione di rendering viene compilata in una DLL, si aggiunge una voce al file rsreportserver.config. Per impostazione predefinita, il percorso è %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer. L'elemento padre è \<Render>. Sotto l'elemento Render è 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.
Type Elenco delimitato da virgole che include lo spazio dei nomi completo insieme al nome dell'assembly.
Visible Un 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 File di configurazione RsReportServer.config.

Distribuire l'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.

Distribuire l'assembly

  1. 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 è %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer\Bin.

  2. 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 File di configurazione RsReportServer.config.

  3. 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>

  4. 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, come Gestione report, aggiungere un attributo Visible all'elemento Extension e impostarlo su false.

Verificare la distribuzione

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

Contenuto correlato