Personalizar los parámetros de extensión de representación en RSReportServer.ConfigCustomize Rendering Extension Parameters in RSReportServer.Config

Es posible especificar parámetros de extensión de representación en el archivo de configuración RSReportServer para invalidar el comportamiento predeterminado de la representación de los informes que se ejecutan en un servidor de informes de 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. Los parámetros de extensión de representación se pueden modificar para lograr los siguientes objetivos:You can modify rendering extension parameters to achieve the following objectives:

  • Cambiar la manera en que aparece el nombre de la extensión de representación en la lista Exportar de la barra de herramientas de informe (por ejemplo, para cambiar "Archivo web" a "MHTML") o traducir el nombre a un 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.

  • Crear varias instancias de la misma extensión de representación para admitir distintas opciones de presentación de informes (por ejemplo, una versión en modo horizontal y vertical de la extensión de representación en imágenes).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).

  • Cambiar los parámetros de la extensión de representación predeterminada para que utilicen valores diferentes (por ejemplo, la extensión de representación en imágenes utiliza TIFF como el formato de salida predeterminado; se pueden modificar los parámetros de la extensión de manera que se utilice 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).

    La modificación de los parámetros de extensión de representación solo afecta a las operaciones de representación del servidor de informes.Changing the rendering extension parameters only affects rendering operations on the report server. La configuración de la extensión de representación no se puede reemplazar en la vista previa del informe del Diseñador de informes.You cannot override rendering extension settings in report preview in Report Designer.

    Cuando se especifican parámetros de extensión de representación en los archivos de configuración, las extensiones de representación se ven afectadas globalmente.Specifying rendering extension parameters in the configuration files affects rendering extensions globally. Los valores de los archivos de configuración se usarán en lugar de los valores predeterminados siempre que se utilice una extensión de representación determinada.The settings in the configuration files are used in place of default values whenever a particular rendering extension is used. Si se quiere establecer parámetros de extensión de representación para un informe o una operación de representación específicos, debe especificarse la información de dispositivo mediante programación, usando el método Render o especificando la configuración de información de dispositivo en una dirección URL de informe.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 obtener más información sobre cómo especificar los valores de información de dispositivo para una operación de representación, y ver la lista completa de valores de información de dispositivo, vea Pasar la configuración de información de dispositivo a las extensiones de representación.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.

Buscar y modificar RSReportServer.configFinding and Modifying RSReportServer.config

Los ajustes de configuración para los formatos de la salida de informes se especifican como parámetros de extensión de representación en el archivo RSReportServer.config.Configuration settings for report output formats are specified as rendering extension parameters in the RSReportServer.config file. Para especificar parámetros de extensión de representación en los archivos de configuración, es necesario saber cómo se definen las estructuras XML que establecen los parámetros de representación.To specify rendering extension parameters in the configuration files, you must know how to define the XML structures that set rendering parameters. Hay dos estructuras XML que se pueden modificar:There are two XML structures that you can modify:

  • El elemento OverrideNames define el nombre para mostrar y el idioma de la extensión de representación.The OverrideNames element defines the display name and language of the rendering extension.

  • La estructura XML DeviceInfo define la configuración de información de dispositivo que utiliza una extensión de representación.The DeviceInfo XML structure defines the device information settings that are used by a rendering extension. La mayoría de los parámetros de extensión de representación se especifican como valores de información de dispositivo.Most rendering extension parameters are specified as device information settings.

    Para modificarlo, se puede usar un editor de texto.You can use a text editor to modify the file. El archivo RSReportServer.config se encuentra en la carpeta \Reporting Services\Report Server\Bin.The RSReportServer.config file can be found in the \Reporting Services\Report Server\Bin folder. Para obtener más información acerca de cómo modificar archivos de configuración, consulte modificar un archivo de configuración de Reporting Services ( RSreportserver.config ) .For more information about modifying configuration files, see Modify a Reporting Services Configuration File (RSreportserver.config).

Cambiar el nombre para mostrarChanging the Display Name

El nombre para mostrar de una extensión de representación aparece en la lista Exportar de la barra de herramientas de informe.The display name for a rendering extension appears in the Export list of the report toolbar. Algunos ejemplos de nombres para mostrar predeterminados son Archivo web, Archivo TIFF y Archivo PDF de Acrobat.Examples of default display names include Web archive, TIFF file, and Acrobat (PDF) file. El nombre para mostrar predeterminado se puede sustituir por un valor personalizado especificando el elemento OverrideNames en los archivos de configuración.You can replace the default display name with a custom value by specifying the OverrideNames element in the configuration files. Además, si se van a definir dos instancias de una extensión de representación, se puede utilizar el elemento OverrideNames para distinguirlas en la 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.

Dado que los nombres para mostrar se traducen, será necesario establecer el atributo Language si se va a sustituir el nombre para mostrar predeterminado por un 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. Si no, se pasará por alto cualquier nombre que se especifique.Otherwise, any name that you specify will be ignored. El valor de idioma que se establezca debe ser válido en el equipo del servidor de informes.The language value that you set must be valid for the report server computer. Por ejemplo, si el servidor de informes se ejecuta en un sistema operativo en francés, deberá especificarse "fr-FR" como valor del atributo.For example, if the report server is running on a French operating system, you should specify "fr-FR" as the attribute value.

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

Cambiar la configuración de la información del dispositivoChanging Device Information Settings

Para modificar la configuración predeterminada de la información del dispositivo que utiliza una extensión de representación ya implementada en el servidor de informes, debe incluirse la estructura XML DeviceInfo en los archivos de configuración.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. Cada extensión de representación admite valores de información de dispositivo exclusivos para esa extensión.Every rendering extension supports device information settings that are unique to that extension. Para ver la lista completa de la configuración de la información de dispositivos, vea Pasar la configuración de información de dispositivo a las extensiones de representación.To view the complete list of device information settings, see Passing Device Information Settings to Rendering Extensions.

En el ejemplo siguiente se muestran la estructura XML y la sintaxis que modifica la configuración predeterminada de la extensión de representación en imágenes: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>  

Configurar varias entradas para una extensión de representaciónConfiguring Multiple Entries for a Rendering Extension

Se pueden crear varias instancias de la misma extensión de representación para admitir diferentes opciones de presentación de informes.You can create multiple instances of the same rendering extension to support different report presentation options. Cada instancia que se defina puede tener una combinación distinta de valores de parámetro.Each instance that you define can have a different combination of parameter values. Cuando defina nuevas instancias de una extensión de representación existente, realice los pasos siguientes:When defining new instances of an existing rendering extension, be sure to do the following:

  • Especifique un nombre único para la extensión.Specify a unique name for the extension.

    Cada instancia debe tener un valor único para el atributo Name .Each instance must have a unique value for the Name attribute. En el ejemplo siguiente se utilizan los nombres "IMAGE (EMF Landscape)" e "IMAGE (EMF Portrait)" para distinguir las dos instancias.The following example uses the names "IMAGE (EMF Landscape)" and "IMAGE (EMF Portrait)" to distinguish between the two instances.

    Tenga cuidado al cambiar el nombre de una extensión de representación ya implementada.Use caution when changing the name of a rendering extension that is already deployed. Los programadores que especifican extensiones de representación mediante programación usan el nombre de la extensión para identificar la instancia que se va a utilizar en una operación de representación determinada.Developers who specify rendering extensions programmatically use the extension name to identify which instance to use for a particular render operation. Si se ejecutan aplicaciones de Reporting ServicesReporting Services personalizadas en el servidor de informes, asegúrese de que el programador sabe que ha modificado un nombre de extensión existente o ha agregado uno nuevo.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 un nombre para mostrar único de manera que los usuarios entiendan las diferencias de cada formato de salida.Specify a unique display name so that users can understand the differences for each output format.

    Si configura varias versiones de la misma extensión, puede asignar a cada versión un nombre único, proporcionando un 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. En caso contrario, todas las versiones de la extensión aparentemente tendrán el mismo nombre en la lista de opciones de exportación de la barra de herramientas de informe.Otherwise, all versions of the extension will appear to have the same name in the Export options list on the report toolbar.

    En el siguiente ejemplo se muestra cómo utilizar la extensión de representación en imágenes predeterminada (que genera salida TIFF) para generar salida EMF en modo vertical, junto con una segunda instancia que genera informes en formato EMF en modo horizontal.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 cómo el nombre de cada extensión es único.Notice that each extension name is unique. Cuando pruebe este ejemplo, no olvide elegir informes que no contengan funciones interactivas, como opciones de mostrar u ocultar, matrices o vínculos de obtención de detalles (las funciones interactivas no funcionan en la extensión de representación en imágenes):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>  

Vea tambiénSee Also

El archivo de configuración RSReportServer.config RsReportServer.config Configuration File
Archivo de configuración RSReportDesigner RSReportDesigner Configuration File
CSV Device Information Settings CSV Device Information Settings
Excel Device Information Settings Excel Device Information Settings
Configuración de la información de dispositivo HTML HTML Device Information Settings
Configuración de información de dispositivo de imagen Image Device Information Settings
Configuración de información del dispositivo MHTML MHTML Device Information Settings
PDF Device Information Settings PDF Device Information Settings
Configuración de información del dispositivo XMLXML Device Information Settings