Déploiement d'une extension de rendu

Après avoir écrit et compilé votre extension de rendu de rapport Reporting Services dans une bibliothèque .NET Framework, vous devez la rendre détectable par le serveur de rapports et par le Générateur de rapports. Pour cela, copiez l'extension dans le répertoire approprié et ajoutez des entrées aux fichiers de configuration Reporting Services appropriés.

Élément Extension de rendu de fichier de configuration

Une fois qu'une extension de rendu a été compilée dans un fichier .DLL, ajoutez une entrée dans le fichier rsreportserver.config, situé dans le dossier C:\Program Files\Microsoft SQL Server\MSRS10.<InstanceName>\Reporting Services\ReportServer\Bin, si l'emplacement d'installation par défaut a été sélectionné pendant l'installation. L'élément parent est <Render>. Sous l'élément Render se trouve un élément Extension pour chaque extension de rendu. L'élément Extension contient deux attributs, Name et Type.

Le tableau suivant décrit les attributs de l'élément Extension pour les extensions de rendu.

Attribut

Description

Name

Nom unique de l'extension, par exemple, « EXCEL » pour l'extension de rendu Microsoft Excel. La longueur maximale de l'attribut Name est de 255 caractères. Le nom doit être unique parmi toutes les entrées de l'élément Extensions d'un fichier de configuration. Si un nom existe en double, le serveur de rapports retourne une erreur.

Type

Liste séparée par des virgules qui inclut l'espace de noms complet, ainsi que le nom de l'assembly.

Visible

La valeur false indique que l'extension de rendu ne doit pas être visible dans les interfaces utilisateur. Si cet attribut n'est pas défini, la valeur par défaut est true.

LogAllExecutionRequests

La valeur false indique qu'une entrée est enregistrée pour la première exécution de rapport uniquement dans une session. Si cet attribut n'est pas défini, la valeur par défaut est true.

Par exemple, ce paramètre détermine s'il convient d'enregistrer une entrée pour la première page rendue dans un rapport uniquement (lorsque la valeur est false) ou une entrée pour chaque page rendue dans le rapport (lorsque la valeur est true).

Pour plus d'informations sur le fichier RSReportServer.config, consultez Fichier de configuration RSReportServer.

Déploiement de l'extension sur le serveur de rapports

Le serveur de rapports utilise des extensions de rendu pour exporter des rapports dans d'autres formats. Vous devez déployer l'assembly d'extension de rendu sur le serveur de rapports sous la forme d'un assembly privé. Vous devez également créer une entrée dans le fichier de configuration du serveur de rapports (rsreportserver.config.)

Pour déployer l'assembly

  1. Copiez votre assembly depuis votre emplacement dans le répertoire bin du serveur de rapports sur lequel l'extension de rendu doit être utilisée. L'emplacement par défaut du répertoire Bin du serveur de rapports est C:\Program Files\Microsoft SQL Server\MSRS10.<InstanceName>\Reporting Services\ReportServer\Bin.

  2. Une fois le fichier d'assembly copié, ouvrez le fichier rsreportserver.config. Ce fichier se trouve aussi dans le répertoire bin du serveur de rapports. Vous devez créer une entrée dans le fichier de configuration pour votre fichier d'assembly d'extension. Vous pouvez ouvrir le fichier dans Microsoft Visual Studio.NET ou simplement à l'aide d'un éditeur de texte, tel que le Bloc-notes.

    Pour plus d'informations, consultez Fichier de configuration RSReportServer.

  3. Localisez l'élément Render dans le fichier Rsreportserver.config. Une entrée correspondant à votre nouvelle extension doit être créée à l'emplacement suivant :

    <Extensions>
       <Render>
          <Your extension configuration information goes here>
       </Render>
    </Extensions>
    
  4. Ajoutez une entrée pour votre extension de rendu. Celle-ci doit comporter un élément dont les valeurs Name et Type doivent être définies. Cette entrée peut se présenter comme suit :

    <Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />
    

    La valeur définie pour Name correspond au nom unique de l'extension de rendu. La valeur définie pour Type est une liste séparée par des virgules comportant une entrée pour l'espace de noms complet de votre implémentation IRenderingExtension, suivi du nom de votre assembly (l'extension de fichier .dll ne doit pas figurer dans cette entrée). Par défaut, les extensions de rendu sont visibles. Pour les masquer des interfaces utilisateur, comme le Gestionnaires de rapports, ajoutez un attribut Visible à l'élément Extension, et affectez-lui la valeur false.

Vérification du déploiement

Vous pouvez vérifier que votre extension de rendu a été correctement déployée sur le serveur de rapports en utilisant la méthode ListExtensions du service Web. Vous pouvez également ouvrir le Gestionnaire de rapports et vérifier que votre extension est répertoriée dans la liste des types d'exportation pour un rapport.