Personalizar parâmetros de extensão de renderização em 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 relatórios executados em um servidor de relatório do Reporting Services. Você pode modificar os parâmetros de extensão de renderização para alcançar os seguintes objetivos:

• Altere como o nome da extensão de renderização aparece na lista Exportar da barra de ferramentas do relatório (por exemplo, para alterar "Arquivo Web" para "MHTML" ou localize o nome em um idioma diferente.

• Crie várias instâncias da mesma extensão de renderização para dar suporte a diferentes opções de apresentação de relatório (por exemplo, uma versão de modo retrato e paisagem da extensão de renderização de imagem).

• Altere os parâmetros de extensão de renderização padrão para usar valores diferentes (por exemplo, a extensão de renderização de imagem usa TIFF como o formato de saída padrão; você pode modificar os parâmetros de extensão para usar o EMF).

Alterar os parâmetros de extensão de renderização afeta apenas as operações de renderização no servidor de relatório. Não é possível substituir as configurações de extensão de renderização na visualização de relatório no Designer de Relatórios.

Especificar parâmetros das extensões de renderização nos arquivos de configuração afeta as extensões de renderização em âmbito global. As configurações nos arquivos de configuração são usadas no lugar de valores padrão sempre que uma extensão de renderização específica é usada. Se você quiser definir parâmetros de extensão de renderização para uma operação de renderização ou relatório específico, especifique as informações do dispositivo programaticamente usando o Render método ou especificando as configurações de informações do dispositivo em uma URL de relatório. Para obter mais informações sobre como especificar as configurações de informações do dispositivo para uma operação de renderização e exibir a lista completa de configurações de informações do dispositivo, consulte Passando as configurações de informações do dispositivo para extensões de renderização.

Localizando e modificando RSReportServer.config

As configurações para formatos de saída de relatório são especificadas como parâmetros de extensão de renderização no arquivo RSReportServer.config. Para especificar parâmetros de extensão de renderização nos arquivos de configuração, você deve saber como definir as estruturas XML que definem parâmetros de renderização. Há duas estruturas XML que você pode modificar:

• O OverrideNames elemento define o nome de exibição e o idioma da extensão de renderização.

• A DeviceInfo estrutura XML define as configurações de informações do dispositivo usadas por uma extensão de renderização. A maioria dos parâmetros de extensão de renderização são especificados como configurações de informações do dispositivo.

Você pode usar um editor de texto para modificar o arquivo. O arquivo RSReportServer.config pode ser encontrado na pasta \Reporting Services\Servidor de Relatórios\Bin. Para obter mais informações sobre como modificar arquivos de configuração, consulte Modificar um arquivo de configuração do Reporting Services (RSreportserver.config).

Alterando o nome de exibição

O nome de exibição de uma extensão de renderização aparece na lista Exportar da barra de ferramentas do relatório. Exemplos de nomes de exibição padrão incluem arquivo web, arquivo TIFF e arquivo Acrobat (PDF). Você pode substituir o nome de exibição padrão por um valor personalizado especificando o OverrideNames elemento nos arquivos de configuração. Além disso, se você estiver definindo duas instâncias de uma única extensão de renderização, poderá usar o OverrideNames elemento para distinguir cada instância na lista Exportar.

Como os nomes de exibição são localizados, você deve definir o Language atributo se estiver substituindo o nome de exibição padrão por um valor personalizado. Caso contrário, qualquer nome especificado será ignorado. O valor do idioma definido deve ser válido para o computador do servidor de relatório. Por exemplo, se o servidor de relatório estiver em execução em um sistema operacional francês, você deverá especificar "fr-FR" como o valor do atributo.

O exemplo a seguir ilustra como fornecer um nome personalizado em um servidor de relatório em inglês:

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

Para modificar as configurações de informações de dispositivo padrão que são usadas por uma extensão de renderização que já está implantada no servidor de relatório, você deve digitar a DeviceInfo estrutura XML nos arquivos de configuração. Cada extensão de renderização dá suporte a configurações de informações do dispositivo exclusivas para essa extensão. Para exibir a lista completa de configurações de informações do dispositivo, consulte Passando as configurações de informações do dispositivo para extensões de renderização.

O exemplo a seguir fornece uma ilustração da estrutura XML e da sintaxe que modifica as configurações padrão da extensão de renderização de imagem:

<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ção

Você pode criar várias instâncias da mesma extensão de renderização para dar suporte a diferentes opções de apresentação de relatório. Cada instância que você definir pode ter uma combinação diferente de valores de parâmetro. Ao definir novas instâncias de uma extensão de renderização existente, faça o seguinte:

• Especifique um nome exclusivo para a extensão.

  Cada instância deve ter um valor exclusivo para o Name atributo. O exemplo a seguir usa os nomes "IMAGE (EMF Landscape)" e "IMAGE (EMF Portrait)" para distinguir entre as duas instâncias.

  Tenha cuidado ao alterar o nome de uma extensão de renderização que já está implantada. Os desenvolvedores que especificam extensões de renderização usam programaticamente o nome da extensão para identificar qual instância usar para uma operação de renderização específica. Se você estiver executando aplicativos personalizados do Reporting Services em seu servidor de relatório, verifique se o desenvolvedor sabe se você modifica um nome de extensão existente ou adiciona um novo.

• Especifique um nome de exibição exclusivo para que os usuários possam entender as diferenças para cada formato de saída.

  Se você estiver configurando várias versões da mesma extensão, poderá dar a cada versão um nome exclusivo fornecendo um valor para OverrideNames. Caso contrário, todas as versões da extensão parecerão possuir o mesmo nome na lista de opções de exportação na barra de ferramentas do relatório.

O exemplo a seguir ilustra como usar a extensão de renderização de imagem padrão (que produz saída TIFF) para gerar EMF no modo Retrato junto com uma segunda instância que gera relatórios no EMF no modo Paisagem. Observe que cada nome de extensão é exclusivo. Ao testar este exemplo, lembre-se de escolher relatórios que não contêm recursos interativos, como opções de exibição/ocultação, matrizes ou links de detalhamento (recursos interativos não funcionam na extensão de renderização de imagem):

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

Arquivo de configuração RSReportServer
Arquivo de configuração RSReportDesigner
Configurações de informações do dispositivo CSV
Configurações de informações do dispositivo do Excel
Configurações de informações do dispositivo HTML
Configurações de informações do dispositivo de imagem
Configurações de informações do dispositivo MHTML
Configurações de informações do dispositivo PDF
Configurações de informações do dispositivo XML