Implantando uma extensão de renderização

Artigo
06/13/2017

Depois de escrever e compilar a extensão de renderização de relatório do Reporting Services para uma biblioteca do .NET Framework, você precisa torná-la detectável pelo servidor de relatório e pelo Designer de Relatórios. Para fazer isso, copie a extensão para o diretório apropriado e adicione entradas para os arquivos de configuração Reporting Services apropriados.

Elemento de extensão de renderização de arquivo de configuração

Quando uma extensão de renderização foi compilada em um .DLL, você adiciona uma entrada no arquivo rsreportserver.config. Por padrão, o local é em %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer. O elemento pai é <Render>. Sob o elemento Render, existe um elemento Extension para cada extensão de renderização. O elemento Extension contém dois atributos, Name e Type.

A tabela a seguir descreve os atributos do Extension elemento para extensões de renderização:

Atributo	Descrição
Nome	Um nome exclusivo para a extensão. O comprimento máximo do atributo Name é de 255 caracteres. O nome deve ser exclusivo entre todas as entradas do elemento Extension de um arquivo de configuração. Se um nome duplicado estiver presente, o servidor de relatório retornará um erro.
Tipo	Uma lista separada por vírgulas que inclui o namespace totalmente qualificado junto com o nome do assembly.
Visível	Um valor `false` indica que a extensão de renderização não deve ser visível nas interfaces do usuário. Se o atributo não for incluído, o valor padrão será `true`.
LogAllExecutionRequests	Um valor de `false` indica que uma entrada está registrada apenas para a primeira execução do relatório em uma sessão. Se o atributo não for incluído, o valor padrão será `true`. Esta configuração determina, por exemplo, se é preciso registrar uma entrada apenas para a primeira página renderizada de um relatório (quando `false`) ou uma entrada para cada página renderizada do relatório (quando `true`).

Para obter mais informações, consulte RSReportServer Configuration File.

Implantando a extensão para o Servidor de Relatório

O servidor de relatório usa extensões de renderização para exportar relatórios para outros formatos. Implante o seu assembly de extensão de renderização para o servidor de relatório como um assembly privado. Também será preciso criar uma entrada no arquivo de configuração do servidor de relatório, rsreportserver.config.

Para implantar o assembly

Copie o assembly do local de preparação para o diretório bin do servidor de relatório no qual você deseja usar a extensão de renderização. A localização padrão do diretório Bin do servidor de relatório é %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer\Bin.
Depois da cópia do arquivo de assembly, abra o arquivo rsreportserver.config. O arquivo rsreportserver.config também está localizado no diretório bin do servidor de relatório. Você precisa criar uma entrada no arquivo de configuração para o seu arquivo de assembly de extensão. Abra o arquivo com o Visual Studio ou um editor de texto simples.

Para obter mais informações, consulte RSReportServer Configuration File.
Localize o elemento Render no arquivo Rsreportserver.config. Uma entrada para a sua extensão recém-criada deve ser inserida no seguinte local:
```
<Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>  
```
Adicione uma entrada para sua extensão de renderização. A sua entrada deve incluir um elemento que possui valores para Name e Typee poderia ser assim:
```
<Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />  
```
O valor de Name é o nome exclusivo da extensão de renderização. O valor de Type é uma lista separada por vírgula que inclui uma entrada para o namespace totalmente qualificado da implementação do IRenderingExtension, seguida pelo nome do assembly (não incluindo a extensão de arquivo .dll). Por padrão, as extensões de renderização ficam visíveis. Para ocultar uma extensão de interfaces do usuário, como o Gerenciador de Relatórios, adicione um atributo Visible ao elemento e defina-o Extensionfalsecomo .

Verificando a implantação

Você também pode abrir o Gerenciador de Relatórios e verificar se a sua extensão foi incluída na lista de tipos de exportação disponíveis para um relatório.

Consulte Também

Implementar uma extensão de renderização
Visão geral das extensões de renderização
Implementar a interface IRenderingExtension
Considerações de segurança para extensões

Partilhar via