Exemple d'extension de traitement de données de partage de fichiers

Mis à jour : 5 décembre 2005

FsiDataExtension est une simple extension de traitement de données pour le système de fichiers Windows. Cette extension utilise les classes de bibliothèque Microsoft .NET Framework DirectoryInfo et FileSystemInfo pour interroger le contenu de n'importe quel partage de fichiers réseau. L'exemple utilise les interfaces d'extension de traitement de données ainsi que d'autres classes .NET Framework. La convention d'attribution de noms utilisée pour l'exemple emploie le préfixe « Fsi », pour File Share Information. Cet exemple n'est pas pris en charge sur des systèmes d'exploitation Itanium.

Les exemples SQL Server ne sont pas installés automatiquement lors de l'installation. Pour obtenir des instructions sur l'installation des exemples, consultez Installation des exemples.

Important :

Les exemples sont fournis uniquement à titre éducatif. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft n'assure pas de support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Configuration requise

Vous devez connaître Microsoft Visual Studio et être familiarisé avec le langage Microsoft Visual C# ou Microsoft Visual Basic. L'installation des éléments suivants est également indispensable pour l'utilisation de l'exemple FsiDataExtension :

• Microsoft Visual Studio 2005 ou un environnement de développement compatible (pour l'affichage des fichiers de projet).
• Microsoft SQL Server 2005, y compris Reporting Services.
• Microsoft .NET Framework version 2.0
• Les exemples de Reporting Services. Vous pouvez choisir d'installer les exemples pendant l'installation de SQL Server 2005. Pour cette version, lorsque vous choisissez d'installer les exemples, un programme d'installation distinct est installé sur votre ordinateur ; il vous permet d'extraire et d'installer les exemples. Vous pouvez exécuter ce programme d'installation à partir du menu Démarrer dans le groupe de programmes Microsoft SQL Server 2005.
• Un serveur de rapports auquel vous avez l'autorisation d'accéder sur votre réseau, si vous avez l'intention d'utiliser l'exemple d'extension pour ajouter des fonctionnalités de traitement de données supplémentaires à votre serveur.

Emplacement

Cet exemple se trouve dans le sous-répertoire Extension Samples\FsiDataExtension Sample du répertoire d'exemples de Reporting Services.

Exemple :

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\FindRenderSave Sample

Génération de l'exemple

Utilisez la procédure suivante pour générer l'exemple.

Si vous n'avez pas encore créé un fichier de clé de nom fort, utilisez la procédure suivante pour générer ce fichier.

Pour générer un fichier de clé de nom fort

1. Ouvrez une invite de commandes Microsoft Visual Studio 2005. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

   -- Ou --

   Ouvrez une invite de commandes Microsoft .NET Framework. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

2. Utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif dans la fenêtre de l'invite de commandes par le dossier dans lequel les exemples sont installés.

   Remarque :

   Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur le bouton Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels, puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\100\Samples.

3. À l'invite de commandes, exécutez la commande suivante pour générer le fichier de clé :

   sn -k SampleKey.snk

   Important :
   Pour plus d'informations sur la paire de clés de nom fort, consultez l'article de sécurité concernant les noms forts et la sécurité dans .NET Framework, dans le Centre de développement .NET sur MSDN.

Pour compiler l'exemple à l'aide du Kit de développement .NET Framework (SDK)

1. Copiez le fichier Microsoft.ReportingServices.Interfaces.dll du répertoire \bin de votre serveur de rapports dans votre dossier d'exemples.

2. Exécutez les commandes suivantes pour créer l'exemple d'extension de traitement de données Microsoft.Samples.ReportingServices.FsiDataExtension.dll.

   csc.exe /t:library /out:Microsoft.Samples.ReportingServices.FsiDataExtension.dll *.cs .\properties\*.cs /res:.\properties\Resources.resx  /r:Microsoft.ReportingServices.Interfaces.dll
   

Pour compiler l'exemple à l'aide de Visual Studio .NET

1. Ouvrez le fichier solution FsiDataExtension (FsiDataExtensionCS.sln ou FsiDataExtensionVB.sln) dans Visual Studio 2005.

2. Dans l'Explorateur de solutions, sélectionnez le projet FsiDataExtension.

3. Dans le menu Projet, cliquez sur Ajouter une référence.

   La boîte de dialogue Ajouter une référence s'ouvre.

4. Cliquez sur l'onglet .NET.

5. Cliquez sur Parcourir, puis recherchez Microsoft.ReportingServices.Interfaces sur votre lecteur local. Par défaut, cet assembly se trouve dans le répertoire ReportServer\bin. Cliquez sur OK.

   La référence sélectionnée est ajoutée à votre projet.

6. Dans le menu Générer, cliquez sur Générer la solution.

Déploiement de l'exemple

Une fois les étapes précédentes terminées, vous pouvez déployer Microsoft.Samples.ReportingServices.FsiDataExtension.dll sur un serveur de rapports ou dans le Générateur de rapports afin qu'il soit utilisé pour exécuter des rapports à partir d'une source de données personnalisée.

Pour déployer l'exemple

1. Copiez Microsoft.Samples.ReportingServices.FsiDataExtension.dll sur le serveur de rapports. L'emplacement par défaut des extensions du serveur de rapports est le suivant : C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin.

2. Copiez l'assembly sur le Générateur de rapports. L'emplacement par défaut des extensions pour le Générateur de rapports est le suivant : C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies.

3. Ajoutez l'entrée suivante aux fichiers RSReportServer.config et RSReportDesigner.config sous l'élément Data (par défaut, le fichier RSReportDesigner.config se trouve dans le répertoire C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies et le fichier RSReportServer.config dans le répertoire C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer) :

   <Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>
   

4. Pour activer le Concepteur de requêtes génériques pour l'exemple d'extension de traitement des données, ajoutez l'entrée suivante sous l'élément <Designer> du fichier RSReportDesigner.config.

   <Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
   

Pour plus d'informations sur le déploiement des extensions de traitement de données, consultez Deploying a Data Processing Extension.

Pour configurer la sécurité de l'accès au code de l'exemple

1. Ouvrez le fichier de configuration de la stratégie du serveur de rapports (rssrvpolicy.config). L'emplacement par défaut de ce fichier est C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer.

2. Le niveau de confiance totale doit être accordé aux extensions pour le traitement des données. Pour ce faire, ajoutez les informations de groupe de codes suivantes à la fin de la section des groupes de codes du fichier de configuration :

   <CodeGroup class="UnionCodeGroup"
      version="1"
      PermissionSetName="FullTrust"
      Name="FSICodeGroup"
      Description="Code group for my FSI data processing extension">
         <IMembershipCondition class="UrlMembershipCondition"
            version="1"
            Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
          />
   </CodeGroup>
   

3. Si vous utilisez l'exemple d'extension de traitement des données dans le Générateur de rapports, recommencez les étapes 1 et 2 en utilisant le fichier de configuration de la stratégie d'aperçu du Générateur de rapports (rspreviewpolicy.config) et le groupe de codes suivant :

   <CodeGroup class="UnionCodeGroup"
      version="1"
      PermissionSetName="FullTrust"
      Name="FSICodeGroup"
      Description="Code group for my FSI data processing extension">
         <IMembershipCondition class="UrlMembershipCondition"
            version="1"
            Url="C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
          />
   </CodeGroup>
   

   L'emplacement par défaut du fichier rspreviewpolicy.config est C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies.

   Pour plus d'informations sur la sécurité .NET Framework et Reporting Services, consultez Understanding Code Access Security in Reporting Services.

Création d'un rapport qui utilise l'extension FsiDataExtension

Cette section contient une procédure pas à pas expliquant rapidement comment créer un exemple de rapport qui utilise l'exemple d'extension de données.

Remarque :
Vous devez déployer l'exemple d'extension de données du partage de fichiers sur le Générateur de rapports et sur le serveur de rapports avant de créer un rapport. Vous devez également activer le concepteur de requêtes génériques pour l'extension. Pour plus d'informations, consultez « Déploiement de l'exemple », plus haut dans cette rubrique.

Pour créer le projet de rapport

1. Cliquez sur Démarrer, pointez sur Programmes, pointez sur Microsoft SQL Server 2005, puis cliquez sur Business Intelligence Development Studio.

2. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.

3. Dans la liste Types de projets, cliquez sur Projects Business Intelligence.

4. Dans la liste Modèles, cliquez sur Projet Report Server.

5. Dans Nom, tapez FsiReportProject.

6. Cliquez sur OK pour créer le projet de rapport.

Pour créer le rapport

1. Dans le menu Projet, cliquez sur Ajouter un nouvel élément.

2. Dans la liste Catégories, cliquez sur Projet de rapport.

3. Dans la liste Modèles, cliquez sur Rapport.

4. Dans la zone Nom, tapez FsiReport, puis cliquez sur Ouvrir.

Pour ajouter une source de données qui utilise l'exemple d'extension de données

1. En mode Données, dans Dataset, sélectionnez <Nouveau dataset...>.

   La boîte de dialogue Source de données s'affiche.

2. Sous l'onglet Général, dans la zone de texte Nom, tapez FsiDataSource.

3. Dans la liste Type, sélectionnez Informations de partage de fichiers.

4. Laissez la zone ConnectionString vide. L'exemple d'extension de données n'utilise pas de chaîne de connexion.

5. Sous l'onglet Informations d'identification, cliquez sur un des types de connexion au serveur. Vous pouvez entrer le nom d'utilisateur et le mot de passe pour le partage de fichiers auquel votre exemple d'extension de fichier accédera. Cliquez sur Utiliser l'authentification Windows (sécurité intégrée), puis sur Utiliser un nom d'utilisateur et un mot de passe spécifiques et entrez des informations d'identification ; ou bien, cliquez sur Demander des informations d'identification et entrez une chaîne d'invite.

   Remarque relative à la sécurité :
   Autant que possible, utilisez l'authentification Windows. Vous serez invité à fournir vos informations d'identification réseau chaque fois que vous essaierez d'accéder à un partage de fichiers réseau, sauf si ces informations ont été mises en cache.

6. Cliquez sur OK pour enregistrer la source de données.

Pour afficher le dataset

1. En mode Données, le concepteur de requêtes génériques est affiché. Dans Type de commande, sélectionnez Texte.

2. Dans le volet de requête directement sous la barre d'outils du concepteur de requêtes génériques, tapez le chemin d'un partage de fichiers réseau disponible sur votre réseau. Entrez par exemple \\Ordinateur1\Public.

3. Dans la barre d'outils du concepteur de requêtes génériques, cliquez sur le bouton Exécuter (!).

   Les données du partage de fichiers doivent apparaître en dessous, dans le volet des résultats.

Pour concevoir la mise en page du rapport

1. En mode Disposition, dans la boîte à outils, cliquez sur Tableau.

2. Faites glisser le contrôle Tableau sur l'aire de conception.

3. Dans la fenêtre Champs, faites glisser la zone Nom jusqu'à la première cellule de la ligne Détail. Ajoutez s'il y a lieu des champs supplémentaires au tableau.

Pour prévisualiser le rapport

1. Cliquez sur l'onglet Aperçu pour afficher un aperçu du rapport. Suivant vos paramètres d'informations d'identification pour FsiDataSource, vous pouvez être invité à entrer un nom d'utilisateur et un mot de passe.

Voir aussi

Tâches

Compilation et exécution d'exemples de code
Exemples SQL Server Reporting Services

Autres ressources

Exemples d'extensions (Reporting Services)
Implementing a Data Processing Extension

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications