Share via


Como registrar um provedor de dados padrão do .NET Framework (Reporting Services)

Para usar um provedor de dados do .NET Framework terceirizado com o objetivo de recuperar dados para um conjunto de relatórios do Reporting Services, é preciso implantar e registrar o assembly do provedor de dados do .NET Framework em dois locais: no cliente que está criando o relatório e no servidor de relatório. No cliente que está criando o relatório, você deve registrar o provedor de dados como um tipo de fonte de dados e associá-lo a um designer de consulta. Você pode selecionar esse provedor de dados como um tipo de fonte de dados quando criar um conjunto de dados de relatório. O designer de consulta associado é aberto para ajudá-lo a criar consultas para esse tipo de fonte de dados. No servidor de relatório, é preciso registrar o provedor de dados como um tipo de fonte de dados. Você pode processar os relatórios publicados que recuperam dados a partir de uma fonte de dados usando este provedor de dados.

Os provedores de dados de terceiros não fornecem necessariamente todas as funções disponíveis nas extensões de processamento de dados do Reporting Services. Para obter mais informações, consulte Fontes de dados com suporte no Reporting Services. Para saber como estender a funcionalidade de um provedor de dados do ..NET Framework, consulte Implementando uma extensão de processamento de dados.

Você precisa ter credenciais de administrador para instalar e registrar provedores de dados.

Registrando um provedor de dados .NET Framework no Servidor de Relatórios

Para processar os relatórios publicados que usam esse provedor de dados do .NET Framework no servidor de relatórios, é preciso instalar o assembly no servidor de relatórios. Modifique dois arquivos de configuração. Modifique rsreportserver.config para registrar o provedor de dados. Modifique rssrvpolicy.config para conceder permissões de segurança de acesso do código para o assembly.

Para instalar um assembly do provedor de dados no servidor de relatórios

  1. Navegue até o local padrão do diretório \bin no servidor de relatórios no qual deseja usar o provedor de dados do .NET Framework. O local padrão do diretório \bin do servidor de relatórios é <drive>:\Arquivos de Programa\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin.

  2. Copie o assembly de seu local de preparação para o diretório \bin do servidor de relatórios. Como alternativa, você pode carregar seu assembly no cache de assembly global (GAC). Para obter mais informações, consulte Trabalhando com assemblies e cache de assembly global na documentação do SDK do .NET Framework no MSDN.

Para registrar um provedor de dados .NET Framework no servidor de relatórios

  1. Crie um backup do arquivo RSReportServer.config no diretório pai ReportServer do \bin.

  2. Abra o RSReportServer.config. Você pode abrir o arquivo de configuração com o Visual Studio ou um editor de texto simples, como o Bloco de notas.

  3. Localize o elemento Data no arquivo RSReportServer.config. Uma entrada para o provedor de dados do .NET Framework deve ser criada no seguinte local:

    <Extensions>
       <Data>
          <Extension Your data provider configuration information goes here />
       </Data>
    </Extensions>
    
  4. Adicione uma entrada para o provedor de dados do .NET Framework.

    Atributo

    Descrição

    Name

    Forneça um nome exclusivo para o provedor de dados, como, por exemplo, MeuProvedorDadosNET. O comprimento máximo do atributo Name é de 255 caracteres. O nome deve ser exclusivo entre todas as entradas dento do elemento Extension de um arquivo de configuração. O valor incluído aqui será exibido na lista suspensa dos tipos de fonte de dados quando você criar uma nova fonte de dados.

    Type

    Insira uma lista separada por vírgulas que inclua o namespace totalmente qualificado da classe que implementa a interface IDbConnection, seguida pelo nome do assembly do provedor de dados do .NET Framework (sem incluir a extensão do nome do arquivo .dll).

    Por exemplo, a entrada deve ser semelhante à seguinte para uma DLL implantada no servidor de relatórios do diretório \bin:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" /> 
    

    Se você carregar seu assembly no cache de assembly global (GAC), poderá fornecer as propriedades de nome forte. Por exemplo:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly,Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>
    

Para definir a diretiva do grupo de códigos para um provedor de dados .NET

  1. Faça uma cópia de backup do arquivo rssrvpolicy.config no diretório pai ReportServer do \bin.

  2. Abra o rssrvpolicy.config. Você pode abrir o arquivo de configuração com o Visual Studio ou um editor de texto simples, como o Bloco de notas.

  3. Localize o elemento CodeGroup no arquivo rssrvpolicy.config.

  4. Adicione um grupo de códigos para o assembly do provedor de dados que conceda permissão FullTrust. O grupo de códigos deve ser semelhante ao seguinte:

    <CodeGroup class="UnionCodeGroup"
       version="1"
       PermissionSetName="FullTrust"
       Name="ThisDataProviderCodeGroup"
       Description="Code group for the .NET data provider">
          <IMembershipCondition class="UrlMembershipCondition"
             version="1"
             Url=
    "C:\Program Files\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin\DataProviderAssembly.dll"
           />
    </CodeGroup>
    

A associação da URL é apenas uma das condições de associação que você pode selecionar para o provedor de dados.

Verificando a implantação e o registro

Você pode verificar se o provedor de dados foi implantado com sucesso no servidor de relatórios abrindo o Gerenciador de Relatórios e verificando se o provedor de dados está incluído na lista de fontes de dados disponíveis. Para obter mais informações sobre Gerenciador de Relatórios e fontes de dados, consulte Criando, modificando e excluindo fontes de dados compartilhadas.

Registrando um provedor de dados .NET Framework no Cliente do Designer de Relatórios

Para criar relatórios que usam esse provedor de dados do .NET Framework em uma fonte de dados, é preciso instalar o assembly no computador cliente que estiver executando o Designer de Relatórios. Modifique dois arquivos de configuração. Modifique o arquivo RSReportDesigner.config para registrar o provedor de dados como uma fonte de dados e para usar o designer de consulta genérico. Modifique RSPreviewPolicy.config para conceder permissões de segurança de acesso do código para o assembly do provedor de dados.

Para instalar um assembly do provedor de dados no cliente do Designer de Relatórios

  1. Navegue até o local padrão do diretório PrivateAssemblies no cliente do Designer de Relatórios no qual deseja usar o provedor de dados do .NET Framework. O local padrão do diretório PrivateAssemblies é <drive>:\Arquivos de Programas\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.

  2. Copie o assembly de seu local de preparação para o diretório PrivateAssemblies do cliente do Designer de Relatórios. Como alternativa, você pode carregar seu assembly no cache de assembly global (GAC). Para obter mais informações, consulte Trabalhando com assemblies e cache de assembly global na documentação do SDK do .NET Framework no MSDN.

Para registrar um provedor de dados .NET no cliente do Designer de Relatórios

  1. Faça uma cópia de backup do arquivo RSReportDesigner.config no diretório PrivateAssemblies.

  2. Abra o arquivo RSReportDesigner.config com o Visual Studio ou um editor de texto simples, como o Bloco de notas.

  3. Localize o elemento Data no arquivo RSReportDesigner.config. Uma entrada para o provedor de dados deve ser criada no seguinte local:

    <Extensions>
       <Data>
          <Extension Your data provider configuration information goes here />
       </Data>
    </Extensions>
    
  4. Adicione uma entrada para o provedor de dados.

    Atributo

    Descrição

    Name

    Forneça um nome exclusivo para o provedor de dados, como, por exemplo, MeuProvedorDadosNET. O comprimento máximo do atributo Name é de 255 caracteres. O nome deve ser exclusivo entre todas as entradas dento do elemento Extension de um arquivo de configuração. O valor incluído aqui será exibido na lista suspensa dos tipos de fonte de dados quando você criar uma nova fonte de dados.

    Type

    Insira uma lista separada por vírgulas que inclua o namespace totalmente qualificado da classe que implementa a interface IDbConnection, seguida pelo nome do assembly do provedor de dados do .NET Framework (sem incluir a extensão do nome do arquivo .dll).

    Por exemplo, a entrada deve ser semelhante à seguinte para uma DLL implantada no diretório PrivateAssemblies do Visual Studio:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" /> 
    

    Se você carregar seu assembly no GAC, poderá fornecer as propriedades de nome forte. Por exemplo:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>
    
  5. Localize o elemento Designer no arquivo RSReportDesigner.config. Uma entrada para o provedor de dados do .NET Framework deve ser criada no seguinte local:

    <Extensions>
       <Designer>
          <Your data provider configuration information goes here>
       </Designer>
    </Extensions>
    
  6. Adicione a seguinte entrada ao arquivo RSReportDesigner.config no elemento Designer: apenas o atributo Name precisará ser substituído pelo nome que você forneceu nas entradas anteriores.

    <Extension Name="MyNETDataProvider" Type="Microsoft.ReportingServices.QueryDesigners.GenericQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
    

Para definir a diretiva do grupo de códigos para um provedor de dados .NET no cliente do Designer de Relatórios

  1. Faça uma cópia de backup do arquivo RSPreviewPolicy.config no diretório PrivateAssemblies.

  2. Abra o arquivo RSPreviewPolicy.config com o Visual Studio ou um editor de texto simples, como o Bloco de notas.

  3. Localize o elemento CodeGroup no arquivo RSPreviewPolicy.config.

  4. Adicione um grupo de códigos para o assembly do provedor de dados do .NET Framework que conceda permissão FullTrust. O grupo de códigos deve ser semelhante ao seguinte:

    <CodeGroup class="UnionCodeGroup"
       version="1"
       PermissionSetName="FullTrust"
       Name="ThisDataProviderCodeGroup"
       Description="Code group for the .NET data provider">
          <IMembershipCondition class="UrlMembershipCondition"
             version="1"
             Url=
    " C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies\ DataProviderAssembly.dll"
           />
    </CodeGroup>
    

A associação da URL é apenas uma das condições de associação que você pode selecionar para o provedor de dados.

Verificando a implantação e o registro no Cliente do Designer de Relatórios

Antes de verificar a implantação, é preciso fechar todas as instâncias do Visual Studio no computador local. Depois de encerrar todas as sessões atuais, você poderá verificar se o provedor de dados foi implantado com êxito ao Designer de Relatórios criando um novo projeto de relatório no Visual Studio. O provedor de dados deve ser incluído na lista de tipos de fontes de dados disponíveis quando você criar um novo conjunto de dados para o relatório.

Considerações sobre plataformas

Em uma plataforma de 64 bits (x64), o Business Intelligence Development Studio é executado no modo WOW de 32 bits. Quando você cria relatórios em uma plataforma x64, é preciso que os provedores de dados de 32 bits estejam instalados no cliente que está criando o relatório para que seja possível visualizá-los. Ao publicar o relatório no mesmo sistema, é preciso que os provedores de dados de x64 estejam instalados para permitir a exibição do relatório com o Gerenciador de Relatórios.

Não há suporte para o Business Intelligence Development Studio em computadores com plataformas com base em Itanium.

As extensões de processamento de dados que estão instaladas com o Reporting Services devem ser compiladas em modo nativo para cada plataforma e instaladas nos locais corretos. Se você registrar um provedor de dados personalizado ou um provedor de dados padrão do .NET Framework, sua compilação deverá ser executada em modo nativo para a plataforma adequada e a instalação deverá ocorrer em locais apropriados. Caso a execução esteja sendo realizada em uma plataforma de 32 bits, o provedor de dados deverá ser compilado para uma plataforma de 32 bits. Caso a execução esteja sendo realizada em uma plataforma de 64 bits, o provedor de dados deverá ser compilado para uma plataforma de 64 bits. Não é permitido usar um provedor de dados de 32 bits com interfaces de 64 bits em uma plataforma de 64 bits. No software de terceiro, procure por informações que possam indicar se o provedor de dados funcionará na plataforma em que você deseja instalá-lo. Para obter mais informações sobre os provedores de dados e suporte a plataformas, consulte Fontes de dados com suporte no Reporting Services.