Share via

  • Artigo

Implantando uma extensão de renderização

Depois de ter escrito e compilado a sua extensão de renderização de relatório do Reporting Services para uma biblioteca do .NET Framework, será necessário torná-la descobrí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

Depois que a extensão de renderização tiver sido compilada em uma .DLL, adicione uma entrada ao arquivo rsreportserver.config, localizado na pasta C:\Arquivos de Programas\Microsoft SQL Server\MSRS10.<NomeInstância>\Reporting Services\ReportServer\Bin, se o local de instalação padrão foi selecionado durante a instalação. 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 para o elemento Extension para as extensões de renderização.

Atributo

Descrição

Name

Um nome exclusivo para a extensão, por exemplo, "EXCEL" para a extensão de renderização Microsoft Excel. O tamanho 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.

Type

Uma lista separada por vírgulas que inclui o namespace totalmente qualificado junto com o nome do assembly.

Visible

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 sobre o arquivo RSReportServer.config, consulte Arquivo de configuração RSReportServer.

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

  1. Copie o seu assembly de seu 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 é C:\Arquivos de Programas\Microsoft SQL Server\MSRS10.<NomeInstância>\Reporting Services\ReportServer\Bin.

  2. 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 Microsoft Visual Studio .NET ou com um editor de texto simples, como o Bloco de notas.

    Para obter mais informações, consulte Arquivo de configuração RSReportServer.

  3. 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>
      <Your extension configuration information goes here>
   </Render>
</Extensions>

  4. Adicione uma entrada para sua extensão de renderização. A sua entrada deve incluir um elemento com valores para Name e Type e 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írgulas que inclui uma entrada para o namespace totalmente qualificado da sua implementação IRenderingExtension, seguida pelo nome do seu 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.

Verificando a implantação

Você pode verificar se sua extensão de renderização foi implantada com êxito no servidor de relatório usando o método ListExtensions do serviço Web. 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.