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

  • Статья

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

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

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

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

WSDL-файл

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

Важно!

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

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

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

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

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

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

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

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

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

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

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

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

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

Значения свойств можно задавать с помощью конструктора Integration Services или программными средствами.

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

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

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

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

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

Страница Общие в диалоговом окне Редактор задачи "Веб-служба" применяется для указания диспетчера 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.

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

Примечание

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

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

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

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

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

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

Параметры

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

См. также:File Connection Manager, File Connection Manager Editor

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

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

См. также:Переменные Integration Services (SSIS), Добавление переменной

См. также

Видео с руководством по вызвать веб-службу с помощью задачи "Веб-служба" (видеоматериал по SQL Server) на портале technet.microsoft.com.