Ejemplo de extensión de procesamiento de datos de recurso compartido de archivos

  • Artículo

Actualizado: 5 de diciembre de 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 DirectoryInfo y 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.

Los ejemplos de SQL Server no se instalan de forma automática durante la instalación. Para obtener instrucciones acerca de la instalación de los ejemplos, vea el artículo sobre la instalación de los ejemplos.

ms160918.note(es-es,SQL.90).gifImportante:
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 este tipo de entorno. 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

Para utilizar el ejemplo FsiDataExtension, debería estar familiarizado con Microsoft Visual Studio y Microsoft Visual C# o Microsoft Visual Basic, además de tener instalado lo siguiente:

  • Microsoft Visual Studio 2005 o un entorno de desarrollo compatible (para ver los archivos del proyecto).
  • Microsoft SQL Server 2005, incluido Reporting Services.
  • Microsoft .NET Framework versión 2.0.
  • Los ejemplos de Reporting Services. Si lo desea, puede instalar los ejemplos al mismo tiempo que SQL Server 2005. Para 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 2005.
  • Un servidor de informes para el que disponga de permisos de acceso en la red, si piensa utilizar la extensión de ejemplo para agregar funcionalidad de procesamiento de datos adicional al servidor.

Ubicación

Este ejemplo se encuentra en el subdirectorio Extension Samples\FsiDataExtension Sample del directorio de ejemplos de Reporting Services.

Por ejemplo:

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\FindRenderSave Sample

Generar el ejemplo

Siga los pasos que se indican a continuación para generar el ejemplo.

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 Símbolo del sistema de SDK.

  2. Use el comando de cambio de directorio (CD) para cambiar el directorio actual a la carpeta donde 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 encontrarán en <unidadDeSistema>:\Archivos de programa\Microsoft SQL Server\100\Ejemplos.

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

    sn -k SampleKey.snk

    ms160918.note(es-es,SQL.90).gifImportante:
    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.

    Se abre el cuadro de diálogo Agregar referencias.

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

  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\MSSQL.3\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 8\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 8\Common7\IDE\PrivateAssemblies, y la ubicación predeterminada del archivo RSReportServer.config es C:\Archivos de programa\Microsoft SQL Server\MSSQL.3\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 para 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 Deploying a Data Processing Extension.

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\MSSQL.3\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\MSSQL.3\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 8\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 8\Common7\IDE\PrivateAssemblies.

    Para obtener más información relativa a la seguridad de .NET Framework y Reporting Services, vea Understanding Code Access Security in 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 Todos los programas, Microsoft SQL Server 2005 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 la vista Datos, en Conjunto de datos, seleccione <Nuevo conjunto de datos...>.

    Se abre el cuadro de diálogo Origen de datos.

  2. En la ficha General, 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.90).gifNota de seguridad:
    Siempre que sea posible, utilice la autenticación de Windows. Se le pedirán las credenciales de red siempre que intente tener acceso a un recurso compartido de archivos de red, excepto cuanto 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 del recurso compartido de archivos aparecerán en el panel de resultados inferior.

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 la ventana Campos, arrastre el cuadro Nombre a la primera celda de la fila Detalles. Agregue a la tabla los campos adicionales 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 SQL Server Reporting Services

Otros recursos

Ejemplos de extensiones (Reporting Services)
Implementing a Data Processing Extension

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios

Versión Historial

5 de diciembre de 2005
Contenido modificado:
  • Se cambiaron las instrucciones para generar un archivo de clave, incluidos el nombre y la ubicación del archivo.