Procédure : inscrire un fournisseur de données .NET Framework standard

  • Article

Nouveau : 12 décembre 2006

Pour un utiliser un fournisseur de données .NET Framework tiers afin d'extraire des données pour un dataset de rapport Reporting Services, vous devez déployer et inscrire l'assembly de fournisseur de données .NET Framework dans deux emplacements : sur le client de création de rapports et sur le serveur de rapports. Sur le client de création de rapports, vous devez inscrire le fournisseur de données comme type de source des données et l'associer à un concepteur de requêtes. Vous pouvez ensuite sélectionner ce fournisseur de données comme type de source des données lorsque vous créez un dataset de rapport. Le concepteur de requêtes associé s'ouvre pour vous permettre de créer des requêtes pour ce type de source de données. Sur le serveur de rapports, vous devez inscrire le fournisseur de données comme type de source de données. Vous pouvez ensuite traiter les rapports publiés qui extraient les données d'une source de données à l'aide de ce fournisseur de données.

Les fournisseurs de données tiers ne prennent pas nécessairement en charge toutes les fonctionnalités fournies par les extensions pour le traitement des données Reporting Services. Pour plus d'informations, consultez Sources de données prises en charge par Reporting Services. Pour en savoir plus sur l'élargissement des fonctionnalités d'un fournisseur de données .NET Framework, consultez Implementing a Data Processing Extension.

Vous devez disposer des informations d'identification de l'administrateur pour installer et inscrire des fournisseurs de données.

Inscription d'un fournisseur de données .NET Framework sur le serveur de rapports

Afin de traiter les rapports publiés qui font appel à ce fournisseur de données .NET Framework sur le serveur de rapports, vous devez installer l'assembly sur le serveur de rapports. Vous devez modifier deux fichiers de configuration. Modifiez le fichier rsreportserver.config pour inscrire le fournisseur de données. Modifiez le fichier rssrvpolicy.config pour octroyer les autorisations de la sécurité d'accès du code pour l'assembly.

Pour installer un assembly de fournisseur de données sur le serveur de rapports

  1. Accédez à l'emplacement par défaut du répertoire bin sur le serveur de rapports sur lequel vous souhaitez utiliser le fournisseur de données .NET Framework. L'emplacement par défaut du répertoire bin du serveur de rapports est le suivant : <drive>:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin.

  2. Copiez votre assembly à partir de votre emplacement sur le répertoire bin du serveur de rapports. Une autre solution consiste à charger votre assembly dans le Global Assembly Cache (GAC). Pour plus d'informations, consultez Working with Assemblies and the Global Assembly Cache (en anglais) dans la documentation du SDK .NET Framework sur msdn.microsoft.com.

Pour inscrire un fournisseur de données .NET sur le serveur de rapports

  1. Faites une sauvegarde du fichier RSReportServer.config dans le répertoire parent ReportServer du répertoire bin.

  2. Ouvrez le fichier RSReportServer.config. Vous pouvez ouvrir le fichier de configuration à l'aide de Microsoft Visual Studio ou à l'aide d'un simple éditeur de texte tel que le Bloc-notes.

  3. Localisez l'élément Data dans le fichier RSReportServer.config. Effectuez une entrée pour le fournisseur de données .NET Framework à l'emplacement suivant :

    <Extensions>
   <Data>
      <Extension Your data provider configuration information goes here />
   </Data>
</Extensions>

  4. Ajoutez une entrée pour le fournisseur de données .NET Framework.

    Attribut Description

    Name

    Donnez un nom unique au fournisseur de données, par exemple, MyNETDataProvider. La longueur maximale de l'attribut Name est 255 caractères. Le nom doit être unique dans toutes les entrées au sein de l'élément Extension d'un fichier de configuration. La valeur que vous insérez à cet emplacement s'affiche dans la liste déroulante des types de source de données lorsque vous créez une nouvelle source de données.

    Type

    Entrez une liste séparée par des virgules qui comprend l'espace de noms complet de la classe qui implémente l'interface IDbConnection, suivie du nom de l'assembly du fournisseur de données .NET Framework (sans compter l'extension de nom de fichier .dll).

    Par exemple, l'entrée peut ressembler à ce qui suit pour un fichier .dll déployé vers le répertoire bin du serveur de rapports :

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

    si vous chargez votre assembly dans le GAC (Global Assembly Cache), vous devez fournir les propriétés de nom fort. Par exemple :

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

Pour définir la stratégie codegroup pour un fournisseur de données .NET.

  1. Faites une sauvegarde du fichier rssrvpolicy.config dans le répertoire parent ReportServer du répertoire bin.

  2. Ouvrez le fichier rssrvpolicy.config. Vous pouvez ouvrir le fichier de configuration à l'aide de Microsoft Visual Studio ou à l'aide d'un simple éditeur de texte tel que le Bloc-notes.

  3. Localisez l'élément CodeGroup dans le fichier rssrvpolicy.config.

  4. Ajoutez un groupe de codes pour l'assembly de fournisseur de données qui octroie l'autorisation FullTrust. Votre groupe de codes doit ressembler au code suivant :

    <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\MSSQL\Reporting Services\ReportServer\bin\DataProviderAssembly.dll"
       />
</CodeGroup>

L'appartenance d'URL n'est qu'une des nombreuses conditions d'appartenance que vous pouvez sélectionner pour le fournisseur de données. Pour plus d'informations sur la sécurité d'accès du code dans Reporting Services, consultez Understanding Code Access Security in Reporting Services.

Vérification du déploiement et de l'inscription

Vous pouvez vérifier si le fournisseur de données a été correctement déployé vers le serveur de rapports en ouvrant le Gestionnaire de rapports et en vérifiant que le fournisseur de données est inclut dans la liste des sources de données disponibles. Pour plus d'informations sur les sources de données et le Gestionnaire de rapports, consultez Création, modification et suppression de sources de données partagées.

Inscription d'un fournisseur de données .NET Framework sur le client du Concepteur de rapports

Afin de créer des rapports qui utilisent ce fournisseur de données .NET Framework pour une source de données, vous devez installer l'assembly sur votre ordinateur client qui exécute le Concepteur de rapports. Vous devez modifier deux fichiers de configuration. Modifiez le fichier RSReportDesigner.config pour inscrire le fournisseur de données comme source de données et pour utiliser le concepteur de requêtes générique. Modifiez le fichier RSPreviewPolicy.config pour octroyer les autorisations de la sécurité d'accès du code pour l'assembly de fournisseur de données.

Pour installer un assembly de fournisseur de données sur le client du Concepteur de rapports

  1. Accédez à l'emplacement par défaut du répertoire PrivateAssemblies sur le client du Concepteur de rapports sur lequel vous souhaitez utiliser le fournisseur de données .NET Framework. L'emplacement par défaut du répertoire PrivateAssemblies est <drive>:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies.

  2. Copiez votre assembly à partir de votre emplacement sur le répertoire PrivateAssemblies du client du Concepteur de rapports. Une autre solution consiste à charger votre assembly dans le Global Assembly Cache (GAC). Pour plus d'informations, consultez Working with Assemblies and the Global Assembly Cache (en anglais) dans la documentation du SDK .NET Framework sur msdn.microsoft.com.

Pour inscrire un fournisseur de données .NET sur le client du Concepteur de rapports

  1. Effectuez une copie de sauvegarde du fichier RSReportDesigner.config dans le répertoire PrivateAssemblies.

  2. Ouvrez le fichier RSReportDesigner.config à l'aide de Visual Studio ou à l'aide d'un simple éditeur de texte tel que le Bloc-notes.

  3. Localisez l'élément Data dans le fichier RSReportDesigner.config. Effectuez une entrée pour le fournisseur de données à l'emplacement suivant :

    <Extensions>
   <Data>
      <Extension Your data provider configuration information goes here />
   </Data>
</Extensions>

  4. Ajoutez une entrée pour le fournisseur de données .

    Attribut Description

    Name

    Donnez un nom unique au fournisseur de données, par exemple, MyNETDataProvider. La longueur maximale de l'attribut Name est 255 caractères. Le nom doit être unique dans toutes les entrées au sein de l'élément Extension d'un fichier de configuration. La valeur que vous insérez à cet emplacement s'affiche dans la liste déroulante des types de source de données lorsque vous créez une nouvelle source de données.

    Type

    Entrez une liste séparée par des virgules qui comprend l'espace de noms complet de la classe qui implémente l'interface IDbConnection, suivie du nom de l'assembly du fournisseur de données .NET Framework (sans compter l'extension de nom de fichier .dll).

    Par exemple, l'entrée peut ressembler à ce qui suit pour un fichier .dll déployé vers le répertoire PrivateAssemblies Visual Studio :

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

    si vous chargez votre assembly dans le GAC, vous devez fournir les propriétés de nom fort. Par exemple :

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

  5. Localisez l'élément Designer dans le fichier RSReportDesigner.config. Effectuez une entrée pour le fournisseur de données .NET Framework à l'emplacement suivant :

    <Extensions>
   <Designer>
      <Your data provider configuration information goes here>
   </Designer>
</Extensions>

  6. Ajoutez l'entrée suivante au fichier RSReportDesigner.config sous l'élément Designer. Il vous suffit de remplacer uniquement l'attribut Name par le nom que vous avez fourni dans les entrées précédentes.

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

Pour définir la stratégie codegroup pour un fournisseur de données .NET sur le client du Concepteur de rapports

  1. Effectuez une copie de sauvegarde du fichier RSPreviewPolicy.config dans le répertoire PrivateAssemblies.

  2. Ouvrez le fichier RSPreviewPolicy.config à l'aide de Visual Studio ou à l'aide d'un simple éditeur de texte tel que le Bloc-notes.

  3. Localisez l'élément CodeGroup dans le fichier RSPreviewPolicy.config.

  4. Ajoutez un groupe de codes pour l'assembly de fournisseur de données .NET Framework qui octroie l'autorisation FullTrust. Votre groupe de codes doit ressembler au code suivant :

    <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>

L'appartenance d'URL n'est qu'une des nombreuses conditions d'appartenance que vous pouvez sélectionner pour le fournisseur de données. Pour plus d'informations sur la sécurité d'accès du code dans Reporting Services, consultez Understanding Code Access Security in Reporting Services.

Vérification du déploiement et de l'inscription de le client du Concepteur de rapports

Avant de vérifier le déploiement, vous devez fermer toutes les instances de Visual Studio sur votre ordinateur local. Une fois que vous avez clôturé toutes les sessions en cours, vous pouvez vérifier si le fournisseur de données s'est déployé correctement dans le Concepteur de rapports en créant un nouveau projet de rapport dans Visual Studio. Le fournisseur de données doit être inclus dans la liste des types de source de données disponible lorsque vous créez un nouveau jeu de données pour votre rapport.

Considérations relatives à la plateforme

Sur une plateforme 64 bits (x64), SQL Server Business Intelligence Development Studio s'exécute en mode WOW 32 bits. Lorsque vous publiez des rapports sur une plateforme x64, vous devez disposer de fournisseurs de données 32 bits sur le client de création de rapports pour prévisualiser vos rapports. Si vous publiez le rapport sur le même système, il vous faut des fournisseurs de données x64 pour prévisualiser le rapport à l'aide du Gestionnaire de rapports.

Business Intelligence Development Studio n'est pas pris en charge pour les plateformes Itanium.

Les extensions pour le traitement des données installées à l'aide de Reporting Services doivent être compilées en mode natif pour chaque plateforme et installées dans les emplacements corrects. Si vous inscrivez un fournisseur de données personnalisé ou un fournisseur de données .NET Framework standard, celui-ci doit être compilé en mode natif pour la plateforme appropriée et installé dans les emplacements corrects. Si votre système s'exécute sur une plateforme 32 bits, le fournisseur de données doit être compilé pour une plateforme 32 bits. Si votre système s'exécute sur une plateforme 64 bits, le fournisseur de données doit être compilé pour la plateforme 64 bits. Si vous ne pouvez pas utiliser de fournisseur de données 32 bits intégré à des interfaces 64 bits sur une plateforme 64 bits. Vérifiez les informations sur votre logiciel tiers pour déterminer si le fournisseur de données fonctionne sur la plateforme installée. Pour plus d'informations sur les fournisseurs de données et la prise en charge de plateforme, consultez Sources de données prises en charge par Reporting Services.

Voir aussi

Concepts

Configuration des composants de Reporting Services

Autres ressources

Implementing a Data Processing Extension

Aide et Informations

Assistance sur SQL Server 2005