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

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

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

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

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

WSDL-файл

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

Внимание

Диспетчер HTTP-соединений поддерживает только анонимную проверку подлинности и обычную проверку подлинности. Проверка подлинности Windows не поддерживается.

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

Файл WSDL должен быть доступен локально для настройки задачи веб-службы с помощью диалогового окна редактора задач веб-службы, которое предоставляет конструктор служб SSIS.

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

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

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

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

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

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

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

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

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

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

Свойства могут быть заданы с помощью конструктора SSIS или программным путем.

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

• Страница «Выражения»

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

• Задание свойств задач или контейнеров

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

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

• WebServiceTask

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

Страница Общие в диалоговом окне Редактор задачи "Веб-служба" применяется для указания диспетчера HTTP-соединений, расположения файла WSDL, используемого задачей веб-службы, описания задачи веб-службы и загрузки файла WSDL.

Параметры

HTTPConnection
Выберите диспетчер подключений в списке или щелкните <Создать подключение...>, чтобы создать новый диспетчер подключений.

Внимание

Диспетчер HTTP-соединений поддерживает только анонимную проверку подлинности и обычную проверку подлинности. Проверка подлинности Windows не поддерживается.

Связанные разделы:HTTP диспетчер подключений, редактор HTTP диспетчер подключений (страница сервера)

WSDLFile
Введите полный путь к локальному WSDL-файлу на компьютере или нажмите кнопку обзора (...) и выберите файл.

Если WSDL-файл был загружен на компьютер вручную, выберите этот файл. Однако, если WSDL-файл еще не был загружен, выполните следующие действия.

• Создайте пустой файл с расширением WSDL.

• Выберите этот пустой файл для параметра WSDLFile .

• Установите свойство OverwriteWSDLFile в значение True , чтобы разрешить перезапись пустого файла фактическим WSDL-файлом.

• Нажмите кнопку Загрузить язык WSDL , чтобы загрузить фактический WSDL-файл и перезаписать пустой файл.

  Примечание.

  Кнопка Загрузить язык WSDL недоступна, пока не указано имя существующего локального файла в поле WSDLFile .

OverwriteWSDLFile
Укажите, можно ли перезаписать WSDL-файл для задачи веб-службы.

Если нужно загрузить WSDL-файл с помощью кнопки Загрузить язык WSDL , установите это свойство в значение True.

Имя
Введите уникальное имя задачи веб-службы. Это имя используется в качестве метки для значка задачи.

Примечание.

Имена задач в пределах пакета должны быть уникальными.

Description
Введите описание задачи веб-службы.

Загрузить язык WSDL
Загрузите файл WSDL.

Эта кнопка недоступна, пока не указано имя существующего локального файла в поле WSDLFile .

Редактор задачи «Веб-служба» (страница «Вход»)

Используйте страницу Вход в диалоговом окне Редактор задачи «Веб-служба» , чтобы указать веб-службу, веб-метод и значения, предоставляемые в качестве входных данных веб-метода. Значения можно предоставить, либо непосредственно введя строки в столбце «Значение», либо выбрав переменные в столбце «Значение».

Параметры

Служба
Чтобы выполнить веб-метод, выберите веб-службу из списка.

Method
Чтобы выполнить задачу, выберите веб-метод из списка.

WebMethodDocumentation
Введите описание веб-метода или нажмите кнопку обзора (...), а затем введите описание в диалоговом окне Документация веб-метода.

Имя
Перечисляет имена входных данных веб-метода.

Тип
Перечисляет тип входных данных.

Примечание.

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

Переменная
Установите флажки, чтобы использовать переменные для входных данных.

Value
Если установлены флажки «Переменная», выберите переменные из списка для входных данных; в противном случае введите значения входных данных вручную.

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

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

Статические параметры

OutputType
Выберите тип хранения, используемый для хранения результатов. Это свойство имеет параметры, указанные в следующей таблице.

значение	Описание
Соединение с файлом	Хранить результаты в файле. При выборе этого значения отображается динамический параметр Файл.
Переменная	Хранить результаты в переменной. При выборе этого значения отображается динамический параметр Переменная.

Динамические параметры OutputType

OutputType = Соединение с файлом

Файл
Выберите диспетчер подключений файлов в списке или щелкните <Создать подключение...>, чтобы создать новый диспетчер подключений.

Связанные разделы: диспетчер подключений файлов, редактор диспетчер подключений файлов

OutputType = Переменная

Переменная
Выберите переменную в списке или щелкните <Создать переменную...>, чтобы создать ее.

Связанные разделы:Переменные служб Integration Services (SSIS), добавление переменной

См. также

Видео How to: Call a Web Service by Using the Web Service Task (SQL Server Video)(Как вызвать веб-службы с помощью задачи "Веб-служба" — видеоматериал SQL Server) на technet.microsoft.com.