Déploiement d'une extension de renduDeploying a Rendering Extension

Après avoir écrit et compilé votre Reporting ServicesReporting Services signaler l’extension de rendu dans une .NET Framework.NET Framework bibliothèque, vous devez rendre détectable par le serveur de rapports et par le Concepteur de rapports.After you have written and compiled your Reporting ServicesReporting Services report rendering extension into a .NET Framework.NET Framework library, you need to make it discoverable by the report server and by Report Designer. Pour cela, copiez l'extension dans le répertoire approprié et ajoutez des entrées aux fichiers de configuration Reporting ServicesReporting Services appropriés.To do so, copy the extension to the appropriate directory and add entries to the appropriate Reporting ServicesReporting Services configuration files.

Élément Extension de rendu de fichier de configurationConfiguration File Rendering Extension Element

Une fois qu'une extension de rendu est compilée dans une .DLL, vous devez ajouter une entrée dans le fichier rsreportserver.config.Once a rendering extension has been compiled into a .DLL, you add an entry into the rsreportserver.config file. Par défaut, l’emplacement est %ProgramFiles%\Microsoft SQL Server\MSRS10_50. <InstanceName > \Reporting.By default, the location is %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer. L’élément parent est <restituer >.The parent element is <Render>. Sous l'élément Render se trouve un élément Extension pour chaque extension de rendu.Under the Render element is an Extension element for each rendering extension. L'élément Extension contient deux attributs, Name et Type.The Extension element contains two attributes, Name and Type.

La table suivante décrit les attributs de l'élément Extension pour les extensions de rendu.The following table describes the attributes for the Extension element for rendering extensions:

AttributAttribute DescriptionDescription
NomName Nom unique de l'extension.A unique name for the extension. La longueur maximale de l'attribut Name est de 255 caractères.The maximum length for the Name attribute is 255 characters. Le nom doit être unique parmi toutes les entrées de l'élément Extensions d'un fichier de configuration.The name must be unique among all entries within the Extensions element of a configuration file. Si un nom existe en double, le serveur de rapports retourne une erreur.If a duplicate name is present, the report server returns an error.
TypeType Liste séparée par des virgules qui inclut l'espace de noms complet, ainsi que le nom de l'assembly.A comma-separated list that includes the fully qualified namespace along with the name of the assembly.
VisibleVisible La valeur false indique que l'extension de rendu ne doit pas être visible dans les interfaces utilisateur.A value of false indicates that the rendering extension should not be visible in user interfaces. Si cet attribut n'est pas défini, la valeur par défaut est true.If the attribute is not included, the default value is true.
LogAllExecutionRequestsLogAllExecutionRequests La valeur false indique qu'une entrée est enregistrée pour la première exécution de rapport uniquement dans une session.A value of false indicates that an entry is logged for only the first report execution in a session. Si cet attribut n'est pas défini, la valeur par défaut est true.If the attribute is not included, the default value is 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).For example, this setting determines whether to log an entry for only the first page rendered in a report (when false) or an entry for each page rendered in the report (when true).

Pour plus d’informations, consultez Fichier de configuration RSReportServer.For more information, see RsReportServer.config Configuration File.

Déploiement de l'extension sur le serveur de rapportsDeploying the Extension to the Report Server

Le serveur de rapports utilise des extensions de rendu pour exporter des rapports dans d'autres formats.The report server uses rendering extensions to export reports to other formats. Vous devez déployer l'assembly d'extension de rendu sur le serveur de rapports sous la forme d'un assembly privé.You should deploy your rendering extension assembly to the report server as a private assembly. Vous devez également créer une entrée dans le fichier de configuration du serveur de rapports (rsreportserver.config.)You also need to make an entry in the report server configuration file, rsreportserver.config.

Pour déployer l'assemblyTo deploy the 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.Copy your assembly from your staging location to the bin directory of the report server on which you want to use the rendering extension. L’emplacement par défaut du répertoire Bin de serveur de rapports est %ProgramFiles%\Microsoft SQL Server\MSRS10_50. <InstanceName > \Reporting.The default location of the report server Bin directory is %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer\Bin.

  2. Une fois le fichier d'assembly copié, ouvrez le fichier rsreportserver.config.After the assembly file is copied, open the rsreportserver.config file. Ce fichier se trouve aussi dans le répertoire bin du serveur de rapports.The rsreportserver.config file is also located in the report server bin directory. Vous devez créer une entrée dans le fichier de configuration pour votre fichier d'assembly d'extension.You need to make an entry in the configuration file for your extension assembly file. Vous pouvez ouvrir le fichier avec Visual StudioVisual Studio ou un éditeur de texte simple.You can open the file with Visual StudioVisual Studio or a simple text editor.

    Pour plus d’informations, consultez Fichier de configuration RSReportServer.For more information, see RsReportServer.config Configuration File.

  3. Localisez l'élément Render dans le fichier Rsreportserver.config.Locate the Render element in the Rsreportserver.config file. Une entrée correspondant à votre nouvelle extension doit être créée à l'emplacement suivant :An entry for your newly created extension should be made in the following location:

    <Extensions>  
       <Render>  
          <extension configuration>  
       </Render>  
    </Extensions>  
    
  4. Ajoutez une entrée pour votre extension de rendu.Add an entry for your rendering extension. 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 :Your entry should include an element that has values for Name and Type, and might look like the following:

    <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.The value for Name is the unique name of the rendering extension. La valeur de Type est une liste séparée par des virgules qui comporte une entrée pour l’espace de noms qualifié complet de votre IRenderingExtension implémentation, suivie du nom de votre assembly (sans l’extension de fichier .dll).The value for Type is a comma-separated list that includes an entry for the fully qualified namespace of your IRenderingExtension implementation, followed by the name of your assembly (not including the .dll file extension). Par défaut, les extensions de rendu sont visibles.By default, rendering extensions are visible. 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.To hide an extension from user interfaces, such as Report Manager, add a Visible attribute to the Extension element, and set it to false.

Vérification du déploiementVerifying the deployment

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.You can also open Report Manager and verify that your extension is included in the list of available export types for a report.

Voir aussiSee Also

Implémentation d’une Extension de rendu Implementing a Rendering Extension
Vue d’ensemble des Extensions de rendu Rendering Extensions Overview
Implémentation de l’Interface IRenderingExtension Implementing the IRenderingExtension Interface
Considérations sur la sécurité pour les extensionsSecurity Considerations for Extensions