Compartir a través de


Implementación de una extensión de renderizado

Después de escribir y compilar la extensión de representación de informes de Reporting Services en una biblioteca de .NET Framework, debe hacer que el servidor de informes pueda detectarlo y el Diseñador de informes. Para ello, copie la extensión en el directorio adecuado y agregue entradas a los archivos de configuración de Reporting Services adecuados.

Elemento de extensión de representación de archivos de configuración

Una vez compilada una extensión de representación en un .DLL, se agrega una entrada al archivo rsreportserver.config. De forma predeterminada, la ubicación es %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer. El elemento primario es <Render>. En el elemento Render es un elemento Extension para cada extensión de representación. El Extension elemento contiene dos atributos, Name y Type.

En la tabla siguiente se describen los atributos del Extension elemento para las extensiones de representación:

Atributo Descripción
Nombre Nombre único de la extensión. La longitud máxima para el atributo Name es de 255 caracteres. El nombre debe ser único entre todas las entradas del elemento Extensions de un archivo de configuración. Si hay un nombre duplicado, el servidor de informes devuelve un error.
Tipo Lista separada por comas que incluye el espacio de nombres completo junto con el nombre del ensamblado.
visible Un valor de false indica que la extensión de representación no debe estar visible en las interfaces de usuario. Si el atributo no está incluido, el valor predeterminado es true.
LogAllExecutionRequests Un valor de false indica que una entrada se registra solo para la primera ejecución del informe en una sesión. Si el atributo no está incluido, el valor predeterminado es true.

Por ejemplo, esta configuración determina si se va a registrar una entrada solo para la primera página representada en un informe (cuando false) o una entrada para cada página representada en el informe (cuando true).

Para más información, consulte RSReportServer Configuration File.

Implementación de la extensión en el servidor de informes

El servidor de informes usa extensiones de representación para exportar informes a otros formatos. Debe implementar el ensamblado de extensión de representación en el servidor de informes como un ensamblado privado. También debe realizar una entrada en el archivo de configuración del servidor de informes, rsreportserver.config.

Para implementar el ensamblado

  1. Copie el ensamblado de la ubicación de almacenamiento provisional en el directorio bin del servidor de informes en el que desea usar la extensión de representación. La ubicación predeterminada del directorio Bin del servidor de informes es %ProgramFiles%\Microsoft SQL Server\MSRS10_50.<InstanceName>\Reporting Services\ReportServer\Bin.

  2. Una vez copiado el archivo de ensamblado, abra el archivo rsreportserver.config. El archivo rsreportserver.config también se encuentra en el directorio bin del servidor de informes. Debe realizar una entrada en el archivo de configuración del archivo de ensamblado de extensión. Puede abrir el archivo con Visual Studio o un editor de texto simple.

    Para más información, consulte RSReportServer Configuration File.

  3. Busque el elemento Render en el archivo Rsreportserver.config. Se debe realizar una entrada para la extensión recién creada en la siguiente ubicación:

    <Extensions>  
       <Render>  
          <extension configuration>  
       </Render>  
    </Extensions>  
    
  4. Agregue una entrada para la extensión de representación. La entrada debe incluir un elemento que tenga valores para Name y Type, y podría tener un aspecto similar al siguiente:

    <Extension Name="My Rendering Extension Name" Type="CompanyName.ExtensionName.MyRenderingProvider, AssemblyName" />  
    

    El valor de Name es el nombre único de la extensión de representación. El valor de Type es una lista separada por comas que incluye una entrada para el espacio de nombres completo de la IRenderingExtension implementación, seguido del nombre del ensamblado (sin incluir la extensión de archivo .dll). De forma predeterminada, las extensiones de representación están visibles. Para ocultar una extensión de interfaces de usuario, como el Administrador de informes, agregue un atributo Visible al Extension elemento y establézcalo falseen .

Comprobación de la implementación

También puede abrir el Administrador de informes y comprobar que la extensión se incluye en la lista de tipos de exportación disponibles para un informe.

Véase también

Implementación de una extensión de representación
Introducción a las extensiones de representación
Implementación de la interfaz IRenderingExtension
Consideraciones de seguridad para las extensiones