ReportSearch en Office (aplicación de ejemplo)

Artículo
12/15/2008

Nuevo: 5 de diciembre de 2005

En este ejemplo se muestra cómo integrar SQL Server 2005 Reporting Services en Microsoft Office 2003 mediante el panel de tareas Referencia. Puede buscar y examinar los elementos de base de datos del servidor de informes sin salir de Office 2003.

El panel de tareas Referencia de Office 2003 permite a los programadores crear sus propios servicios de referencia. Por ejemplo, si tiene almacenados informes de Reporting Services en un servidor de informes y desea proporcionar dichos informes a los usuarios internos, puede desarrollar un servicio con el panel de tareas Referencia que funcione dentro de las aplicaciones de Office, con lo que los usuarios de Office pueden tener acceso fácilmente a los informes mientras trabajan con documentos de Office.

El ejemplo ReportSearch muestra cómo se pueden exponer directamente los elementos de base de datos del servidor de informes de Reporting Services dentro del panel de tareas Referencia de Office 2003. El usuario puede examinar las carpetas e informes y buscar informes mientras usa la mayor parte de las aplicaciones de Office 2003. Por ejemplo, mientras redacta un mensaje de correo electrónico, un usuario puede buscar un informe relacionado de Reporting Services en el Administrador de informes. La aplicación se basa en un escenario real y muestra cómo ampliar el alcance de los informes.

Importante:
Estos 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.

Requisitos

Para usar el ejemplo ReportSearch, debe saber usar Visual Studio y también C# o Visual Basic, y debe tener instaladas las aplicaciones siguientes en el sistema:

Visual Studio 2005 o un entorno de desarrollo compatible (para ver los archivos del proyecto).
SQL Server 2005, incluido Reporting Services.
Microsoft Office 2003.
Microsoft .NET Framework versión 2.0. Puede obtener .NET Framework SDK de forma gratuita. Vea Instalar .NET Framework SDK.
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. Para obtener más información, vea el artículo acerca de la instalación de los ejemplos.
Un servidor de informes de la red para el que tenga permisos de acceso, si piensa utilizar la aplicación cliente de ejemplo para ver el contenido de un servidor de informes.
Dos bases de datos de ejemplo: AdventureWorksDW (almacenamiento de datos) y AdventureWorksAS (OLAP).

Ubicación

Este ejemplo se encuentra de forma predeterminada en:

C:\Archivos de programa\Microsoft SQL Server\90\Samples\ Reporting Services\Application Samples\ReportSearch Sample

La solución en C# del ejemplo de código se encuentra en el directorio CS, mientras que la solución en Visual Basic se encuentra en el directorio VB.

Configurar 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

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

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 generar y ejecutar este ejemplo, se deben seguir estos pasos. El ejemplo se ha diseñado y probado para ejecutarse en un único equipo.

La autenticación y la suplantación de identidad se establecen en web.config. En el ejemplo se utiliza autenticación de Windows. Siempre que sea posible, utilice la autenticación de Windows.

Para configurar el servicio de referencia de Office

Cree una carpeta de raíz virtual (vroot) de Servicios de Internet Information Server (IIS) a partir de la carpeta de lenguaje predeterminada del ejemplo y asígnele el nombre “ReportSearch”. La carpeta de lenguaje es \cs para la versión C# o \vb para la versión Visual Basic.
Habilite la autenticación de Windows integrada y deshabilite el acceso anónimo en la carpeta de raíz virtual ReportSearch.
Abra una aplicación de Office 2003, como Microsoft Word 2003.
Haga clic en el menú Ver y en Panel de tareas. En el panel de tareas, haga clic en la flecha de cuadro desplegable y seleccione Referencia.
Haga clic en Opciones de referencia al final del panel de tareas. Aparece el cuadro de diálogo Opciones de referencia.
Seleccione Agregar servicios.
En el cuadro Dirección, escriba https://localhost/ReportSearch/reg.asmx.
Haga clic en Agregar.
Haga clic en Continuar.
Haga clic en Instalar.

Ejecutar el ejemplo

Para ver un informe en Word 2003

Abra Word si no está abierto aún y abra el panel de tareas Referencia.
En la lista desplegable Buscar, seleccione Microsoft Reporting Services Sample y presione ENTRAR o haga clic en el botón Ir.
Escriba una ruta de acceso de la carpeta o un nombre de informe para ver elementos del catálogo dentro del panel de tareas.

Ejemplos:
- Escriba una barra diagonal (/) para representar todas las carpetas e informes dentro de la carpeta raíz.
- Escriba un término de búsqueda para devolver todas las carpetas e informes de cualquier carpeta que coincida con dicho término. Por ejemplo, escriba “ventas” para devolver todos los informes y carpetas que contengan la palabra “ventas”.
Una vez que las carpetas e informes se han procesado en el panel de tareas, haga clic en una carpeta para ir al resumen de un informe o haga clic en el vínculo de un informe para examinarlo dentro del Administrador de informes.

[!NOTA] Al escribir un signo de interrogación (?) en el cuadro de texto Buscar, se mostrará la página Búsqueda avanzada para buscar dentro de un campo de descripción, carpeta o nombre específico.

Ver el ejemplo

Para ver el código de ejemplo

Desplácese a la carpeta de lenguaje del ejemplo ReportSearch. La carpeta de lenguaje es \cs para la versión C# o \vb para la versión Visual Basic.
Haga clic en Abrir.

Vea también