Задача «Веб-служба»

Изменения: 17 июля 2006 г.

Задача «Веб-служба» выполняет метод веб-службы. Возможно использование задачи «Веб-служба» в следующих целях:

• Запись в переменную значений, возвращаемых методом веб-службы. Например, можно получить самую высокую температуру дня из метода веб-службы с последующим использованием ее значения для обновления переменной, которая используется в выражении, задающем значение столбца.
• Запись в файл значений, возвращаемых методом веб-службы. Например, список потенциальных покупателей может быть записан в файл, который затем используется в качестве источника данных в пакете, очищающем данные перед их занесением в базу данных.

Для подключения к веб-службе задача «Веб-служба» использует диспетчер HTTP-сеансов. Диспетчер HTTP-сеансов сконфигурирован отдельно от задачи «Веб-служба», ссылка на него содержится в задаче. Диспетчер HTTP-сеансов указывает настройки прокси-сервера, такие как URL-адрес сервера, учетные записи для доступа к веб-службе и длительность времени ожидания. Дополнительные сведения см. в разделе Диспетчер HTTP-соединений.

Диспетчер HTTP-сеансов может указывать на веб-узел или на файл языка описания веб-служб (язык WSDL). URL-адрес диспетчера HTTP-сеансов, указывающий на WSDL-файл, содержит параметр ?WSDL, например http://MyServer/MyWebService/MyPage.asmx?WSDL.

Чтобы настроить задачу «Веб-служба», используя диалоговое окно Редактор задачи «Веб-служба», которое предоставляет конструктор SSIS, WSDL-файл должен быть доступен локально.

• Если диспетчер HTTP-сеансов указывает на веб-узел, то WSDL-файл должен быть скопирован на локальный компьютер вручную.
• Если диспетчер HTTP-сеансов указывает на WSDL-файл, то файл можно сделать локальным, загрузив его с веб-узла при помощи задачи «Веб-служба».

WSDL-файл перечисляет методы, предлагаемые веб-службой; входные параметры, запрашиваемые методами; ответы, возвращаемые методами; а также метод обмена данными с веб-службой.

Если метод использует входные параметры, то задача «Веб-служба» запрашивает значения параметров. Например, метод веб-службы рекомендует длину приобретаемых лыж, основываясь на росте покупателя, поэтому требует, чтобы рост был записан во входном параметре. Значения параметра можно задать строками, определенными в задаче, или переменными, определенными в области видимости задачи или родительского контейнера. Преимущество использования переменных в том, что они позволяют динамически обновлять значения параметров с помощью конфигураций пакетов или сценариев. Дополнительные сведения см. в разделах Переменные служб Integration Services и Конфигурации пакета.

Примечание.
Задача «Веб-служба» поддерживает только параметры следующих типов данных: примитивные типы, такие как integer и string, массивы и последовательности примитивных типов, а также перечисления.

Многие методы веб-службы не используют входные параметры. Например, метод веб-службы, выдающий имена сотрудников, рожденных в текущем месяце, не запрашивает входного параметра, потому что веб-служба может определить текущий месяц локально.

Результаты метода веб-службы могут быть записаны в переменную или в файл. Используйте диспетчер подключений файла для указания файла или для указания имени переменной, в которую записывается результат. Дополнительные сведения см. в разделах Диспетчер подключения файлов и Переменные служб Integration Services.

Пользовательские сообщения для ведения журнала, доступные в задаче «Веб-служба»

В следующей таблице перечислены пользовательские записи в журнале для задачи «Веб-служба». Дополнительные сведения см. в разделах Реализация ведения журналов в пакетах и Пользовательские сообщения для ведения журнала.

Запись журнала	Описание
WSTaskBegin	Задача получила доступ к веб-службе.
WSTaskEnd	Задача завершила метод веб-службы.
WSTaskInfo	Описательные сведения об этой задаче.

Настройка задачи «Веб-служба»

Свойства задаются через конструктор служб SSIS или программно.

Дополнительные сведения о свойствах, которые можно задать в конструкторе служб SSIS, см. в следующих разделах:

• Редактор задачи «Веб-служба» (страница «Общие»)
• Редактор задачи «Веб-служба» (страница «Вход»)
• Редактор задачи «Веб-служба» (страница «Вывод»)
• Страница «Выражения»

Дополнительные сведения об установке этих свойств в конструкторе служб SSIS см. в следующем разделе:

• Как установить свойства задачи

Настройка задачи «Веб-служба» программно

Дополнительные сведения о программной установке этих свойств см. в следующих разделах:

• WebServiceTask

См. также

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

Задачи служб Integration Services
Создание пакета потока управления

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

Получение помощи по SQL Server 2005

Журнал изменений

Версия	Журнал
17 июля 2006 г.	Изменения Добавлена таблица пользовательских записей журнала.
14 апреля 2006 г.	Изменения Добавлены сведения об использовании переменных для указания значений входных параметров для веб-метода.