Compartir vía

Implementación de una extensión de representación

  • Artículo

Después de escribir y compilar la extensión de representación de informes de Reporting Services en una biblioteca de .NET Framework, debe hacerlo reconocible por el servidor de informes y por Diseñador de informes. 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 extensión de representación de archivos de configuración

Una vez que una extensión de representación se compila en un archivo .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 elemento Extension contiene dos atributos, Name y Type.

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

Atributo Description
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 Un valor 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 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 obtener más información, consulte el archivo de configuración RsReportServer.config.

Implementación de la extensión en 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.

Implementación del ensamblado

  1. 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 %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. 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 obtener más información, consulte el archivo de configuración RsReportServer.config.

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

  4. 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 las interfaces de usuario, por ejemplo del Administrador de informes, agregue un atributo Visible al elemento Extension y establézcalo en false.

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

Contenido relacionado