Déployer une extension de rendu

  • Article

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 Concepteur 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 d’extension de rendu de fichier de configuration

Une fois qu’une extension de rendu est compilée dans une .DLL, vous ajoutez une entrée dans le fichier rsreportserver.config. Par défaut, l'emplacement est %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<InstanceName>\Reporting Services\ReportServer. L’élément parent est \<Render>. Sous l’élément Render, il s’agit d’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 l’attribut n’est pas inclus, 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 l’attribut n’est pas inclus, 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 le fichier de configuration RsReportServer.config.

Déployer 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.)

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 %ProgramFiles%\Microsoft SQL Server\MSRS10_50.\<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 avec Visual Studio ou un éditeur de texte simple.

    Pour plus d’informations, consultez le fichier de configuration RsReportServer.config.

  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 Typedoivent ê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érifier le déploiement

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.

Contenu connexe