Implantar uma extensão de renderização
Depois de escrever e compilar sua extensão de renderização de relatório do Reporting Services em 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.
Depois que uma extensão de renderização é compilada em um .DLL, você adiciona uma entrada ao arquivo rsreportserver.config. Por padrão, o local é %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer
. O elemento pai é \<Render>
. No elemento Render, é 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 para o elemento Extension para as 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 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 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 estiver 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 Arquivo de configuração RsReportServer.config.
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.
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. 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 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 Arquivo de configuração RsReportServer.config.
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 Extension e defina-o como false.
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.