• Artículo

Registrar un proveedor de datos estándar de .NET Framework (SSRS)

Para usar un proveedor de datos de .NET Framework de terceros para recuperar datos para un conjunto de datos de informe de Reporting Services, debe implementar y registrar el ensamblado del proveedor de datos de .NET Framework en dos ubicaciones: en el cliente de creación de informes y en el servidor de informes. En el cliente de creación de informes, debe registrar el proveedor de datos como un tipo de origen de datos y asociarlo a un diseñador de consultas. A continuación, puede seleccionar este proveedor de datos como un tipo de origen de datos al crear un conjunto de datos de informe. El diseñador de consultas asociado se abre para ayudarle a crear consultas para este tipo de origen de datos. En el servidor de informes, debe registrar el proveedor de datos como un tipo de origen de datos. A continuación, puede procesar los informes publicados que recuperan datos de un origen de datos con este proveedor de datos.

Los proveedores de terceros no proporcionan necesariamente toda la funcionalidad disponible con las extensiones de procesamiento de datos de Reporting Services. Para obtener más información, vea Orígenes de datos admitidos por Reporting Services (SSRS). Para obtener más información acerca de cómo ampliar la funcionalidad de un proveedor de datos de ..NET Framework, vea Implementar una extensión de procesamiento de datos.

Necesita credenciales de administrador para instalar y registrar proveedores de datos.

Registrar un proveedor de datos de .NET Framework en el servidor de informes

Para procesar los informes publicados que usan este proveedor de datos de .NET Framework en el servidor de informes, debe instalar el ensamblado en el servidor de informes. Debe modificar dos archivos de configuración. Modifique rsreportserver.config para registrar el proveedor de datos. Modifique rssrvpolicy.config para conceder permisos de seguridad de acceso del código para el ensamblado.

Para instalar un ensamblado del proveedor de datos en el servidor de informes

  1. Navegue hasta la ubicación predeterminada del directorio bin del servidor de informes donde desea usar el proveedor de datos de .NET Framework. La ubicación predeterminada del directorio bin del servidor de informes es <drive>:\Archivos de programa\Microsoft SQL Server\ MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\bin.

  2. Copie el ensamblado desde la ubicación de almacenamiento provisional en el directorio bin del servidor de informes. Otra opción es cargar el ensamblado en la caché de ensamblados global (GAC). Para obtener más información, vea Trabajar con ensamblados y la Caché de ensamblados global en la documentación del SDK de .NET Framework en MSDN.

Para registrar un proveedor de datos de .NET en el servidor de informes

  1. Haga una copia de seguridad del archivo RSReportServer.config en el directorio principal ReportServer para bin.

  2. Abra RSReportServer.config. Puede abrir el archivo de configuración con Visual Studio o con un editor de texto simple como el Bloc de notas.

  3. Busque el elemento Data en el archivo RSReportServer.config. Se debe crear una entrada para el proveedor de datos de .NET Framework en la siguiente ubicación:

    <Extensions>
   <Data>
      <Extension Your data provider configuration information goes here />
   </Data>
</Extensions>

  4. Agregue una entrada para el proveedor de datos de .NET Framework.

    Atributo

    Descripción

    Name

    Proporcione un nombre único para el proveedor de datos (por ejemplo, miProveedorDeDatosDeNET). La longitud máxima para el atributo Name es de 255 caracteres. El nombre debe ser único entre todas las entradas en el elemento Extension del archivo de configuración. El valor incluido aquí aparece en la lista desplegable de tipos de orígenes de datos al crear un origen de datos nuevo.

    Type

    Escriba una lista separada por comas que incluya el espacio de nombres completo de la clase que implementa la interfaz IDbConnection, seguido del nombre del ensamblado del proveedor de datos de .NET Framework (no se incluye la extensión del nombre de archivo .dll).

    Por ejemplo, la entrada puede ser similar a la siguiente para una DLL implementada en el directorio bin del servidor de informes:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" />

    Si carga el ensamblado en la caché de ensamblados global (GAC), debe proporcionar las propiedades de nombre seguro. Por ejemplo:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly,Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>

Para establecer la directiva de grupo de código para un proveedor de datos de .NET

  1. Haga una copia de seguridad del archivo rssrvpolicy.config en el directorio principal ReportServer para bin.

  2. Abra rssrvpolicy.config. Puede abrir el archivo de configuración con Visual Studio o con un editor de texto simple como el Bloc de notas.

  3. Busque el elemento CodeGroup en el archivo rssrvpolicy.config.

  4. Agregue un grupo de códigos para el ensamblado del proveedor datos que concede el permiso FullTrust. El grupo de códigos puede ser similar al siguiente:

    <CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="ThisDataProviderCodeGroup"
   Description="Code group for the .NET data provider">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url=
"C:\Program Files\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\bin\DataProviderAssembly.dll"
       />
</CodeGroup>

La pertenencia de dirección URL es solo una de las muchas condiciones de pertenencia que puede seleccionar para el proveedor de datos.

Comprobar la implementación y el registro

Puede comprobar si el proveedor de datos se implementó correctamente para el servidor de informes si abre el Administrador de informes y comprueba si el proveedor de datos está incluido en la lista de orígenes de datos disponibles. Para obtener más información acerca del Administrador de informes y los orígenes de datos, vea Crear, modificar y eliminar orígenes de datos compartidos (SSRS).

Registrar un proveedor de datos de .NET Framework en el cliente del Diseñador de informes

Para crear informes que usen este proveedor de datos de .NET Framework para un origen de datos, debe instalar el ensamblado en el equipo cliente que ejecuta el Diseñador de informes. Debe modificar dos archivos de configuración. Modifique RSReportDesigner.config para registrar el proveedor de datos como un origen de datos y para usar el diseñador de consultas genérico. Modifique RSPreviewPolicy.config para conceder permisos de seguridad de acceso del código para el ensamblado del proveedor de datos.

Para instalar un ensamblado del proveedor de datos en el cliente del Diseñador de informes

  1. Navegue hasta la ubicación predeterminada del directorio PrivateAssemblies del cliente del Diseñador de informes donde desea usar el proveedor de datos de .NET Framework. La ubicación predeterminado del directorio PrivateAssemblies es <drive>:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.

  2. Copie el ensamblado desde la ubicación de almacenamiento provisional en el directorio PrivateAssemblies del cliente del Diseñador de informes. Otra opción es cargar el ensamblado en la caché de ensamblados global (GAC). Para obtener más información, vea Trabajar con ensamblados y la Caché de ensamblados global en la documentación del SDK de .NET Framework en MSDN.

Para registrar un proveedor de datos de .NET en el cliente del Diseñador de informes

  1. Haga una copia de seguridad del archivo RSReportDesigner.config en el directorio PrivateAssemblies.

  2. Abra RSReportDesigner.config con Visual Studio o con un editor de texto simple como el Bloc de notas.

  3. Busque el elemento Data en el archivo RSReportDesigner.config. Se debe crear una entrada para el proveedor de datos en la siguiente ubicación:

    <Extensions>
   <Data>
      <Extension Your data provider configuration information goes here />
   </Data>
</Extensions>

  4. Agregue una entrada para el proveedor de datos.

    Atributo

    Descripción

    Name

    Proporcione un nombre único para el proveedor de datos (por ejemplo, miProveedorDeDatosDeNET). La longitud máxima para el atributo Name es de 255 caracteres. El nombre debe ser único entre todas las entradas en el elemento Extension del archivo de configuración. El valor incluido aquí aparece en la lista desplegable de tipos de orígenes de datos al crear un origen de datos nuevo.

    Type

    Escriba una lista separada por comas que incluya el espacio de nombres completo de la clase que implementa la interfaz IDbConnection, seguido del nombre del ensamblado del proveedor de datos de .NET Framework (no se incluye la extensión del nombre de archivo .dll).

    Por ejemplo, la entrada puede ser similar a la siguiente para una DLL implementada en el directorio PrivateAssemblies de Visual Studio:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly" />

    Si carga el ensamblado en la GAC, debe proporcionar las propiedades de nombre seguro. Por ejemplo:

    <Extension Name="MyNETDataProvider" Type="CompanyName.ExtensionName.DataProviderConnectionClass, DataProviderAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=MyPublicToken"/>

  5. Busque el elemento Designer en el archivo RSReportDesigner.config. Se debe crear una entrada para el proveedor de datos de .NET Framework en la siguiente ubicación:

    <Extensions>
   <Designer>
      <Your data provider configuration information goes here>
   </Designer>
</Extensions>

  6. Agregue la siguiente entrada al archivo RSReportDesigner.config en el elemento Designer. Debe reemplazar solamente el atributo Name por el nombre proporcionado en las entradas anteriores.

    <Extension Name="MyNETDataProvider" Type="Microsoft.ReportingServices.QueryDesigners.GenericQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>

Para establecer la directiva de grupo de código para un proveedor de datos de .NET en el cliente del Diseñador de informes

  1. Haga una copia de seguridad del archivo RSPreviewPolicy.config en el directorio PrivateAssemblies.

  2. Abra RSPreviewPolicy.config con Visual Studio o un editor de texto simple como el Bloc de notas.

  3. Busque el elemento CodeGroup en el archivo RSPreviewPolicy.config.

  4. Agregue un grupo de códigos para el ensamblado del proveedor datos de .NET Framework que concede el permiso FullTrust. El grupo de códigos puede ser similar al siguiente:

    <CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="ThisDataProviderCodeGroup"
   Description="Code group for the .NET data provider">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url=
" C:\Program Files\Microsoft Visual Studio 9\Common7\IDE\PrivateAssemblies\DataProviderAssembly.dll"
       />
</CodeGroup>

La pertenencia de dirección URL es solo una de las muchas condiciones de pertenencia que puede seleccionar para el proveedor de datos.

Comprobar la implementación y el registro en el cliente del Diseñador de informes

Para poder comprobar la implementación, debe cerrar todas las instancias de Visual Studio en el equipo local. Una vez que haya finalizado todas las sesiones actuales, puede comprobar si el proveedor de datos se implementó correctamente para el Diseñador de informes si crea un proyecto de informe nuevo en Visual Studio. El proveedor de datos se debe incluir en la lista de tipos de orígenes de datos disponibles al crear un conjunto de datos nuevo para el informe.

Consideraciones sobre las plataformas

En una plataforma de 64 bits (x64), Business Intelligence Development Studio se ejecuta en el modo WOW de 32 bits. Si crea informes en una plataforma x64, necesita tener proveedores de datos de 32 bits instalados en el cliente de creación de informes para obtener vistas previas de los informes. Si publica el informe en el mismo sistema, necesita proveedores de datos x64 para ver el informe con el Administrador de informes.

Business Intelligence Development Studio no se admite para las plataformas basadas en Itanium.

Las extensiones de procesamiento de datos instaladas con Reporting Services se deben compilar de forma nativa para cada plataforma e instalar en las ubicaciones correctas. Si registra un proveedor de datos personalizado o un proveedor de datos estándar de .NET Framework, se debe compilar de forma nativa para la plataforma adecuada e instalar en las ubicaciones correctas. Si usa una plataforma de 32 bits, el proveedor de datos se debe compilar para una plataforma de 32 bits. Si usa una plataforma de 64 bits, el proveedor de datos se debe compilar para una plataforma de 64 bits. No puede usar un proveedor de datos de 32 bits incluido con interfaces de 64 bits en una plataforma de 64 bits. Compruebe el software de terceros para obtener información acerca de si el proveedor de datos funcionará en la plataforma instalada. Para obtener más información acerca de los proveedores de datos y las plataformas compatibles, vea Orígenes de datos admitidos por Reporting Services (SSRS).