Usar la API SOAP en una aplicación para Windows

Integrar la funcionalidad de administración de informes usando formularios Windows Forms

A diferencia del acceso URL, la API SOAP expone el conjunto completo de funciones de administración que están disponibles a través del servidor de informes. Esto significa que toda la funcionalidad administrativa del Administrador de informes está disponible para los programadores a través de SOAP. Como tal, puede desarrollar una completa herramienta de administración utilizando formularios Windows Forms. Por ejemplo, en una aplicación Windows podría desear permitir que los usuarios recuperaran el contenido del espacio de nombres del servidor de informes. Para ello, podría usar el método ListChildren del servicio web para mostrar todos los elementos de la base de datos del servidor de informes y, a continuación, usar un control Listview, Treeview o Combobox para mostrar esos elementos a los usuarios. El código del servicio web siguiente se podría utilizar para recuperar la lista actual de informes disponibles en la carpeta Mis informes de un usuario cuando este haga clic en un botón de un formulario:

' Button click event that retrieves a list of reports from
' the My Reports folder and displays them in a combo box
Private Sub listReportsButton_Click(sender As Object, e As System.EventArgs)
   ' Create a new Web service object and set credentials
   ' to Windows Authentication
   Dim rs As New ReportingService2010()
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials

   ' Return the list of items in My Reports
   Dim items As CatalogItem() = rs.ListChildren("/Adventureworks 2008 Sample Reports", False)

   Dim ci As CatalogItem
   For Each ci In  items
      ' If the item is a report, add it to 
      ' a combo box
      If ci.TypeName = "Report" Then
         catalogComboBox.Items.Add(ci.Name)
      End If
   Next ci
End Sub 'listReportsButton_Click

// Button click event that retrieves a list of reports from
// the My Reports folder and displays them in a combo box
private void listReportsButton_Click(object sender, System.EventArgs e)
{
   // Create a new Web service object and set credentials
   // to Windows Authentication
   ReportingService2010 rs = new ReportingService2010();
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials;

   // Return the list of items in My Reports
   CatalogItem[] items = rs.ListChildren("/Adventureworks 2008 Sample Reports", false);

   foreach (CatalogItem ci in items)
   {
      // If the item is a report, add it to 
      // a combo box
      if (ci.TypeName == "Report")
         catalogComboBox.Items.Add(ci.Name);
   }
}

Habilitar la visualización de informes y la navegación con formularios Windows Forms

Hay dos métodos disponibles para integrar los informes en aplicaciones de formularios Windows Forms.

Puede utilizar la API SOAP para representar los informes en cualquiera de los formatos de representación admitidos utilizando el método Render. Habilitar la visualización de los informes y la navegación a través de SOAP presenta ligeras desventajas:

• No puede aprovecharse de la funcionalidad integrada de la barra de herramientas de informe que se incluye con el Visor HTML a través del acceso URL.

• Si usa HTML para la representación, debe representar por separado las imágenes o recursos como secuencias adicionales utilizando el método RenderStream.

• Representar los informes mediante acceso URL supone una ligera ventaja de rendimiento sobre el uso de la API SOAP.

Sin embargo, el método Render de la API SOAP se puede utilizar para representar los informes y guardarlos en varios formatos de salida mediante programación. Esto es una ventaja sobre el acceso URL, que requiere la interacción con el usuario. Al representar un informe usando el método Render de la API SOAP, puede usar cualquiera de los formatos de salida admitidos.

También puede utilizar los controles ReportViewer que se distribuyen de forma gratuita y se incluyen con Microsoft Visual Studio 2008. Los controles ReportViewer permiten incrustar fácilmente la funcionalidad de Reporting Services en las aplicaciones personalizadas. Los controles ReportViewer se han concebido para los programadores que desean proporcionar informes prediseñados, completamente creados, como parte del conjunto de características de una aplicación (por ejemplo, una aplicación de administración de un sitio web debería incluir informes que mostrasen análisis de secuencias de clic de los sitios web de la compañía). Incrustar los controles en una aplicación es una alternativa simplificada frente a incluir los componentes de servidor de Reporting Services en la implementación de la aplicación. Los controles proporcionan funcionalidad de informes, pero sin las características de compatibilidad adicionales de creación, publicación, distribución y entrega de informes que se incluyen en Reporting Services.

Hay dos versiones de los controles ReportViewer, una para aplicaciones cliente de Windows completas y otra para las aplicaciones ASP.NET. Los controles admiten tanto el modo de procesamiento local como el modo de procesamiento remoto. En el modo de procesamiento local, la aplicación proporciona la definición y los conjuntos de datos de los informes y desencadena el procesamiento de los informes. En el modo de procesamiento remoto, la recuperación de datos y el procesamiento de informes tienen lugar en el servidor de informes y el control se utiliza para la visualización y navegación en informes. Este modelo le permite crear aplicaciones completas que pueden distribuirse del escritorio a la empresa.

Los controles ReportViewer se describen en la Ayuda en pantalla de Visual Studio. Para obtener más información, vea la documentación del producto de Visual Studio.

Vea también

Conceptos

Otros recursos