Déploiement d'une extension de rendu

Après avoir écrit et compilé votre extension de génération 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 est compilée dans une .DLL, vous devez ajouter une entrée dans le fichier rsreportserver.config. Par défaut, celui-ci se trouve dans le dossier %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<NomInstance>\Reporting Services\ReportServer. 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.

La table suivante décrit les attributs de l'élément Extension pour les extensions de rendu.

Attribut

Description

Nom

Nom unique de l'extension. 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, 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 le suivant : %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<Nom de l'instance>\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 avec Visual Studio ou un éditeur de texte simple.

    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>
          <extension configuration>
       </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(ExtensionTypeEnum) 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.

Voir aussi

Concepts

Implémentation d'une extension de rendu

Vue d'ensemble des extensions de rendu

Implémentation de l'interface IRenderingExtension

Considérations sur la sécurité pour les extensions