Partager via

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

  • Article

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 Services . Vous pouvez modifier les paramètres d'extension de rendu pour obtenir les résultats suivants :

  • 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 ;

  • 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) ;

  • 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).

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 en mode d'aperçu de rapport dans le Concepteur de rapports.

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. 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. 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. 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 Transmettre des paramètres d’informations de périphérique aux extensions de rendu.

Trouver et modifier 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. 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. Vous pouvez modifier deux structures XML :

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

  • La structure XML DeviceInfo définit les paramètres d’informations sur l’appareil qui sont 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 de périphérique.

Vous pouvez utiliser un éditeur de texte pour modifier le fichier. Le fichier RSReportServer.config est situé 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).

Modifier le nom d’affichage

Le nom complet d'une extension de rendu apparaît dans la liste Exporter de la barre d'outils Rapport. Un nom complet par défaut peut être, par exemple, au format archive Web, fichier TIFF et fichier Acrobat (PDF). 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. 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.

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. Dans le cas contraire, le nom que vous spécifiez sera ignoré. La valeur de langue que vous définissez doit être valide pour l'ordinateur serveur de rapports. 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.

L'exemple suivant décrit comment fournir un nom personnalisé sur un serveur de rapports en 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>

Modifier les paramètres d’informations de périphérique

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. Chaque extension de rendu prend en charge des paramètres d'informations de périphérique qui sont uniques pour cette 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.

L'exemple suivant illustre la syntaxe et la structure XML qui modifie les paramètres par défaut de l'extension de rendu 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>

Configurer 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. Chaque instance que vous définissez peut comporter sa propre combinaison de valeurs de paramètres. Lorsque vous définissez de nouvelles instances d'une expression de rendu existante, veillez à prendre en compte les points suivants :

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

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

    Soyez vigilent lorsque vous modifiez le nom d'une extension de rendu qui est déjà déployée. 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. Si vous exécutez des applications Reporting 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.

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

    Si vous configurez plusieurs versions de la même extension, vous pouvez attribuer à chaque version un nom unique en indiquant une valeur pour 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.

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. 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 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) :

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

Contenu connexe