Personnaliser les paramètres d’extension de rendu dans RSReportServer.Config

Vous pouvez spécifier des paramètres d’extension de rendu dans le fichier de configuration RSReportServer pour remplacer le comportement de rendu de rapport par défaut pour les rapports qui s’exécutent sur un serveur de rapports Reporting Services. Vous pouvez modifier les paramètres d’extension de rendu pour atteindre les objectifs suivants :

• Modifiez la façon dont le nom de l’extension de rendu apparaît dans la liste d’exportation de la barre d’outils de rapport (par exemple, pour remplacer « Archive web » par « MHTML ») ou localisez le nom dans une autre langue.

• Créez plusieurs instances de la même extension de rendu pour prendre en charge différentes options de présentation de rapport (par exemple, une version en mode portrait et paysage de l’extension de rendu d’image).

• Modifiez les paramètres d’extension de rendu par défaut pour utiliser différentes valeurs (par exemple, l’extension de rendu d’image utilise TIFF comme format de sortie par défaut ; vous pouvez modifier les paramètres d’extension pour utiliser EMF à la place).

La modification des paramètres d’extension de rendu affecte uniquement les opérations de rendu sur le serveur de rapports. Vous ne pouvez pas remplacer les paramètres d’extension de rendu dans l’aperçu de rapport dans le Concepteur de rapports.

La spécification des paramètres d’extension de rendu dans les fichiers de configuration affecte globalement les extensions de rendu. 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 utilisée. Si vous souhaitez définir des paramètres d’extension de rendu pour un rapport ou une opération de rendu spécifique, vous devez spécifier des informations d’appareil par programmation à l’aide de la Render méthode ou en spécifiant les paramètres d’informations de l’appareil sur une URL de rapport. Pour plus d’informations sur la spécification des paramètres d’informations sur l’appareil pour une opération de rendu et pour afficher la liste complète des paramètres d’informations sur l’appareil, consultez Passage des paramètres d’informations sur l’appareil aux extensions de rendu.

Recherche et modification de RSReportServer.config

Les paramètres de configuration des formats de sortie de rapport sont spécifiés en tant que paramètres d’extension de rendu dans le fichier RSReportServer.config. 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 définissent les paramètres de rendu. Il existe deux structures XML que vous pouvez modifier :

• L’élément OverrideNames définit le nom complet et la langue de l’extension de rendu.

• La DeviceInfo structure XML définit les paramètres d’informations d’appareil utilisés par une extension de rendu. La plupart des paramètres d’extension de rendu sont spécifiés en tant que paramètres d’informations sur l’appareil.

Vous pouvez utiliser un éditeur de texte pour modifier le fichier. Le fichier RSReportServer.config se trouve dans le dossier \Reporting Services\Report Server\Bin. Pour plus d’informations sur la modification des fichiers de configuration, consultez Modifier un fichier de configuration Reporting Services (RSreportserver.config).

Modification du nom d'affichage

Le nom complet d’une extension de rendu apparaît dans la liste d’exportation de la barre d’outils du rapport. Par exemple, les noms d’affichage par défaut incluent l’archive web, le fichier TIFF et le fichier Acrobat (PDF). Vous pouvez remplacer le nom d’affichage par défaut par une valeur personnalisée en spécifiant l’élément OverrideNames dans les fichiers de configuration. En outre, si vous définissez deux instances d’une extension de rendu unique, vous pouvez utiliser l’élément OverrideNames pour distinguer chaque instance de la liste d’exportation.

Étant donné que les noms d’affichage sont localisés, vous devez définir l’attribut Language si vous remplacez le nom d’affichage par défaut par une valeur personnalisée. Sinon, tout nom que vous spécifiez sera ignoré. La valeur de langue que vous définissez doit être valide pour l’ordinateur du serveur de rapports. Par exemple, si le serveur de rapports s’exécute sur un système d’exploitation français, vous devez spécifier «fr-FR» comme valeur d’attribut.

L’exemple suivant montre comment fournir un nom personnalisé sur un serveur de rapports anglais :

<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 sur l’appareil

Pour modifier les paramètres d’informations d’appareil par défaut utilisés par une extension de rendu déjà déployée sur votre serveur de rapports, vous devez taper la DeviceInfo structure XML dans les fichiers de configuration. Chaque extension de rendu prend en charge les paramètres d’informations d’appareil propres à cette extension. Pour afficher la liste complète des paramètres d’informations sur l’appareil, consultez Passage des paramètres d’informations sur l’appareil aux extensions de rendu.

L’exemple suivant fournit une illustration de la structure et de la syntaxe XML qui modifient les paramètres par défaut de l’extension de rendu d’image :

<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 rendu

Vous pouvez créer plusieurs instances de la même extension de rendu pour prendre en charge différentes options de présentation de rapport. Chaque instance que vous définissez peut avoir une combinaison différente de valeurs de paramètre. Lorsque vous définissez de nouvelles instances d’une extension de rendu existante, veillez à effectuer les opérations suivantes :

• Spécifiez un nom unique pour l’extension.

  Chaque instance doit avoir une valeur unique pour l’attribut Name . L’exemple suivant utilise les noms « IMAGE (PAYSAGE EMF) » et « IMAGE (EMF Portrait) » pour faire la distinction entre les deux instances.

  Soyez prudent lorsque vous modifiez le nom d’une extension de rendu déjà déployée. Les développeurs qui spécifient des extensions de rendu utilisent par programmation le nom de l’extension pour identifier l’instance à utiliser pour une opération de rendu particulière. Si vous exécutez des applications Reporting Services personnalisées sur votre serveur de rapports, assurez-vous que le développeur sait si vous modifiez un nom d’extension existant ou ajoutez-en un nouveau.

• Spécifiez un nom d’affichage unique afin que les utilisateurs puissent comprendre les différences pour chaque format de sortie.

  Si vous configurez plusieurs versions de la même extension, vous pouvez donner à chaque version un nom unique en fournissant une valeur pour OverrideNames. Sinon, toutes les versions de l’extension semblent avoir le même nom dans la liste des options d’exportation dans la barre d’outils du rapport.

L’exemple suivant montre comment utiliser l’extension de rendu d’image par défaut (qui produit une sortie TIFF) pour générer EMF en mode Portrait en même temps qu’une deuxième instance qui génère des rapports dans EMF en mode Paysage. Notez que chaque nom d’extension est unique. Lorsque vous testez cet exemple, n’oubliez pas de choisir des rapports qui ne contiennent pas de fonctionnalités interactives telles que les options d’affichage/masquage, les matrices ou les liens d’extraction (les fonctionnalités interactives ne fonctionnent pas dans l’extension de rendu d’image) :

<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 aussi

Fichier de configuration RSReportServer
Fichier de configuration RSReportDesigner
Paramètres des informations sur l’appareil CSV
Paramètres d'informations sur le périphérique Excel
Paramètres d'information sur l'appareil HTML
Paramètres des informations sur l’appareil image
Paramètres d’informations sur l’appareil MHTML
Paramètres d’informations sur l’appareil PDF
Paramètres des informations sur l’appareil XML