Fichier Lisezmoi de l'exemple d'extension pour le traitement des données de partage de fichiers

Article
09/18/2009

Cet exemple fonctionne uniquement avec SQL Server 2005 et SQL Server 2008. Il ne fonctionnera pas avec les versions de SQL Server antérieures à SQL Server 2005.

FsiDataExtension est une simple extension pour le traitement des données pour le système de fichiers Windows. Il utilise les bibliothèques de classe du Microsoft .NET Framework System.IO.DirectoryInfo et System.IO.FileSystemInfo pour interroger le contenu d'un partage de fichiers réseau valide. L'exemple utilise les interfaces d'extension pour le traitement des données ainsi que d'autres classes du .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 les systèmes d'exploitation Itanium.

Important :
Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun 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.

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun 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.

Spécifications

Vous devez être familier de Microsoft Visual Studio et Microsoft Visual C# ou Microsoft Visual Basic, et les produits suivants doivent être installés pour utiliser l'exemple FsiDataExtension :

Microsoft Visual Studio 2005 ou un environnement de développement compatible (pour l'affichage des fichiers de projet).
Microsoft SQL Server, incluant Reporting Services.
Microsoft .NET Framework 2.0.
Exemples Reporting Services. Vous pouvez choisir d'installer les exemples pendant l'installation de SQL Server. 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.
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.

Important :
Les exemples SQL Server et les exemples de bases de données doivent être téléchargés et installés pour que vous puissiez les afficher ou les utiliser. Pour plus d'informations, consultez Considérations relatives à l'installation d'exemples de bases de données et d'exemples de code SQL Server.

Emplacement

Par défaut, cet exemple est disponible dans le répertoire suivant :

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

Génération de l'exemple

Procédez comme suit 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

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.

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

Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur 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.

À 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 avec nom fort, consultez « Security Briefs: Strong Names and Security in the .NET Framework » (en anglais) dans le Centre de Développement du .NET sur MSDN.

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

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

Exécutez les commandes suivantes pour créer l'exemple d'extension pour le traitement des 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

Ouvrez le fichier solution FsiDataExtension (FsiDataExtensionCS.sln ou FsiDataExtensionVB.sln) dans Visual Studio 2005.
Dans l'Explorateur de solutions, sélectionnez le projet FsiDataExtension.
Dans le menu Projet, cliquez sur Ajouter une référence.
Dans la boîte de dialogue Ajouter des références, cliquez sur l'onglet .NET.
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.

Remarque :

La référence a peut-être été déjà ajoutée à votre projet. Si tel est le cas, vous n'avez pas besoin de rajouter une référence.
Dans le menu Générer, cliquez sur Générer la solution.

Remarque :
La référence a peut-être été déjà ajoutée à votre projet. Si tel est le cas, vous n'avez pas besoin de rajouter une référence.

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

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\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin.
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 9.0\Common7\IDE\PrivateAssemblies.
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 9.0\Common7\IDE\PrivateAssemblies et l'emplacement par défaut du fichier RSReportServer.config est C:\Program Files\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer) :
```
<Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>
```
Pour activer le concepteur de requêtes générique pour l'exemple d'extension pour le traitement des données, ajoutez l'entrée suivante au fichier RSReportDesigner.config sous l'élément Designer.
```
<Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
```

Pour plus d'informations sur le déploiement des extensions pour le traitement des données, consultez Déploiement d'une extension pour le traitement des données.

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

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\MSRS10.MSSQLSERVER\Reporting Services\ReportServer.

Le niveau de confiance totale doit être accordé aux extensions pour le traitement des données. Pour cela, 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\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>

Si vous utilisez l'exemple d'extension pour le 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 9.0\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 9.0\Common7\IDE\PrivateAssemblies.

Pour plus d'informations sur la sécurité .NET Framework et sur Reporting Services, consultez Développement sécurisé (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

Cliquez sur Démarrer, pointez sur Tous les programmes, pointez sur Microsoft SQL Server 2008, puis cliquez sur Business Intelligence Development Studio.
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Dans la liste Types de projets, cliquez sur Projects Business Intelligence.
Dans la liste Modèles, cliquez sur Projet Report Server.
Dans Nom, tapez FsiReportProject.
Cliquez sur OK pour créer le projet de rapport.

Pour créer le rapport

Dans le menu Projet, cliquez sur Ajouter un nouvel élément.
Dans la liste Catégories, cliquez sur Projet de rapport.
Dans la liste Modèles, cliquez sur Rapport.
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

Dans le volet Données, cliquez sur Nouveau, puis sélectionnez Nouveau dataset.
Sous l'onglet Requête, dans la zone de texte Nom, tapez FsiDataSource.
Dans la liste Type, sélectionnez Informations de partage de fichiers.
Laissez la zone ConnectionString vide. L'exemple d'extension de données n'utilise pas de chaîne de connexion.

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 tentez d'accéder à un partage de fichiers réseau, sauf si ces informations ont été mises en cache.

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

Pour afficher le dataset

En mode Données, le concepteur de requêtes générique s'affiche. Dans Type de commande, sélectionnez Texte.
Dans le volet de requête, directement sous la barre d'outils du concepteur de requêtes générique, tapez le chemin d'un partage de fichiers réseau disponible sur votre réseau. Entrez par exemple \\Ordinateur1\Public.
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 apparaissent en dessous, dans le volet d'informations.

Pour concevoir la mise en page du rapport

En mode Conception, dans la Boîte à outils, cliquez sur Table.
Faites glisser le contrôle Tableau sur l'aire de conception.
Dans le volet Données du rapport, faites glisser la zone Nom vers la première cellule de la ligne Détail. Si nécessaire, ajoutez les champs à la table.

Pour prévisualiser le rapport

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