Personnaliser les paramètres d'extension de rendu dans RSReportServer.ConfigCustomize Rendering Extension Parameters in RSReportServer.Config

Vous pouvez spécifier des paramètres d'extension de rendu dans le fichier de configuration RSReportServer afin de remplacer le comportement de la génération de rapport par défaut pour les rapports exécutés sur un serveur de rapports Reporting ServicesReporting Services .You can specify rendering extension parameters in the RSReportServer configuration file to override default report rendering behavior for reports that run on a Reporting ServicesReporting Services report server. Vous pouvez modifier les paramètres d'extension de rendu pour obtenir les résultats suivants :You can modify rendering extension parameters to achieve the following objectives:

  • modifier l'affichage du nom de l'extension de rendu dans la liste Exporter de la barre d'outils Rapport (par exemple, pour remplacer « Web archive » par « MHTML »), ou localiser le nom dans une autre langue ;Change how the rendering extension name appears in the Export list of the report toolbar (for example, to change "Web archive" to "MHTML"), or localize the name to a different language.

  • créer plusieurs instances de la même extension de rendu afin de gérer différentes options de présentation de rapport (par exemple, une version en mode Portrait et Paysage de l'extension de rendu Image) ;Create multiple instances of the same rendering extension to support different report presentation options (for example, a portrait and landscape mode version of the Image rendering extension).

  • modifier les paramètres d'extension de rendu par défaut afin d'utiliser d'autres valeurs (par exemple, l'extension de rendu Image utilise TIFF comme format de sortie par défaut ; vous pouvez modifier les paramètres d'extension et utiliser le format EMF à la place).Change the default rendering extension parameters to use different values (for example, the Image rendering extension uses TIFF as the default output format; you can modify the extension parameters to use EMF instead).

    La modification des paramètres d'extension de rendu affecte uniquement les opérations de rendu sur le serveur de rapports.Changing the rendering extension parameters only affects rendering operations on the report server. Vous ne pouvez pas remplacer les paramètres d'extension de rendu en mode d'aperçu de rapport dans le Concepteur de rapports.You cannot override rendering extension settings in report preview in Report Designer.

    La spécification des paramètres d'extension de rendu dans les fichiers de configuration a des répercussions globales sur les extensions de rendu.Specifying rendering extension parameters in the configuration files affects rendering extensions globally. Les paramètres des fichiers de configuration sont utilisés à la place des valeurs par défaut chaque fois qu'une extension de rendu particulière est employée.The settings in the configuration files are used in place of default values whenever a particular rendering extension is used. Si vous souhaitez définir des paramètres d’extension de rendu pour une opération de rapport ou de rendu spécifique, vous devez spécifier par programmation les informations sur l’appareil à l’aide de la méthode Render ou en spécifiant les paramètres d’informations d’appareil sur une URL de rapport.If you want to set rendering extension parameters for a specific report or render operation, you must specify device information programmatically using the Render method or by specifying device information settings on a report URL. Pour obtenir la liste complète des paramètres d’informations sur l’appareil et davantage d’informations sur la spécification de paramètres d’informations sur l’appareil pour une opération de rendu, consultez Transmission de paramètres d’informations de périphérique aux extensions de rendu.For more information about specifying device information settings for a render operation, and to view the complete list of device information settings, see Passing Device Information Settings to Rendering Extensions.

Recherche et modification de RSReportServer.configFinding and Modifying RSReportServer.config

Les paramètres de configuration des formats de sortie des rapports sont spécifiés sous forme de paramètres d'extension de rendu dans le fichier RSReportServer.config.Configuration settings for report output formats are specified as rendering extension parameters in the RSReportServer.config file. Pour spécifier les paramètres d'extension de rendu dans les fichiers de configuration, vous devez savoir comment définir les structures XML qui configurent les paramètres de rendu.To specify rendering extension parameters in the configuration files, you must know how to define the XML structures that set rendering parameters. Vous pouvez modifier deux structures XML :There are two XML structures that you can modify:

  • L’élément OverrideNames définit la langue et le nom complet de l’extension de rendu.The OverrideNames element defines the display name and language of the rendering extension.

  • La structure XML DeviceInfo définit les paramètres d’informations sur l’appareil qui sont utilisés par une extension de rendu.The DeviceInfo XML structure defines the device information settings that are used by a rendering extension. La plupart des paramètres d'extension de rendu sont spécifiés en tant que paramètres d'informations de périphérique.Most rendering extension parameters are specified as device information settings.

    Vous pouvez utiliser un éditeur de texte pour modifier le fichier.You can use a text editor to modify the file. Le fichier RSReportServer.config est situé dans le dossier \Reporting Services\Report Server\Bin.The RSReportServer.config file can be found in the \Reporting Services\Report Server\Bin folder. Pour plus d’informations sur la modification des fichiers de configuration, consultez Modifier un fichier de configuration Reporting Services (RSreportserver.config).For more information about modifying configuration files, see Modify a Reporting Services Configuration File (RSreportserver.config).

Modification du nom completChanging the Display Name

Le nom complet d'une extension de rendu apparaît dans la liste Exporter de la barre d'outils Rapport.The display name for a rendering extension appears in the Export list of the report toolbar. Un nom complet par défaut peut être, par exemple, au format archive Web, fichier TIFF et fichier Acrobat (PDF).Examples of default display names include Web archive, TIFF file, and Acrobat (PDF) file. Vous pouvez remplacer le nom complet par défaut par une valeur personnalisée en indiquant l’élément OverrideNames dans les fichiers de configuration.You can replace the default display name with a custom value by specifying the OverrideNames element in the configuration files. De plus, si vous définissez deux instances d’une même extension de rendu, vous pouvez utiliser l’élément OverrideNames pour faire la distinction entre chaque instance dans la liste Exporter.In addition, if you are defining two instances of a single rendering extension, you can use the OverrideNames element to distinguish each instance in the Export list.

Les noms complets étant localisés, vous devez définir l’attribut Language si vous remplacez le nom complet par défaut par une valeur personnalisée.Because display names are localized, you must set the Language attribute if you are replacing the default display name with a custom value. Dans le cas contraire, le nom que vous spécifiez sera ignoré.Otherwise, any name that you specify will be ignored. La valeur de langue que vous définissez doit être valide pour l'ordinateur serveur de rapports.The language value that you set must be valid for the report server computer. Par exemple, si le serveur de rapports fonctionne sur un système d'exploitation français, vous devez indiquer « fr-FR » comme valeur d'attribut.For example, if the report server is running on a French operating system, you should specify "fr-FR" as the attribute value.

L'exemple suivant décrit comment fournir un nom personnalisé sur un serveur de rapports en anglais :The following example illustrates how to provide a custom name on an English report server:

<Extension Name="XML" Type="Microsoft.ReportingServices.Rendering.DataRenderer.XmlDataReport,Microsoft.ReportingServices.DataRendering">  
   <OverrideNames>  
     <Name Language="en-US">My Custom Display Name for XML Rendering</Name>  
   </OverrideNames>  
</Extension>  

Modification des paramètres d'informations de périphériqueChanging Device Information Settings

Pour modifier les paramètres d’informations sur l’appareil par défaut qui sont utilisés par une extension de rendu déjà déployée sur votre serveur de rapports, vous devez taper la structure XML DeviceInfo dans les fichiers de configuration.To modify default device information settings that are used by a rendering extension that is already deployed on your report server, you must type the DeviceInfo XML structure into the configuration files. Chaque extension de rendu prend en charge des paramètres d'informations de périphérique qui sont uniques pour cette extension.Every rendering extension supports device information settings that are unique to that extension. Pour afficher la liste complète des paramètres d’informations sur l’appareil, consultez Transmission de paramètres d’informations de périphérique aux extensions de rendu.To view the complete list of device information settings, see Passing Device Information Settings to Rendering Extensions.

L'exemple suivant illustre la syntaxe et la structure XML qui modifie les paramètres par défaut de l'extension de rendu Image :The following example provides an illustration of the XML structure and syntax that modifies the default settings of the Image rendering extension:

<Render>  
    <Extension Name="IMAGE (EMF)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">Image (EMF)</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <ColorDepth>32</ColorDepth>  
                <DpiX>300</DpiX>  
                <DpiY>300</DpiY>  
                <OutputFormat>EMF</OutputFormat>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>  

Configuration de plusieurs entrées pour une extension de renduConfiguring Multiple Entries for a Rendering Extension

Vous pouvez créer plusieurs instances de la même extension de rendu pour prendre en charge différentes options de présentation.You can create multiple instances of the same rendering extension to support different report presentation options. Chaque instance que vous définissez peut comporter sa propre combinaison de valeurs de paramètres.Each instance that you define can have a different combination of parameter values. Lorsque vous définissez de nouvelles instances d'une expression de rendu existante, veillez à prendre en compte les points suivants :When defining new instances of an existing rendering extension, be sure to do the following:

  • Spécifiez un nom unique pour l'extension.Specify a unique name for the extension.

    Chaque instance doit comporter une valeur unique pour l’attribut Name .Each instance must have a unique value for the Name attribute. L'exemple suivant utilise les noms « IMAGE (EMF Landscape) » et « IMAGE (EMF Portrait) » afin de faire la distinction entre les deux instances.The following example uses the names "IMAGE (EMF Landscape)" and "IMAGE (EMF Portrait)" to distinguish between the two instances.

    Soyez vigilent lorsque vous modifiez le nom d'une extension de rendu qui est déjà déployée.Use caution when changing the name of a rendering extension that is already deployed. Les développeurs qui spécifient des extensions de rendu par programmation utilisent le nom de l'extension afin d'identifier l'instance à employer pour une opération de rendu particulière.Developers who specify rendering extensions programmatically use the extension name to identify which instance to use for a particular render operation. Si vous exécutez des applications Reporting ServicesReporting Services personnalisées sur votre serveur de rapports, vérifiez que le développeur est informé quand vous modifiez une extension de rendu existante ou ajoutez une nouvelle extension.If you are running custom Reporting ServicesReporting Services applications on your report server, make sure that the developer knows if you modify an existing extension name or add a new one.

  • Spécifiez un nom complet unique afin que les utilisateurs puissent comprendre les différences de chaque format de sortie.Specify a unique display name so that users can understand the differences for each output format.

    Si vous configurez plusieurs versions de la même extension, vous pouvez attribuer à chaque version un nom unique en indiquant une valeur pour OverrideNames.If you are configuring multiple versions of the same extension, you can give each version a unique name by providing a value for OverrideNames. Si vous ne le faites pas, toutes les versions de l'extension sembleront porter le même nom dans la liste d'options Exporter de la barre d'outils.Otherwise, all versions of the extension will appear to have the same name in the Export options list on the report toolbar.

    L'exemple suivant illustre l'utilisation de l'extension de rendu Image par défaut (qui génère une sortie au format TIFF) vers une sortie EMF en mode Portrait avec une seconde instance qui génère des rapports au format EMF en mode Paysage.The following example illustrates how to use the default Image rendering extension (which produces TIFF output) to output EMF in Portrait mode alongside a second instance that outputs reports in EMF in Landscape mode. Notez que chaque nom d'extension est unique.Notice that each extension name is unique. Lorsque vous testez cet exemple, n'oubliez pas de choisir des rapports qui ne contiennent pas de fonctions interactives telles que les options d'affichage/masquage, des matrices ou des liens d'extraction (les fonctions interactives ne fonctionnent pas dans l'extension de rendu Image) :When testing this example, remember to choose reports that do not contain interactive features such as show/hide options, matrices, or drillthrough links (interactive features do not work in the Image rendering extension):

<Render>  
    <Extension Name="IMAGE (EMF Landscape)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Landscape Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>8.5in</PageHeight>  
                <PageWidth>11in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
    <Extension Name="IMAGE (EMF Portrait)" Type="Microsoft.ReportingServices.Rendering.ImageRenderer.ImageRenderer,Microsoft.ReportingServices.ImageRendering">  
        <OverrideNames>  
            <Name Language="en-US">EMF in Portait Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>11in</PageHeight>  
                <PageWidth>8.5in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>  

Voir aussiSee Also

Fichier de configuration RSReportServer.config RsReportServer.config Configuration File
Fichier de configuration RSReportDesigner RSReportDesigner Configuration File
Paramètres d’informations de périphérique CSV CSV Device Information Settings
Paramètres d’informations de périphérique Excel Excel Device Information Settings
Paramètres d’informations de périphérique HTML HTML Device Information Settings
Paramètres d’informations de périphérique pour l’image Image Device Information Settings
Paramètres d’informations de périphérique pour le format de rendu MHTML MHTML Device Information Settings
Paramètres d’informations de périphérique PDF PDF Device Information Settings
Paramètres des informations de périphériques XMLXML Device Information Settings