Personalizar parâmetros de extensão de renderização em RSReportServer.configCustomize Rendering Extension Parameters in RSReportServer.Config

Você pode especificar parâmetros de extensão de renderização no arquivo de configuração RSReportServer para substituir o comportamento de renderização de relatório padrão para os relatórios executados em um servidor de relatórios do 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. Os parâmetros de extensão de renderização podem ser modificados com os seguintes objetivos:You can modify rendering extension parameters to achieve the following objectives:

  • Alterar o modo de exibição do nome da extensão de renderização na lista Exportar da barra de ferramentas de relatórios (por exemplo, alterar “arquivo da Web” para “MHTML”) ou localizar o nome em um idioma diferente.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.

  • Criar várias instâncias da mesma extensão de renderização para oferecer suporte a diferentes opções de apresentação de relatório (por exemplo, uma versão do modo retrato e paisagem da extensão de renderização Imagem).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).

  • Alterar os parâmetros padrão da extensão de renderização para usar valores diferentes (por exemplo, a extensão de renderização Imagem usa TIFF como o formato de saída padrão; se desejar, você pode modificar os parâmetros de extensão para usar EMF).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).

    A alteração dos parâmetros de extensão de renderização afeta somente as operações de renderização no servidor de relatórios.Changing the rendering extension parameters only affects rendering operations on the report server. Não é possível substituir as configurações de extensão de renderização ao visualizar relatórios no Designer de Relatórios.You cannot override rendering extension settings in report preview in Report Designer.

    A especificação de parâmetros de extensão de renderização nos arquivos de configuração afeta as extensões de renderização globalmente.Specifying rendering extension parameters in the configuration files affects rendering extensions globally. As definições dos arquivos de configuração são usadas no lugar de valores padrão sempre que uma extensão de renderização específica é usada.The settings in the configuration files are used in place of default values whenever a particular rendering extension is used. Se desejar definir parâmetros de extensão de renderização para um relatório ou operação de renderização específico, especifique as informações do dispositivo programaticamente usando o método Render ou especificando configurações de informações de dispositivo em uma URL de relatório.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. Para obter mais informações sobre como especificar configurações de informações de dispositivo para uma operação de renderização e como exibir a lista completa de configurações de informações de dispositivo, consulte Como passar configurações de informações de dispositivos para extensões de renderização.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.

Localizando e modificando RSReportServer.configFinding and Modifying RSReportServer.config

As configurações de formatos de saída de relatório são especificadas como parâmetros de extensão de renderização no arquivo RSReportServer.config.Configuration settings for report output formats are specified as rendering extension parameters in the RSReportServer.config file. Para especificar parâmetros de extensão de renderização nos arquivos de configuração, você deve saber como definir estruturas XML que definem parâmetros de renderização.To specify rendering extension parameters in the configuration files, you must know how to define the XML structures that set rendering parameters. Há duas estruturas XML que podem ser modificadas:There are two XML structures that you can modify:

  • O elemento OverrideNames define o nome para exibição e a linguagem da extensão de renderização.The OverrideNames element defines the display name and language of the rendering extension.

  • A estrutura XML DeviceInfo define as configurações de informações de dispositivo que são usadas por uma extensão de renderização.The DeviceInfo XML structure defines the device information settings that are used by a rendering extension. A maioria dos parâmetros de extensão de renderização é especificada como configurações de informações de dispositivo.Most rendering extension parameters are specified as device information settings.

    Você pode usar um editor de texto para modificar o arquivo.You can use a text editor to modify the file. O arquivo RSReportServer.config pode ser localizado na pasta \Reporting Services\Report Server\Bin.The RSReportServer.config file can be found in the \Reporting Services\Report Server\Bin folder. Para obter mais informações sobre como modificar arquivos de configuração, consulte Modificar um arquivo de configuração do Reporting Services (RSreportserver.config).For more information about modifying configuration files, see Modify a Reporting Services Configuration File (RSreportserver.config).

Alterando o nome para exibiçãoChanging the Display Name

O nome para exibição de uma extensão de renderização aparece na lista Exportar da barra de ferramentas de relatório.The display name for a rendering extension appears in the Export list of the report toolbar. Exemplos de nomes para exibição padrão incluem arquivos da Web, TIFF e Acrobat (PDF).Examples of default display names include Web archive, TIFF file, and Acrobat (PDF) file. Você pode substituir o nome para exibição padrão por um valor personalizado especificando o elemento OverrideNames nos arquivos de configuração.You can replace the default display name with a custom value by specifying the OverrideNames element in the configuration files. Além disso, se duas instâncias de uma única extensão de renderização forem definidas, use o elemento OverrideNames para diferenciar cada instância na lista Exportar.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.

Como os nomes para exibição são localizados, defina o atributo Language se estiver substituindo o nome padrão por um valor personalizado.Because display names are localized, you must set the Language attribute if you are replacing the default display name with a custom value. Caso contrário, qualquer nome especificado será ignorado.Otherwise, any name that you specify will be ignored. O valor de idioma definido deve ser válido para o computador do servidor de relatórios.The language value that you set must be valid for the report server computer. Por exemplo, se o servidor de relatórios for executado em um sistema operacional francês, especifique "fr-FR" como o valor do atributo.For example, if the report server is running on a French operating system, you should specify "fr-FR" as the attribute value.

O exemplo a seguir ilustra como fornecer um nome personalizado em um servidor de relatórios em inglês: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>  

Alterando as configurações de informações de dispositivoChanging Device Information Settings

Para modificar as configurações padrão de informações de dispositivo que são usadas por uma extensão de renderização que já está implantada no servidor de relatórios, digite a estrutura XML DeviceInfo nos arquivos de configuração.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. Todas as extensões de renderização oferecem suporte para configurações de informações de dispositivo que são exclusivas na extensão em questão.Every rendering extension supports device information settings that are unique to that extension. Para exibir a lista completa de informações do dispositivo, consulte Como passar configurações de informações de dispositivos para extensões de renderização.To view the complete list of device information settings, see Passing Device Information Settings to Rendering Extensions.

O exemplo a seguir ilustra a estrutura XML e a sintaxe que modificam as configurações padrão da extensão de renderização Imagem: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>  

Configurando várias entradas para uma extensão de renderizaçãoConfiguring Multiple Entries for a Rendering Extension

Você pode criar várias instâncias da mesma extensão de renderização para oferecer suporte para opções de apresentação de relatório diferentes.You can create multiple instances of the same rendering extension to support different report presentation options. Cada instância definida pode ter uma combinação diferente de valores de parâmetro.Each instance that you define can have a different combination of parameter values. Ao definir novas instâncias de uma extensão de renderização existente, faça o seguinte:When defining new instances of an existing rendering extension, be sure to do the following:

  • Especifique um nome exclusivo para a extensão.Specify a unique name for the extension.

    Cada instância deve ter um valor exclusivo para o atributo Name .Each instance must have a unique value for the Name attribute. O exemplo a seguir usa os nomes "IMAGE (EMF Landscape)" e "IMAGE (EMF Portrait)" para diferenciar as duas instâncias.The following example uses the names "IMAGE (EMF Landscape)" and "IMAGE (EMF Portrait)" to distinguish between the two instances.

    Tenha cuidado ao alterar o nome de uma extensão de renderização que já está implantada.Use caution when changing the name of a rendering extension that is already deployed. Os desenvolvedores que especificam extensões de renderização programaticamente usam o nome da extensão para identificar a instância que deve ser usada em uma operação de renderização específica.Developers who specify rendering extensions programmatically use the extension name to identify which instance to use for a particular render operation. Se estiver executando aplicativos personalizados do Reporting ServicesReporting Services no servidor de relatórios, verifique se o desenvolvedor sabe se está modificando o nome de uma extensão existente ou adicionando uma nova extensão.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.

  • Especifique um nome para exibição exclusivo de forma que usuários possam entender as diferenças de cada formato de saída.Specify a unique display name so that users can understand the differences for each output format.

    Se estiver configurando várias versões da mesma extensão, dê a cada versão um nome exclusivo fornecendo um valor para 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. Caso contrário, todas as versões da extensão parecerão ter o mesmo nome na lista opções Exportar na barra de ferramentas de relatório.Otherwise, all versions of the extension will appear to have the same name in the Export options list on the report toolbar.

    O exemplo a seguir ilustra como usar a extensão de renderização Imagem padrão (que produz a saída TIFF) para gerar EMF no modo Retrato, junto com uma segunda instância que gera relatórios em EMF no modo Paisagem.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. Observe que cada nome de extensão é exclusivo.Notice that each extension name is unique. Ao testar esse exemplo, escolha relatórios que não contenham recursos interativos como opções de mostrar/ocultar, matrizes ou links de detalhamentos (os recursos interativos não funcionam na extensão de renderização Imagem):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>  

Consulte tambémSee Also

Arquivo de Configuração RsReportServer.config RsReportServer.config Configuration File
Arquivo de configuração RSReportDesigner RSReportDesigner Configuration File
Configurações das informações do dispositivo CSV CSV Device Information Settings
Configurações das informações do dispositivo do Excel Excel Device Information Settings
Configurações de informações do dispositivo HTML HTML Device Information Settings
Configurações das informações do dispositivo do Image Image Device Information Settings
Configurações das informações do dispositivo MHTML MHTML Device Information Settings
Configurações de informações do dispositivo PDF PDF Device Information Settings
Configurações de informações do dispositivo XML XML Device Information Settings