Implantando uma extensão de renderização

2017-06-13

Depois de escrever e compilar sua extensão de renderização de relatório do Reporting Services em uma biblioteca do .NET Framework, você precisará 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 aos arquivos de configuração apropriados do Reporting Services.

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

Depois que uma extensão de renderização tiver sido compilada em um .DLL, você adicionará uma entrada ao arquivo rsreportserver.config. Por padrão, o local é %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer. O elemento pai é <Renderização>. No elemento Renderização há um elemento Extension para cada extensão de renderização. O Extension elemento contém dois atributos, Nome e Tipo.

A tabela a seguir descreve os atributos do Extension elemento para renderizar extensões:

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 dentro do elemento Extensões 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 indica `false` que a extensão de renderização não deve estar visível nas interfaces do usuário. Se o atributo não estiver incluído, o valor padrão será `true`.
LogAllExecutionRequests	Um valor indica `false` que uma entrada é registrada apenas para a primeira execução de relatório em uma sessão. Se o atributo não estiver incluído, o valor padrão será `true`. Por exemplo, essa configuração determina se uma entrada deve ser registrada apenas para a primeira página renderizada em um relatório (quando `false`) ou uma entrada para cada página renderizada no relatório (quando `true`).

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

Implantando a extensão no servidor de relatório

O servidor de relatório usa extensões de renderização para exportar relatórios para outros formatos. Você deve implantar o assembly de extensão de renderização no servidor de relatório como um assembly privado. Você também precisa fazer uma entrada no arquivo de configuração do servidor de relatório, rsreportserver.config.

Para implantar o assembly

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

Para obter mais informações, consulte RSReportServer Configuration File.
Localize o elemento Renderizar no arquivo Rsreportserver.config. Uma entrada para sua extensão recém-criada deve ser feita no seguinte local:
```
<Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>  
```
Adicione uma entrada para sua extensão de renderização. Sua entrada deve incluir um elemento que tenha valores para Nome e Tipo e pode ser semelhante ao seguinte:
```
<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írgulas que inclui uma entrada para o namespace totalmente qualificado de sua IRenderingExtension implementação, seguida pelo nome do assembly (sem incluir a extensão de arquivo .dll). Por padrão, as extensões de renderização são 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 Extension como false.

Verificando a implantação

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

Consulte Também

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

Partilhar via