Personalizar parâmetros de extensão de renderização em RSReportServer.Config

Pode especificar parâmetros de extensão de composição no ficheiro de configuração RSReportServer para substituir o comportamento de composição de relatórios predefinido para relatórios que são executados num servidor de relatórios do Reporting Services. Pode modificar parâmetros de extensão de renderização para alcançar os seguintes objetivos:

  • Altere a forma como o nome da extensão de renderização aparece na lista de Exportação da barra de relatórios (por exemplo, para alterar "Arquivo Web" para "MHTML"), ou localize o nome para uma língua diferente.

  • Crie múltiplas instâncias da mesma extensão de renderização para suportar diferentes opções de apresentação de relatórios (por exemplo, uma versão em modo retrato e paisagem da extensão de renderização Imagem).

  • Altere os parâmetros predefinidos da extensão de renderização para utilizar valores diferentes (por exemplo, a extensão de renderização de imagem utiliza TIFF como formato de saída predefinido; pode modificar os parâmetros da extensão para utilizar EMF em vez de TIFF).

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

Especificar parâmetros de extensão de renderização nos ficheiros de configuração afeta as extensões de renderização globalmente. As definições nos ficheiros de configuração são usadas em vez dos valores padrão sempre que uma determinada extensão de renderização é utilizada. Se quiser definir parâmetros de extensão de renderização para um relatório ou operação de renderização específica, deve especificar a informação do dispositivo de forma programática usando o Render método ou especificando as definições de informação do dispositivo numa URL de relatório. Para mais informações sobre a especificação das definições de informação do dispositivo para uma operação de renderização e para ver a lista completa de definições de informação do dispositivo, consulte Passar definições de informação do dispositivo para extensões de renderização.

Encontre e modifique RSReportServer.config

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

  • O elemento OverrideNames define o nome de visualização e a linguagem da extensão de renderização.

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

Pode usar um editor de texto para modificar o ficheiro. O ficheiro RSReportServer.config pode ser encontrado na pasta \Reporting Services\Report Server\Bin. Para mais informações sobre a modificação de ficheiros de configuração, consulte Modificar um ficheiro de configuração Reporting Services (RSreportserver.config).

Alterar o nome de exibição

O nome de visualização de uma extensão de renderização aparece na lista de Exportação da barra de ferramentas de relatórios. Exemplos de nomes de visualização predefinidos incluem arquivo Web, ficheiro TIFF e ficheiro Acrobat (PDF). Pode substituir o nome de exibição predefinido por um valor personalizado especificando o elemento OverrideNames nos ficheiros de configuração. Além disso, se estiver a definir duas instâncias de uma única extensão de renderização, pode usar o elemento OverrideNames para distinguir cada instância na lista de Exportação.

Como os nomes de exibição são localizados, deve definir o atributo Language se estiver a substituir o nome de exibição predefinido por um valor personalizado. Caso contrário, qualquer nome que especifique será ignorado. O valor de linguagem que definir deve ser válido para o computador do servidor de relatórios. Por exemplo, se o servidor de relatório estiver a correr num sistema operativo francês, deve especificar "fr-FR" como valor do atributo.

O exemplo seguinte ilustra como fornecer um nome personalizado num servidor de relatórios 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>

Alterar definições de informação do dispositivo

Para modificar as definições predefinidas de informação de dispositivo usadas por uma extensão de renderização já implementada no seu servidor de relatórios, deve escrever a estrutura XML DeviceInfo nos ficheiros de configuração. Cada extensão de renderização suporta definições de informação de dispositivo que são únicas para essa extensão. Para ver a lista completa de definições de informação do dispositivo, consulte Passar as definições de informação do dispositivo para extensões de renderização.

O exemplo seguinte fornece uma ilustração da estrutura e sintaxe XML que modifica as definições padrão da extensão de renderização 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>

Configure múltiplas entradas para uma extensão de renderização

Pode criar múltiplas instâncias da mesma extensão de renderização para suportar diferentes opções de apresentação de relatórios. Cada instância que defines pode ter uma combinação diferente de valores de parâmetros. Ao definir novas instâncias de uma extensão de renderização existente, certifique-se de fazer o seguinte:

  • Especifique um nome único para a extensão.

    Cada instância deve ter um valor único para o atributo Nome . O exemplo seguinte utiliza os nomes "IMAGE (EMF Landscape)" e "IMAGE (EMF Portrait)" para distinguir entre as duas instâncias.

    Tenha cautela ao alterar o nome de uma extensão de renderização que já está implementada. Os programadores que especificam extensões de renderização usam o nome da extensão para identificar qual instância usar para uma determinada operação de renderização. Se estiveres a executar aplicações personalizadas de Reporting Services no teu servidor de relatórios, certifica-te de que o programador sabe se modificas um nome de extensão existente ou adicionas um novo.

  • Especifique um nome de apresentação único para que os utilizadores possam compreender as diferenças para cada formato de saída.

    Se estiver a configurar várias versões da mesma extensão, pode dar a cada versão um nome único fornecendo um valor para OverrideNames. Caso contrário, todas as versões da extensão parecerão ter o mesmo nome na lista de opções de Exportação na barra de ferramentas de relatório.

O exemplo seguinte ilustra como usar a extensão padrão de renderização de imagem (que produz saída TIFF) para gerar EMF em modo Retrato juntamente com uma segunda instância que gera relatórios em FEM em modo Paisagem. Note que o nome de cada extensão é único. Ao testar este exemplo, lembre-se de escolher relatórios que não contenham funcionalidades interativas como opções de mostrar/ocultar, matrizes ou links de perfuração (as funcionalidades interativas não funcionam na extensão de renderização 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 Portrait Mode</Name>  
        </OverrideNames>  
        <Configuration>  
            <DeviceInfo>  
                <OutputFormat>EMF</OutputFormat>  
                <PageHeight>11in</PageHeight>  
                <PageWidth>8.5in</PageWidth>  
            </DeviceInfo>  
        </Configuration>  
    </Extension>  
</Render>

Conteúdo relacionado

  • Last updated on