Compartir a través de

Léame del ejemplo de extensión de procesamiento de datos de recursos compartidos de archivos

  • Artículo

Este ejemplo sólo funciona con SQL Server 2005 y SQL Server 2008. No funcionará con ninguna versión de SQL Server anterior a SQL Server 2005.

FsiDataExtension es una extensión de procesamiento de datos simple para el sistema de archivos de Windows. Utiliza las clases de biblioteca de Microsoft .NET Framework System.IO.DirectoryInfo y System.IO.FileSystemInfo para realizar consultas del contenido de cualquier recurso compartido de archivos de red válido. El ejemplo utiliza las interfaces de extensiones de procesamiento de datos, además de otras clases de .NET Framework. La convención de nomenclatura utilizada para el ejemplo es el prefijo "Fsi", del inglés File Share Information (información de recurso compartido de archivos). Este ejemplo no es compatible con los sistemas operativos basados en Itanium.

Importante

Los ejemplos se proporcionan exclusivamente con fines formativos. No se han diseñado para utilizarse en un entorno de producción y no se han probado en ningún entorno de este tipo. Microsoft no ofrece soporte técnico para estos ejemplos. Las aplicaciones y los ensamblados de ejemplo no se deben conectar ni usar con la base de datos de SQL Server de producción ni con el servidor de informes sin el permiso del administrador del sistema.

Requisitos

Debe estar familiarizado con Microsoft Visual Studio y con Microsoft Visual C# o Microsoft Visual Basic, así como tener instalado todo los siguiente para utilizar el ejemplo de FsiDataExtension:

  • Microsoft Microsoft Visual Studio 2005 o un entorno de desarrollo compatible (para ver los archivos del proyecto).
  • Microsoft SQL Server, incluido el Reporting Services.
  • Microsoft .NET Framework 2.0.
  • Ejemplos del Reporting Services. Si lo desea, puede instalar los ejemplos al mismo tiempo que SQL Server. En esta versión, cuando elija instalar los ejemplos, se instala un instalador independiente en el equipo, que puede iniciar para extraer e instalar ejemplos. Puede ejecutar este instalador desde el menú Inicio del grupo de programas de Microsoft SQL Server.
  • Servidor de informes para el que disponga de permisos de acceso en la red, si piensa utilizar la extensión de ejemplo con el fin de agregar más funcionalidad de procesamiento de datos al servidor.

Importante

Se deben descargar e instalar primero las bases de datos de ejemplo y los ejemplos de SQL Server para poder verlos o trabajar con ellos. Para obtener más información, vea Consideraciones para instalar ejemplos y bases de datos de ejemplo de SQL Server.

Ubicación

De forma predeterminada, este ejemplo se encuentra en el directorio siguiente:

C:\Archivos de programa\Microsoft SQL Server\100\Samples\Reporting Services\ Extension Samples\FindRenderSave Sample

Generar el ejemplo

Para generar el ejemplo, siga estos pasos.

Si aún no ha creado un archivo de clave de nombre seguro, genere este archivo mediante las siguientes instrucciones.

Para generar un archivo de clave de nombre seguro

  1. Abra un símbolo del sistema de Microsoft Visual Studio 2005. Haga clic en Inicio, seleccione Todos los programas, Microsoft .NET Framework SDK 2.0 y, a continuación, haga clic en Símbolo del sistema de SDK.

    -- O bien --

    Abra un símbolo del sistema de Microsoft .NET Framework. Haga clic en Inicio, seleccione Todos los programas, Microsoft .NET Framework SDK 2.0 y, a continuación, haga clic en SDK Command Prompt.

  2. Use el comando de cambio de directorio (CD) para cambiar el directorio actual de la ventana del símbolo del sistema a la carpeta en la que están instalados los ejemplos.

    Nota

    Para determinar la carpeta donde se encuentran los ejemplos, haga clic en el botón Inicio, seleccione Todos los programas, Microsoft SQL Server, Documentación y tutoriales y, a continuación, haga clic en el directorio Ejemplos. Si se usó la ubicación de instalación predeterminada, los ejemplos se encuentran en <unidadDelSistema>:\Archivos de programa\Microsoft SQL Server\100\Samples.

  3. En el símbolo del sistema, ejecute el comando siguiente para generar el archivo de clave:

    sn -k SampleKey.snk

    Importante

    Para obtener más información acerca del par de claves de nombre seguro, vea el apartado sobre informes de seguridad de nombres seguros y seguridad en .NET Framework en el centro de desarrollo de .NET de MSDN.

Para compilar el ejemplo mediante .NET Framework SDK

  1. Copie el archivo Microsoft.ReportingServices.Interfaces.dll del directorio \bin del servidor en la carpeta de ejemplos.

  2. Escriba los comandos siguientes para crear la extensión de procesamiento de datos de ejemplo Microsoft.Samples.ReportingServices.FsiDataExtension.dll.

    csc.exe /t:library /out:Microsoft.Samples.ReportingServices.FsiDataExtension.dll *.cs .\properties\*.cs /res:.\properties\Resources.resx  /r:Microsoft.ReportingServices.Interfaces.dll

Para compilar el ejemplo mediante Visual Studio .NET

  1. Abra el archivo de solución FsiDataExtension (FsiDataExtensionCS.sln o FsiDataExtensionVB.sln) en Visual Studio 2005.

  2. En el Explorador de soluciones, seleccione el proyecto FsiDataExtension.

  3. En el menú Proyecto, haga clic en Agregar referencia.

  4. En el cuadro de diálogo Agregar referencias, haga clic en la ficha .NET.

  5. Haga clic en Examinar y busque Microsoft.ReportingServices.Interfaces en la unidad local. De forma predeterminada, el ensamblado se encuentra en el directorio ReportServer\bin. Haga clic en Aceptar.

    La referencia seleccionada se agrega al proyecto.

    Nota

    Puede que ya se haya agregado la referencia al proyecto. En este caso, no tiene que volver a agregar ninguna referencia.

  6. En el menú Generar, haga clic en Generar solución.

Implementar el ejemplo

Cuando haya realizado los pasos anteriores, Microsoft.Samples.ReportingServices.FsiDataExtension.dll se puede implementar en un servidor de informes o en el Diseñador de informes para su utilización en la ejecución de informes en un origen de datos personalizado.

Para implementar el ejemplo

  1. Copie Microsoft.Samples.ReportingServices.FsiDataExtension.dll en el servidor de informes. La ubicación predeterminada de las extensiones del servidor de informes es C:\Archivos de programa\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin.

  2. Copie el ensamblado en el Diseñador de informes. La ubicación predeterminada de las extensiones del Diseñador de informes es C:\Archivos de programaMicrosoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.

  3. Agregue la siguiente entrada a los archivos RSReportServer.config y RSReportDesigner.config en el elemento Data (la ubicación predeterminada del archivo RSReportDesigner.config es C:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies, y la del archivo RSReportServer.config, C:\Archivos de programa\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer):

    <Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>

  4. Para habilitar el diseñador de consultas genérico de la extensión de procesamiento de datos de ejemplo, agregue la entrada siguiente al archivo RSReportDesigner.config en el elemento Designer.

    <Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>

Para obtener más información acerca de la implementación de extensiones de procesamiento de datos, vea Implementar una extensión de procesamiento de datos.

Para configurar la seguridad de acceso al código para el ejemplo

  1. Abra el archivo de configuración de directivas del servidor de informes (rssrvpolicy.config). La ubicación predeterminada de este archivo es C:\Archivos de programa\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer.

  2. Se debe conceder plena confianza a las extensiones de procesamiento de datos. Para ello, agregue la siguiente información de grupo de código al final de la sección de grupos de código del archivo de configuración:

    <CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSRS10.MSSQLSERVER\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>

  3. Si va a utilizar el ejemplo de extensión de procesamiento de datos en el Diseñador de informes, repita los pasos 1 y 2 utilizando el archivo de configuración de directivas de vista previa del Diseñador de informes (rspreviewpolicy.config) y el siguiente grupo de código:

    <CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>

    La ubicación predeterminada del archivo rspreviewpolicy.config es C:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies.

    Para obtener más información sobre seguridad de .NET Framework y Reporting Services, vea Desarrollo seguro (Reporting Services).

Crear informes que utilicen FsiDataExtension

Esta sección contiene una rápida visita guiada que muestra cómo crear un informe de ejemplo que utiliza la extensión de datos de ejemplo.

Nota

Debe implementar la extensión de datos de recurso compartido de archivos de ejemplo en el Diseñador de informes y en el servidor de informes antes de crear un informe. También debe habilitar el diseñador de consultas genérico para la extensión. Para obtener más información, vea la sección relativa a cómo implementar FsiDataExtension, anteriormente en este mismo tema.

Para crear el proyecto del informe

  1. Haga clic en Inicio, seleccione Programas, Microsoft SQL Server 2008 y, a continuación, haga clic en Business Intelligence Development Studio.

  2. En el menú Archivo, seleccione Nuevo y haga clic en Proyecto.

  3. En la lista Tipos de proyecto, haga clic en Proyectos de Business Intelligence.

  4. En la lista Plantillas, haga clic en Proyecto de servidor de informes.

  5. En Nombre, escriba FsiReportProject.

  6. Haga clic en Aceptar para crear el proyecto de informe.

Para crear el informe

  1. En el menú Proyecto, haga clic en Agregar nuevo elemento.

  2. En la lista Categorías, haga clic en Proyecto de informe.

  3. En la lista Plantillas, haga clic en Informe.

  4. En el cuadro Nombre, escriba FsiReport y, a continuación, haga clic en Abrir.

Para abrir un origen de datos que utiliza la extensión de datos de ejemplo

  1. En el panel Datos, haga clic en Nuevo y, a continuación, seleccione Nuevo conjunto de datos.

  2. En la ficha Consulta, en el cuadro de texto Nombre, escriba FsiDataSource.

  3. En la lista Tipo, seleccione Información del recurso compartido de archivos.

  4. Deje ConnectionString vacío. La extensión de datos de ejemplo no utiliza una cadena de conexión.

  5. En la ficha Credenciales, haga clic en uno de los tipos de inicio de sesión del servidor. Puede escribir el nombre de usuario y la contraseña del recurso compartido de archivos al que va a tener acceso la extensión de datos de ejemplo. Haga clic en Utilizar autenticación de Windows (seguridad integrada), en Utilizar un nombre de usuario y una contraseña específicos y escriba las credenciales o en Pedir credenciales y escriba una cadena de mensaje.

    ms160918.security(es-es,SQL.100).gifNota de seguridad:
    Siempre que sea posible, utilice la autenticación de Windows. Se le pedirán las credenciales de red siempre que trate de tener acceso a un recurso compartido de archivos de red, excepto cuando haya almacenado en caché sus credenciales.

  6. Haga clic en Aceptar para guardar el origen de datos.

Para ver el conjunto de datos

  1. En la vista Datos se muestra el diseñador de consultas genérico. En Tipo de comando, seleccione Texto.

  2. En el panel de consultas situado debajo de la barra de herramientas del diseñador de consultas genérico, escriba la ruta de acceso de un recurso compartido de archivos de red disponible en la red. Por ejemplo, escriba \\Computer1\Public.

  3. En la barra de herramientas del diseñador de consultas genérico, haga clic en el botón Ejecutar (!).

    Los datos de recursos compartidos de archivos aparecerán en el panel de detalles.

Para establecer el diseño del informe

  1. En la vista Diseño, en el Cuadro de herramientas, haga clic en Tabla.

  2. Arrastre el control Tabla a la superficie de diseño.

  3. En el panel Datos de informe, arrastre el cuadro Nombre a la primera celda de la fila Detalle. Agregue a la tabla los campos que desee.

Para obtener la vista previa del informe

  1. Haga clic en la ficha Vista previa para obtener la vista previa del informe. Dependiendo de la configuración de las credenciales de FsiDataSource, se le puede solicitar que escriba un nombre de usuario y contraseña.

Vea también

Tareas

Compilar y ejecutar ejemplos de código
Ejemplos de Reporting Services

Otros recursos

Ejemplos de extensiones (Reporting Services)
Implementar una extensión de procesamiento de datos

Ayuda e información

Obtener ayuda sobre SQL Server 2008