Lección 2: Definir un conjunto de datos de informe para un conjunto de datos ADO.NET desde un servicio Web

Artículo
12/15/2008

Nuevo: 17 de julio de 2006

En esta lección creará una conexión de origen de datos a un servicio Web que devuelve un objeto System.Data.DataSet XML. Creará e implementará un servicio Web que devuelve un objeto System.Data.DataSet XML o utilizará un servicio Web existente disponible. Definirá una cadena de consulta que especifica los datos que desea recuperar para un conjunto de datos de informe desde el System.Data.DataSet XML que devolvió el servicio Web.

En este tutorial, un servicio Web recupera información sobre jefes y empleados mediante una llamada al procedimiento almacenado uspGetEmployeeManagers en la base de datos de ejemplo AdventureWorks. Este procedimiento almacenado acepta un valor EmployeeID y produce un conjunto de resultados que muestra las relaciones jefe-empleado mediante una jerarquía recursiva hasta el empleado del nivel superior.

Procedimientos

Para crear un servicio Web que devuelve un conjunto de datos ADO.NET (opcional)

En Microsoft Visual Studio, en el menú Archivo, haga clic en Nuevo y luego en Sitio Web.

Se abrirá el cuadro de diálogo Agregar sitio Web.

[!NOTA] Si no ve la opción Sitio Web, revise la sección de requisitos del Tutorial: Usar datos XML en un informe.
En el panel Plantillas, seleccione Servicio Web ASP.NET.
En la lista desplegable Ubicación, seleccione HTTP.
En la lista desplegable Lenguaje, seleccione Visual Basic o C#.
Haga clic en el botón Examinar.

Se abrirá el cuadro de diálogo Seleccionar ubicación.
En el panel Abrir sitio Web, compruebe que el botón IIS local está seleccionado.
En el control de árbol del sitio Web, desplácese a la carpeta principal de este nuevo sitio Web.
Haga clic en el botón Crear nueva aplicación Web.
Escriba un nombre para el sitio Web.
Haga clic en Abrir.
Haga clic en Aceptar.

La página de códigos App_Code/Service para el lenguaje de programación que seleccionó en el paso 4 se abrirá en Visual Studio y mostrará el WebMethod de ejemplo HelloWorld.

[!NOTA] El espacio de nombres predeterminado es http://tempuri.org/. Este espacio de nombres se utilizará en la consulta cuando defina un conjunto de datos de informe a continuación. Si cambia este valor predeterminado, necesitará cambiar la consulta.
Agregue las dos siguientes referencias de espacio de nombres al inicio del archivo de origen para Visual Basic o C#.
```
using System.Data;
using System.Data.SqlClient;
```
```
Imports System.Data
Imports System.Data.SqlClient
```

Reemplace el WebMethod HelloWorld con el siguiente código Visual Basic o C#.

[WebMethod]
public DataSet  GetEmployeeManagers(String EmployeeID)
{
  Int32 val = Int32.Parse(EmployeeID);
  DataSet ds = new DataSet("Results");
  try
  {
    if (val < 1)
    val = 1;
    else if (val > 290) val = 290;
    SqlDataAdapter da = new 
SqlDataAdapter(@"uspGetEmployeeManagers " + val.ToString(),
  @"Data Source=localhost; Initial Catalog=AdventureWorks; " +
  @"Integrated Security=true");
  da.Fill(ds);
  }
  catch (Exception e)
  {
    throw;
  }
  return ds;
 }

<WebMethod()> _
Public Function GetEmployeeManagers(ByVal EmployeeID As String) As DataSet
  Dim ds As DataSet = New DataSet("Results")
  Try
    Dim val As Integer = Integer.Parse(EmployeeID)
    If (val < 1) Then
       val = 1
    ElseIf (val > 290) Then
       val = 290
    End If
    Dim da As SqlDataAdapter = _
        New SqlDataAdapter("uspGetEmployeeManagers " + _
         val.ToString(), _
       "Data Source=localhost; Initial Catalog=AdventureWorks; " + _
            "Integrated Security=true")
        da.Fill(ds)
    Catch e As Exception
    Throw
  End Try
  Return ds
End Function

En el menú Generar, haga clic en Generar sitio Web.
En el menú Generar, haga clic en Publicar sitio Web.

Para probar su servicio Web publicado (opcional)

Abra Internet Explorer.
En la barra Dirección, escriba la dirección URL del servicio Web.

Por ejemplo, https://localhost/XMLTutorial/Service.asmx.

Aparecerá la página predeterminada del servicio Web.
Haga clic en GetEmployeeManagersFromAdventureWorks.
Escriba un valor para EmployeeID entre 1 y 290.
Haga clic en Invocar.

El servicio Web recupera un conjunto de datos con los jefes de los empleados de la base de datos AdventureWorks mediante el uso del procedimiento almacenado uspGetEmployeeManagers.

[!NOTA] Si obtiene el mensaje "Se ha denegado el permiso de ejecución en el objeto", necesitará conceder el permiso de ejecución en el procedimiento almacenado de AdventureWorks para ASPNETUser, como se describe en el siguiente procedimiento.

Para conceder permisos de ejecución para el procedimiento almacenado (opcional)

Abra Microsoft SQL Server Management Studio.
Conéctese al Motor de base de datos en el que está instalado la base de datos de ejemplo AdventureWorks.
En el Explorador de objetos, expanda el nodo Bases de datos, el nodo AdventureWorks, el nodo Programación y, por último, el nodo Procedimientos almacenados.
Haga clic con el botón secundario en dbo.uspGetEmployeeManagers y seleccione Propiedades.
En el panel Seleccionar una página, haga clic en Permisos.
En el panel Usuarios o funciones, haga clic en el botón Agregar.
Haga clic en el botón Examinar. Seleccione [ASPNETUser].
Haga clic en Aceptar.

Ha agregado un permiso para ejecutar el procedimiento almacenado uspGetEmployeeManagers a todos aquellos que ejecutan ASP.NET .

Para definir un conjunto de datos de informe para el servicio Web

Inicie el Diseñador de informes y abra el proyecto del servidor de informes creado para este tutorial.
En la vista Datos, seleccione Nuevo conjunto de datos. Escriba un nombre para el conjunto de datos (por ejemplo, XMLWebDataSet).
En el cuadro de diálogo Conjunto de datos, en Origen de datos, seleccione Nuevo origen de datos. Aparecerá el cuadro de diálogo Origen de datos.
Escriba un nombre para el origen de datos (por ejemplo, XMLWebDataSource).
En Tipo, seleccione XML.
En Cadena de conexión, escriba la siguiente dirección URL del servicio Web del servidor de informes:

https://localhost/XMLTutorial/Service.asmx
En la ficha Credenciales, seleccione Utilizar autenticación de Windows (seguridad integrada).
Haga clic en Aceptar para guardar los cambios y cerrar el cuadro de diálogo Origen de datos.
En el menú Informe, haga clic en Parámetros del informe. Se abrirá el cuadro de diálogo Parámetros del informe.
Haga clic en Agregar.
En la sección Propiedades, en el cuadro de texto Nombre, escriba EmployeeID.
En el cuadro de texto Pedir datos, escriba Employee ID.
Haga clic en Aceptar.
En la ficha Datos, haga clic en el botón Editar el conjunto de datos seleccionado (…) en la barra de herramientas. Se abrirá el cuadro de diálogo Conjunto de datos.
Haga clic en la ficha Parámetros.
En la columna Nombre, escriba EmployeeID.
Haga clic en el cuadro de texto Valor para habilitar la lista desplegable y seleccione =Parameters!EmployeeID.Value. Esto asigna el parámetro del conjunto de datos al parámetro de informe.
Haga clic en Aceptar.

En el cuadro de diálogo Conjunto de datos, escriba la consulta siguiente usando la información de versión del espacio de nombres que comprobó en el paso 1:

<Query>
    <SoapAction>
        http://tempuri.org/GetEmployeeManagers
    </SoapAction>
    <Method Namespace="http://tempuri.org/" 
        Name="GetEmployeeManagers">
    </Method>
</Query>

Haga clic en el botón Ejecutar (!) en la barra de herramientas. Se abrirá el cuadro de diálogo Definir los parámetros de la consulta.
En la columna Valor de parámetro, escriba un valor para EmployeeID entre 1 y 290.
Haga clic en Aceptar. El conjunto de datos se agrega a la ventana Conjuntos de datos.
Examine el conjunto de resultados. De forma predeterminada, una consulta extrae datos de todos los atributos y elementos XML al nodo hoja en la primera ruta XML que encuentra en el conjunto de datos.
Pegue el siguiente elemento ElementPath en el panel Consulta inmediatamente después de la etiqueta <Consulta>.
```
<ElementPath IgnoreNamespaces="True">
    GetEmployeeManagersResponse {}/
    GetEmployeeManagersResult/diffgram{}/
    Results {}/Table 
</ElementPath>
```
Esto proporciona a la consulta una ruta de acceso de elemento al especificar los elementos que se utilizarán para recuperar datos del conjunto de resultados. En este caso, las llaves vacías ({}) a continuación de los nodos GetEmployeeManagersResponse, GetEmployeeManagersResult, diffgram y Results indican a la consulta que omita los datos de estos nodos. El nodo Tabla sin llaves indica a la consulta que recupere todos los nodos y atributos para ese nodo.

[!NOTA] Para especificar los elementos Table que se recuperarán para la colección de campos del conjunto de datos, enumérelos a continuación del elemento Table entre llaves, como se muestra en el siguiente ejemplo: Table {FirstName, LastName, EmployeeID, ManagerID, RecursionLevel}.
Haga clic en Ejecutar (!) para ver el conjunto de resultados. Los cambios realizados en el elemento ElementPath modifican el conjunto de resultados que devuelve la consulta.
Cuando esté satisfecho con el conjunto de resultados, haga clic en el botón Actualizar campos () en la barra de herramientas. De este modo se guarda la definición del informe y se actualiza la vista de los campos en la ventana Conjuntos de datos de informe para mostrar todos los campos que puede utilizar.

Pasos siguientes

Ha definido correctamente el conjunto de datos de informe a partir de un System.Data.DataSet object XML devuelto por un servicio Web. Cuando se procesa el informe, se recuperan los datos de cada elemento Table XML y sus atributos del servicio Web. A continuación creará un conjunto de datos de informe a partir de datos XML incrustados en el informe. Vea Lección 3: Definir un conjunto de datos de informe a partir de datos XML incrustados.

Vea también

Lección 2: Definir un conjunto de datos de informe para un conjunto de datos ADO.NET desde un servicio Web

Procedimientos

Pasos siguientes

Vea también

Conceptos

Otros recursos

Ayuda e información

Recursos adicionales