Занятие 2. Определение набора данных отчета для набора данных ADO.NET из веб-службы

Статья
12/15/2008

Добавления: 17 июля 2006 г.

На этом занятии создается соединение источника данных с веб-службой, возвращающей XML-объект System.Data.DataSet. Можно создать и развернуть веб-службу, которая возвращает XML-объект System.Data.DataSet, или использовать существующую доступную веб-службу. Указывается строка запроса, определяющая данные, которые необходимо получить для набора данных отчета из XML-объекта System.Data.DataSet, возвращаемого веб-службой.

В этом учебнике веб-служба получает сведения о сотруднике и менеджере с помощью вызова хранимой процедуры uspGetEmployeeManagers в образце базы данных AdventureWorks. Эта хранимая процедура принимает значение EmployeeID и формирует результирующий набор, который рекурсивно показывает связи сотрудник-менеджер вплоть до сотрудника высшего уровня.

Процедуры

Создание веб-службы, возвращающей набор данных ADO.NET (необязательно)

В среде Microsoft Visual Studio в меню Файл выберите пункт Создать, затем выберите Веб-узел.

Откроется диалоговое окно Создание веб-узла.

Примечание.
Если параметр Веб-узел не виден, проверьте требования в разделе Учебник. Использование XML-данных в отчете.

В области Шаблоны выберите Веб-служба ASP.NET.
В раскрывающемся списке Расположение выберите HTTP.
В раскрывающемся списке Язык выберите Visual Basic или C#.
Нажмите кнопку Обзор.

Откроется диалоговое окно Выбор расположения.
В области веб-узла Открыть веб-узел убедитесь, что выбран переключатель Локальные службы IIS.
В дереве веб-узла перейдите к родительской папке нового веб-узла.
Нажмите кнопку Создать веб-приложение.
Введите имя для веб-узла.
Нажмите кнопку Открыть.

Нажмите кнопку ОК.

Кодовая страница App_Code/Service для выбранного на шаге 4 языка откроется в среде Visual Studio, при этом будет показан образец WebMethod HelloWorld

Примечание.
Пространство имен по умолчанию — `http://tempuri.org/`. Это пространство имен будет использоваться в запросе, когда ниже будет определен набор данных отчета. Если изменить значение по умолчанию, придется изменить и запрос.

В начале исходного файла для Visual Basic или C# добавьте следующие две ссылки на пространство имен.
```
using System.Data;
using System.Data.SqlClient;
```
```
Imports System.Data
Imports System.Data.SqlClient
```

Замените HelloWorld WebMethod следующим кодом на Visual Basic или 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

В меню Построить выберите команду Построить веб-узел.
В меню Построить выберите команду Опубликовать веб-узел.

Проверка опубликованной веб-службы (необязательно)

Откройте обозреватель Internet Explorer.
В строке Адрес введите URL-адрес своей веб-службы.

Например: https://localhost/XMLTutorial/Service.asmx.

Откроется страница веб-службы по умолчанию.
Щелкните GetEmployeeManagersFromAdventureWorks.
Введите значение EmployeeID в диапазоне от 1 до 290.
Нажмите кнопку Вызвать.

Веб-служба получает набор данных, содержащий менеджеров из базы данных AdventureWorks с помощью хранимой процедуры uspGetEmployeeManagers.

Примечание.
Если появится сообщение «Разрешение "Выполнение" запрещено для объекта», то необходимо предоставить разрешение на выполнение хранимой процедуры AdventureWorks для пользователя ASPNETUser, как описывается в следующей процедуре.

Предоставление разрешения на выполнение хранимой процедуры (необязательно)

Откройте среду Microsoft SQL Server Management Studio.
Подключитесь к компоненту Database Engine, где установлен образец базы данных AdventureWorks.
В обозревателе объектов последовательно разверните узлы Базы данных, AdventureWorks, Программирование и Хранимые процедуры.
Щелкните правой кнопкой мыши dbo.uspGetEmployeeManagers и выберите Свойства.
В области Выбор страницы нажмите кнопку Разрешения.
Нажмите кнопку Добавить для области Пользователи или роли.
Нажмите кнопку Обзор. Выберите [ASPNETUser].
Нажмите кнопку ОК.

Было добавлено разрешение на выполнение хранимой процедуры uspGetEmployeeManagers для пользователя, запускающего ASP.NET.

Определение набора данных отчета для веб-службы

Запустите конструктор отчетов и откройте проект сервера отчетов, созданный в этом учебнике.
В представлении «Данные» выберите Новый набор данных. Введите имя набора данных (например XMLWebDataSet).
В диалоговом окне Набор данных в поле Источник данных выберите Создать источник данных. Откроется диалоговое окно Источник данных.
Введите имя источника данных (например XMLWebDataSource).
В пункте Тип выберите XML.
В поле Строка соединения введите следующий URL-адрес веб-службы сервера отчетов:

https://localhost/XMLTutorial/Service.asmx
На вкладке Учетные данные выберите Использовать встроенную проверку подлинности Windows.
Нажмите кнопку ОК для сохранения изменений и выхода из диалогового окна Источник данных.
В меню Отчет выберите команду Параметры отчета. Откроется диалоговое окно Параметры отчета.
Нажмите кнопку Добавить.
В разделе Свойства в текстовом поле Имя введите EmployeeID.
В текстовое поле Запрос введите Employee ID.
Нажмите кнопку «ОК».
На вкладке «Данные» нажмите кнопку «Изменить выбранный набор данных (...)» на панели инструментов. Откроется диалоговое окно «Набор данных».
Перейдите на вкладку «Параметры».
В столбце Имя введите EmployeeID.
Щелкните текстовое поле Значение, чтобы открыть раскрывающийся список, и выберите =Parameters!EmployeeID.Value. При этом параметр набора данных будет сопоставлен параметру отчета.
Нажмите кнопку «ОК».
В диалоговом окне Набор данных введите следующий запрос, используя сведения о версии пространства имен, которая была проверена на шаге 1:
```
<Query>
    <SoapAction>
        http://tempuri.org/GetEmployeeManagers
    </SoapAction>
    <Method Namespace="http://tempuri.org/" 
        Name="GetEmployeeManagers">
    </Method>
</Query>
```
Нажмите кнопку Выполнить (!) на панели инструментов. Откроется диалоговое окно Определение параметров запроса.
В столбце Значение параметра введите число EmployeeID в диапазоне от 1 до 290.
Нажмите кнопку ОК. Набор данных будет добавлен в окно «Наборы данных».
Просмотрите результирующий набор. По умолчанию запрос извлекает данные из элементов и атрибутов XML-данных по направлению к конечному узлу по первому XML-пути, найденному в наборе данных.

Вставьте следующий элемент ElementPath в область «Запрос» непосредственно после тега <Query>.

<ElementPath IgnoreNamespaces="True">
    GetEmployeeManagersResponse {}/
    GetEmployeeManagersResult/diffgram{}/
    Results {}/Table 
</ElementPath>

Это предоставляет запросу путь к элементу, который указывает, какие элементы использовать для получения данных в результирующий набор. В этом случае пустые скобки ({}) после узлов GetEmployeeManagersResponse, GetEmployeeManagersResult, diffgram и Results указывают запросу пропускать данные из этих узлов. Узел Table без скобок указывает запросу извлекать все узлы и атрибуты для этого узла.

Примечание.
Чтобы указать, какие элементы узла Table получать для коллекции полей набора данных, перечислите их после элемента Table внутри фигурных скобок, как показано в следующем примере: `Table {FirstName, LastName, EmployeeID, ManagerID, RecursionLevel}`.

Нажмите кнопку Выполнить (!) для просмотра результирующего набора. Изменения, сделанные в элементе ElementPath, изменяют результирующий набор, возвращаемый запросом.
Если вы удовлетворены результирующим набором, нажмите кнопку Обновить поля () на панели инструментов. Таким образом сохраняется определение отчета и обновляется представление полей в окне Наборы данных отчета, показывающем все доступные поля.

Следующие шаги

Был успешно определен набор данных отчета из XML-объекта System.Data.DataSet object, возвращаемого веб-службой. При обработке отчета данные каждого XML-элемента Table и его атрибутов извлекаются из веб-службы. Далее будет создан набор данных отчета из внедренного в отчет XML-документа. См. раздел Занятие 3. Определение набора данных отчета из внедренных XML-данных.

См. также

Поделиться через

Занятие 2. Определение набора данных отчета для набора данных ADO.NET из веб-службы

Процедуры

Следующие шаги

См. также

Основные понятия

Другие ресурсы

Справка и поддержка

Дополнительные ресурсы