Personalizar parámetros de extensión de representación en RSReportServer.Config

Puede especificar parámetros de extensión de representación en el archivo de configuración RSReportServer para invalidar el comportamiento predeterminado de representación de informes para los informes que se ejecutan en un servidor de informes de Reporting Services. Puede modificar los parámetros de extensión de representación para lograr los siguientes objetivos:

• Cambie cómo aparece el nombre de la extensión de representación en la lista Exportar de la barra de herramientas del informe (por ejemplo, para cambiar "Archivo web" a "MHTML") o localice el nombre a un idioma diferente.

• Cree varias instancias de la misma extensión de representación para admitir diferentes opciones de presentación de informes (por ejemplo, una versión en modo vertical y horizontal de la extensión de representación de imágenes).

• Cambie los parámetros de extensión de representación predeterminados para usar valores diferentes (por ejemplo, la extensión de representación de imágenes usa TIFF como formato de salida predeterminado; puede modificar los parámetros de extensión para usar EMF en su lugar).

Cambiar los parámetros de extensión de representación solo afecta a las operaciones de representación en el servidor de informes. No se puede invalidar la configuración de la extensión de representación en la vista previa del informe en el Diseñador de informes.

Especificar parámetros de extensión de procesamiento en los archivos de configuración afecta globalmente a las extensiones de procesamiento. Los valores de los archivos de configuración se usan en lugar de valores predeterminados cada vez que se usa una extensión de representación determinada. Si desea establecer parámetros de extensión de representación para un informe específico o una operación de representación, debe especificar la información del dispositivo mediante programación mediante el Render método o especificando la configuración de información del dispositivo en una dirección URL de informe. Para obtener más información sobre cómo especificar la configuración de información del dispositivo para una operación de representación y ver la lista completa de la configuración de información del dispositivo, consulte Pasar la configuración de información del dispositivo a las extensiones de representación.

Buscar y modificar RSReportServer.config

Los valores de configuración para los formatos de salida del informe se especifican como parámetros de extensión de representación en el archivo RSReportServer.config. Para especificar parámetros de extensión de representación en los archivos de configuración, debe saber cómo definir las estructuras XML que establecen parámetros de representación. Hay dos estructuras XML que se pueden modificar:

• El elemento OverrideNames define el nombre para mostrar y el idioma de la extensión de representación.

• La DeviceInfo estructura XML define la configuración de información del dispositivo que usa una extensión de representación. La mayoría de los parámetros de extensión de representación se especifican como configuración de información del dispositivo.

Puede usar un editor de texto para modificar el archivo. El archivo RSReportServer.config se puede encontrar en la carpeta \Reporting Services\Report Server\Bin. Para obtener más información sobre cómo modificar los archivos de configuración, vea Modificar un archivo de configuración de Reporting Services (RSreportserver.config).

Cambiar el nombre de visualización

El nombre visible de una extensión de representación aparece en la lista de exportación en la barra de herramientas de informes. Algunos ejemplos de nombres para mostrar predeterminados incluyen archivo web, archivo TIFF y archivo Acrobat (PDF). Puede reemplazar el nombre para mostrar predeterminado por un valor personalizado al especificar el elemento OverrideNames en los archivos de configuración. Además, si va a definir dos instancias de una sola extensión de representación, puede usar el OverrideNames elemento para distinguir cada instancia de la lista Exportar.

Dado que los nombres para mostrar se localizan, debe establecer el Language atributo si va a reemplazar el nombre para mostrar predeterminado por un valor personalizado. De lo contrario, se omitirá cualquier nombre que especifique. El valor de idioma que establezca debe ser válido para el equipo del servidor de informes. Por ejemplo, si el servidor de informes se ejecuta en un sistema operativo francés, debe especificar "fr-FR" como valor de atributo.

En el ejemplo siguiente se muestra cómo proporcionar un nombre personalizado en un servidor de informes en 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>  

Cambiar la configuración de la información del dispositivo

Para modificar la configuración predeterminada de información del dispositivo que utiliza una extensión de representación ya implementada en el servidor de informes, debe escribir la estructura XML DeviceInfo en los archivos de configuración. Cada extensión de representación admite la configuración de información del dispositivo que es única para esa extensión. Para ver la lista completa de la configuración de información del dispositivo, consulte Pasar la configuración de información del dispositivo a las extensiones de representación.

En el ejemplo siguiente se proporciona una ilustración de la estructura XML y la sintaxis que modifica la configuración predeterminada de la extensión de representación de imágenes:

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

Configuración de varias entradas para una extensión de representación

Puede crear varias instancias de la misma extensión de representación para admitir diferentes opciones de presentación de informes. Cada instancia que defina puede tener una combinación diferente de valores de parámetro. Al definir nuevas instancias de una extensión de representación existente, asegúrese de hacer lo siguiente:

• Especifique un nombre único para la extensión.

  Cada instancia debe tener un valor único para el Name atributo . En el ejemplo siguiente se usan los nombres "IMAGE (EMF Landscape)" y "IMAGE (EMF Portrait)" para distinguir entre las dos instancias.

  Tenga cuidado al cambiar el nombre de una extensión de representación que ya está implementada. Los desarrolladores que especifican extensiones de representación usan mediante programación el nombre de la extensión para identificar qué instancia se usará para una operación de representación determinada. Si ejecuta aplicaciones personalizadas de Reporting Services en el servidor de informes, asegúrese de que el desarrollador sepa si modifica un nombre de extensión existente o agrega uno nuevo.

• Especifique un nombre para mostrar único para que los usuarios puedan comprender las diferencias de cada formato de salida.

  Si va a configurar varias versiones de la misma extensión, puede asignar a cada versión un nombre único proporcionando un valor para OverrideNames. De lo contrario, todas las versiones de la extensión aparecerán con el mismo nombre en la lista Opciones de exportación de la barra de herramientas del informe.

En el ejemplo siguiente se muestra cómo utilizar la extensión predeterminada de representación de imágenes (que produce salida TIFF) para generar EMF en modo retrato, junto a otra instancia que genera informes en EMF en modo paisaje. Observe que cada nombre de extensión es único. Al probar este ejemplo, recuerde elegir informes que no contienen características interactivas, como opciones de mostrar u ocultar, matrices o vínculos de obtención de detalles (las características interactivas no funcionan en la extensión de representación de imágenes):

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

Véase también

Archivo de configuración de RSReportServer
Archivo de configuración RSReportDesigner
Configuración de la información del dispositivo CSV
Configuración de información del dispositivo de Excel
Configuración de información del dispositivo HTML
Configuración de la información del dispositivo de imagen
Configuración de la información del dispositivo MHTML
Configuración de la información del dispositivo PDF
Configuración de información del dispositivo XML