Implementar una extensión de representación

Artículo
06/13/2017

Después de haber escrito y compilado la extensión de representación de informes de Reporting Services en una biblioteca de .NET Framework, es necesario hacer que el servidor de informes y el Diseñador de informes la puedan reconocer. Para ello, copie la extensión en el directorio adecuado y agregue las entradas a los archivos de configuración de Reporting Services adecuados.

Elemento Extension de representación de archivos de configuración

Una vez compilada una extensión de representación en una .DLL, agregue una entrada al archivo rsreportserver.config. De forma predeterminada, la ubicación es %Archivos de programa\Microsoft SQL Server\MSRS10_50.<nombreDeInstancia>\Reporting Services\ReportServer. El elemento primario es <Render>. Bajo el elemento Render hay un elemento Extension para cada extensión de representación. El elemento Extension 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 dentro del elemento Extensions del 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	El valor `false` indica que la extensión de representación no debería estar visible en las interfaces de usuario. Si el atributo no está incluido, el valor predeterminado es `true`.
LogAllExecutionRequests	Un valor `false` indica que una entrada solo se registra para la primera ejecución de un informe en una sesión. Si el atributo no está incluido, el valor predeterminado es `true`. Por ejemplo, este valor de configuración determina si se ha de registrar una entrada solo para la primera página representada en un informe (en el caso de `false`) o una entrada para cada página representada en el informe (en el caso de `true`).

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

Implementar la extensión para el servidor de informes

El servidor de informes utiliza las extensiones de representación para exportar los informes a otros formatos. Debería implementar su ensamblado de extensión de representación para el servidor de informes como un ensamblado privado. También tiene que realizar una entrada en el archivo de configuración del servidor de informes, rsreportserver.config.

Para implementar el ensamblado

Copie el ensamblado de la ubicación provisional al directorio bin del servidor de informes en el que desea utilizar la extensión de representación. La ubicación predeterminada del directorio Bin del servidor de informes es %Archivos de programa%\Microsoft SQL Server\MSRS10_50.<nombreDeInstancia>\Reporting Services\ReportServer\Bin.
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. Tiene que realizar una entrada en el archivo de configuración para el archivo de ensamblado de extensión. Puede abrir el archivo con Visual Studio o con un simple editor de texto.

Para más información, consulte RSReportServer Configuration File.
Busque el elemento Render en el archivo Rsreportserver.config. En la ubicación siguiente se debería realizar una extensión creada recientemente:
```
<Extensions>  
   <Render>  
      <extension configuration>  
   </Render>  
</Extensions>  
```
Agregue una entrada para la extensión de representación. La entrada debería incluir un elemento que tenga valores para Name y Type, y podría parecerse a la 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 implementación de IRenderingExtension, seguida 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 en false.

Comprobación de la implementación

Puede abrir también el Administrador de informes y comprobar que la extensión está incluida en la lista de tipos de exportación disponibles para un informe.

Consulte también

Ejecución de una extensión de representación
Información general de las extensiones de representación
Ejecución de la interfaz IRenderingExtension
Consideraciones de seguridad para las extensiones

Compartir a través de