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 par défaut des rapports qui tournent sur un serveur de rapports Reporting Services. Vous pouvez modifier les paramètres d’extension de rendu pour atteindre les objectifs suivants :

  • Changez 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 changer « Web archive » en « MHTML »), ou localisez le nom dans une autre langue.

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

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

Modifier les paramètres d’extension de rendu n’affecte que les opérations de rendu sur le serveur de rapport. Vous ne pouvez pas remplacer les paramètres d’extension de rendu dans l’aperçu du rapport dans le Concepteur de rapports.

La spécification des paramètres d’extension de rendu dans les fichiers de configuration affecte les extensions de rendu à l’échelle mondiale. Les paramètres dans les 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 les informations de l’appareil de manière programmatique en utilisant la Render méthode ou en spécifiant les paramètres d’information de l’appareil sur une URL de rapport. Pour plus d’informations sur la spécification des paramètres d’information de périphérique pour une opération de rendu, et pour consulter la liste complète des paramètres d’information de périphérique, voir Passer les paramètres d’information de périphérique vers les extensions de rendu.

Trouver et modifier RSReportServer.config

Les paramètres de configuration des formats de sortie de rapport sont spécifiés comme des 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 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 d’affichage et la langue de l’extension de rendu.

  • La structure XML DeviceInfo définit les paramètres d’information des périphériques utilisés par une extension de rendu. La plupart des paramètres d’extension de rendu sont spécifiés comme paramètres d’information de périphérique.

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, voir Modifier un fichier de configuration Reporting Services (RSreportserver.config).

Changer le nom d’affichage

Le nom affiché d’une extension de rendu apparaît dans la liste Exporter de la barre d’outils du rapport. Des exemples de noms d’affichage par défaut incluent Web archive, fichier TIFF et 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. De plus, si vous définissez deux instances d’une même extension de rendu, vous pouvez utiliser l’élément OverrideNames pour distinguer chaque instance dans la liste d’exportation.

Comme les noms d’affichage sont localisés, vous devez définir l’attribut Langue 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 langage que vous définissez doit être valide pour l’ordinateur serveur de rapport. Par exemple, si le serveur de rapports fonctionne sur un système d’exploitation français, vous devez spécifier «fr-FR» comme valeur d’attribut.

L’exemple suivant illustre 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>

Modifier les paramètres des informations de l’appareil

Pour modifier les paramètres d’information de l’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 structure XML DeviceInfo dans les fichiers de configuration. Chaque extension de rendu prend en compte des paramètres d’information de périphérique propres à cette extension. Pour consulter la liste complète des paramètres d’information de l’appareil, voir Passer les paramètres d’information de périphérique aux extensions de rendu.

L’exemple suivant illustre la structure XML et la syntaxe qui modifient 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>

Configurez 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ètres. Lorsque vous définissez de nouvelles instances d’une extension de rendu existante, assurez-vous de faire ce qui suit :

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

    Chaque instance doit avoir une valeur unique pour l’attribut Nom . L’exemple suivant utilise les noms « IMAGE (EMF Landscape) » et « IMAGE (EMF Portrait) » pour distinguer les deux instances.

    Soyez prudent lorsque vous changez le nom d’une extension de rendu déjà déployée. Les développeurs qui spécifient des extensions de rendu de façon programmatique utilisent le nom de l’extension pour identifier quelle 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 en ajoutez 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 d’une même extension, vous pouvez donner à chaque version un nom unique en fournissant une valeur pour OverrideNames. Sinon, toutes les versions de l’extension apparaîtront avec le même nom dans la liste des options d’exportation de la barre d’outils de rapport.

L’exemple suivant illustre comment utiliser l’extension de rendu d’image par défaut (qui produit une sortie TIFF) pour produire de la FEM en mode Portrait, aux côtés d’une seconde instance qui produit des rapports en FEM en mode Paysage. Remarquez 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’exploration (les fonctionnalités interactives ne fonctionnent pas dans l’extension de rendu d’images) :

<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 Portrait Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>11in</PageHeight>  
                <PageWidth>8.5in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

Contenu connexe

  • Last updated on