Procédure : déployer une extension pour le traitement des données sur le Concepteur de rapports

Article
05/07/2013

Le Concepteur de rapports utilise des extensions pour le traitement des données afin de récupérer et traiter des données pendant que vous concevez des rapports. Vous devez déployer votre assembly d'extension pour le traitement des données sur le Concepteur de rapports en tant qu'assembly privé. Vous devez également créer une entrée dans le fichier de configuration du Concepteur de rapports (RSReportDesigner.config.)

Pour déployer un assembly d'extension pour le traitement des données

Copiez votre assembly depuis son emplacement intermédiaire vers le répertoire du Concepteur de rapports. L'emplacement par défaut du répertoire du Concepteur de rapports est le suivant : C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.
Une fois le fichier d'assembly copié, ouvrez le fichier RSReportDesigner.config. Le fichier RSReportDesigner.config se trouve également dans le répertoire du Concepteur de rapports. Vous devez créer une entrée dans le fichier de configuration correspondant à votre fichier d'assembly d'extension pour le traitement des données. Vous pouvez ouvrir le fichier de configuration à l'aide de Microsoft Visual Studio ou d'un simple éditeur de texte, tel que le Bloc-notes.
Localisez l'élément Data dans le fichier RSReportDesigner.config. L'entrée correspondant à votre nouvelle extension pour le traitement des données doit être créée à l'emplacement suivant :
```
<Extensions>
   <Data>
      <Your extension configuration information goes here>
   </Data>
</Extensions>
```
Ajoutez une entrée pour votre extension pour le traitement des données qui inclut un élément Extension avec des valeurs pour les attributs Name, Type et Visible. Votre entrée peut se présenter comme suit :
```
<Extension Name="ExtensionName" Type="CompanyName.ExtensionName.MyConnectionClass, AssemblyName" />
```
La valeur Name doit correspondre au nom unique de l'extension utilisée pour le traitement des données. La valeur Type est une liste séparée par des virgules comportant une entrée dans laquelle doit figurer l'espace de noms complet de la classe qui implémente les interfaces IExtension et IDbConnection, suivi du nom de votre assembly (l'extension de fichier .dll ne doit pas figurer dans cette entrée). Par défaut, les extensions pour le traitement des données sont visibles. Pour masquer une extension des interfaces utilisateur, telles que le Concepteur de rapports, ajoutez un attribut Visible à l'élément Extension, puis attribuez à cet élément la valeur false.

Enfin, vous devez définir un groupe de codes pour votre assembly personnalisé octroyant l'autorisation FullTrust à votre extension. Pour cela, ajoutez le groupe de codes au fichier rspreviewpolicy.config qui se trouve par défaut à l'emplacement C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies. Ce groupe de codes peut se présenter comme suit :

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

L'appartenance URL n'est qu'une des nombreuses conditions d'appartenance que vous pouvez sélectionner pour l'extension permettant le traitement des données. Pour plus d'informations sur la sécurité d'accès du code dans SQL Server 2005 Reporting Services (SSRS), consultez Développement sécurisé (Reporting Services).

Concepteur de requêtes générique

Le Concepteur de rapports fournit un concepteur de requêtes générique que vous pouvez utiliser avec des extensions pour le traitement des données personnalisées. Ce concepteur comprend deux volets : un volet de requête et un volet de résultats. Vous pouvez utiliser le concepteur générique pour écrire des requêtes qui ne sont pas prises en charge par l'interface graphique. Contrairement au concepteur de requêtes graphique, le concepteur de requêtes générique ne restructure pas les requêtes et n'en vérifie pas la syntaxe.

Pour activer le concepteur de requêtes générique pour une extension personnalisée

Ajoutez l'entrée suivante au fichier RSReportDesigner.config sous l'élément Designer, en remplaçant l'attribut Name par le nom que vous avez fourni dans les entrées précédentes.
```
<Extension Name="ExtensionName" Type="Microsoft.ReportingServices.QueryDesigners.GenericQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>
```

Vérification du déploiement

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 votre extension pour le traitement des données a été déployée correctement dans le Concepteur de rapports en créant un nouveau projet de rapport dans Visual Studio. Votre extension doit être incluse dans la liste des types de source de données disponibles lorsque vous créez un nouveau jeu de données pour votre rapport.