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

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) да Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factoryyes Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data FactoryПрименимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) да Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factoryyes Azure-SSIS Integration Runtime в Фабрике данных AzureSSIS Integration Runtime in Azure Data Factory

Задача «Веб-служба» выполняет метод веб-службы.The Web Service task executes a Web service method. Возможно использование задачи «Веб-служба» в следующих целях:You can use the Web Service task for the following purposes:

  • Запись в переменную значений, возвращаемых методом веб-службы.Writing to a variable the values that a Web service method returns. Например, можно получить самую высокую температуру дня из метода веб-службы с последующим использованием ее значения для обновления переменной, которая используется в выражении, задающем значение столбца.For example, you could obtain the highest temperature of the day from a Web service method, and then use that value to update a variable that is used in an expression that sets a column value.

  • Запись в файл значений, возвращаемых методом веб-службы.Writing to a file the values that a Web service method returns. Например, список потенциальных покупателей может быть записан в файл, который затем используется в качестве источника данных в пакете, очищающем данные перед их занесением в базу данных.For example, a list of potential customers can be written to a file and the file then used as a data source in a package that cleans the data before it is written to a database.

WSDL-файлWSDL File

Для подключения к веб-службе задача «Веб-служба» использует диспетчер HTTP-соединений.The Web Service task uses an HTTP connection manager to connect to the Web service. Редактор диспетчера HTTP-соединений сконфигурирован отдельно от задачи «Веб-служба», ссылка на него содержится в задаче.The HTTP connection manager is configured separately from the Web Service task, and is referenced in the task. Диспетчер HTTP-соединений указывает настройки прокси-сервера, такие как URL-адрес сервера, учетные записи для доступа к веб-службе и длительность времени ожидания.The HTTP connection manager specifies the server proxy settings such as the server URL, credentials for accessing the Web services server, and time-out length. Дополнительные сведения см. в статье Диспетчер HTTP-соединений.For more information, see HTTP Connection Manager.

Важно!

Диспетчер HTTP-соединений поддерживает только анонимную проверку подлинности и обычную проверку подлинности.The HTTP connection manager supports only anonymous authentication and basic authentication. Проверка подлинности Windows не поддерживается.It does not support Windows Authentication.

Диспетчер HTTP-соединений может указывать на веб-сайт или на файл языка описания веб-служб (язык WSDL).The HTTP connection manager can point to a Web site or to a Web Service Description Language (WSDL) file. URL-адрес диспетчера HTTP-подключений, указывающий на WSDL-файл, содержит параметр ?WSDL , например https://MyServer/MyWebService/MyPage.asmx?WSDL.The URL of the HTTP connection manager that points to a WSDL file includes the ?WSDL parameter: for example, https://MyServer/MyWebService/MyPage.asmx?WSDL.

Чтобы настроить задачу «Веб-служба», используя диалоговое окно Редактор задачи «Веб-служба» , которое предоставляет конструктор Integration ServicesSSIS , WSDL-файл должен быть доступен локально.The WSDL file must be available locally to configure the Web Service task using the Web Service Task Editor dialog box that Integration ServicesSSIS Designer provides.

  • Если диспетчер HTTP-соединений указывает на веб-сайт, то WSDL-файл должен быть скопирован на локальный компьютер вручную.If the HTTP connection manager points to a Web site, the WSDL file must be copied manually to a local computer.

  • Если диспетчер HTTP-соединений указывает на WSDL-файл, то файл можно сделать локальным, загрузив его с веб-сайта при помощи задачи «Веб-служба».If the HTTP connection manager points to a WSDL file, the file can be downloaded from the Web site to a local file by the Web Service task.

WSDL-файл перечисляет методы, предлагаемые веб-службой; входные параметры, запрашиваемые методами; ответы, возвращаемые методами; а также метод обмена данными с веб-службой.The WSDL file lists the methods that the Web service offers, the input parameters that the methods require, the responses that the methods return, and how to communicate with the Web service.

Если метод использует входные параметры, то задача «Веб-служба» запрашивает значения параметров.If the method uses input parameters, the Web Service task requires parameter values. Например, метод веб-службы рекомендует длину приобретаемых лыж, основываясь на росте покупателя, поэтому требует, чтобы рост был записан во входном параметре.For example, a Web service method that recommends the length of skis you should purchase based on your height requires that your height be submitted in an input parameter. Значения параметра можно задать строками, определенными в задаче, или переменными, определенными в области видимости задачи или родительского контейнера.The parameter values can be provided either by strings that are defined in the task, or by variables defined in the scope of the task or a parent container. Преимущество использования переменных в том, что они позволяют динамически обновлять значения параметров с помощью конфигураций пакетов или скриптов.The advantage of using variables is that they let you dynamically update the parameter values by using package configurations or scripts. Дополнительные сведения см. в разделах Переменные в службах Integration Services (SSIS) и Конфигурации пакета.For more information, see Integration Services (SSIS) Variables and Package Configurations.

Многие методы веб-службы не используют входные параметры.Many Web service methods do not use input parameters. Например, метод веб-службы, выдающий имена сотрудников, рожденных в текущем месяце, не запрашивает входного параметра, потому что веб-служба может определить текущий месяц локально.For example, a Web service method that gets the names of presidents who were born in the current month would not require an input parameter because the Web service can determine the current month locally.

Результаты метода веб-службы могут быть записаны в переменную или в файл.The results of the Web service method can be written to a variable or to a file. Используйте диспетчер подключений файла для указания файла или для указания имени переменной, в которую записывается результат.You use the File connection manager either to specify the file or to provide the name of the variable to write the results to. Дополнительные сведения см. в разделах Диспетчер соединения файлов и Переменные в службах Integration Services (SSIS).For more information, see File Connection Manager and Integration Services (SSIS) Variables.

Пользовательские сообщения для ведения журнала, доступные в задаче «Веб-служба»Custom Logging Messages Available on the Web Service Task

В следующей таблице перечислены пользовательские записи в журнале для задачи «Веб-служба».The following table lists the custom log entries that you can enable for the Web Service task. Дополнительные сведения см. в разделе Ведение журналов в службах Integration Services (SSIS).For more information, see Integration Services (SSIS) Logging.

Запись журналаLog entry ОписаниеDescription
WSTaskBeginWSTaskBegin Задача получила доступ к веб-службе.The task began to access a Web service.
WSTaskEndWSTaskEnd Задача завершила метод веб-службы.The task completed a Web service method.
WSTaskInfoWSTaskInfo Описательные сведения об этой задаче.Descriptive information about the task.

Настройка задачи «Веб-служба»Configuration of the Web Service Task

Значения свойств можно задавать с помощью конструктора Integration ServicesSSIS или программными средствами.You can set properties through Integration ServicesSSIS Designer or programmatically.

Дополнительные сведения о свойствах, которые можно задать в конструкторе служб Integration ServicesSSIS , см. в следующем разделе:For more information about the properties that you can set in Integration ServicesSSIS Designer, click the following topic:

Дополнительные сведения об установке этих свойств в конструкторе служб Integration ServicesSSIS см. в следующем разделе:For more information about how to set these properties in Integration ServicesSSIS Designer, click the following topic:

Программная настройка задачи «Веб-служба»Programmatic Configuration of the Web Service Task

Дополнительные сведения о программной настройке этих свойств см. в следующих разделах:For more information about programmatically setting these properties, click one of the following topics:

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

Страница Общие в диалоговом окне Редактор задачи "Веб-служба" применяется для указания диспетчера HTTP-соединений, расположения файла WSDL, используемого задачей веб-службы, описания задачи веб-службы и загрузки файла WSDL.Use the General page of the Web Services Task Editor dialog box to specify an HTTP connection manager, specify the location of the Web Services Description Language (WSDL) file the Web Service task uses, describe the Web Services task, and download the WSDL file.

ПараметрыOptions

HTTPConnectionHTTPConnection
Выберите из списка диспетчер подключений или нажмите кнопку <New connection...> для создания нового диспетчера подключений.Select a connection manager in the list, or click <New connection...> to create a new connection manager.

Важно!

Диспетчер HTTP-соединений поддерживает только анонимную проверку подлинности и обычную проверку подлинности.The HTTP connection manager supports only anonymous authentication and basic authentication. Проверка подлинности Windows не поддерживается.It does not support Windows Authentication.

См. также: подробные сведения о диспетчере HTTP-подключений и о редакторе диспетчера HTTP-подключений (страница "Сервер").Related Topics: HTTP Connection Manager, HTTP Connection Manager Editor (Server Page)

WSDLFileWSDLFile
Введите полный путь к локальному WSDL-файлу на компьютере или нажмите кнопку обзора (...) и выберите файл.Type the fully qualified path of a WSDL file that is local to the computer, or click the browse button (...) and locate this file.

Если WSDL-файл был загружен на компьютер вручную, выберите этот файл.If you have already manually downloaded the WSDL file to the computer, select this file. Однако, если WSDL-файл еще не был загружен, выполните следующие действия.However, if the WSDL file has not yet been downloaded, follow these steps:

  • Создайте пустой файл с расширением WSDL.Create an empty file that has the ".wsdl" file name extension.

  • Выберите этот пустой файл для параметра WSDLFile .Select this empty file for the WSDLFile option.

  • Установите свойство OverwriteWSDLFile в значение True , чтобы разрешить перезапись пустого файла фактическим WSDL-файлом.Set the value of OverwriteWSDLFile to True to enable the empty file to be overwritten with the actual WSDL file.

  • Нажмите кнопку Загрузить язык WSDL , чтобы загрузить фактический WSDL-файл и перезаписать пустой файл.Click Download WSDL to download the actual WSDL file and overwrite the empty file.

    Примечание

    Кнопка Загрузить язык WSDL недоступна, пока не указано имя существующего локального файла в поле WSDLFile .The Download WSDL option is not enabled until you provide the name of an existing local file in the WSDLFile box.

OverwriteWSDLFileOverwriteWSDLFile
Укажите, можно ли перезаписать WSDL-файл для задачи веб-службы.Indicate whether the WSDL file for the Web Service task can be overwritten.

Если нужно загрузить WSDL-файл с помощью кнопки Загрузить язык WSDL , установите это свойство в значение True.If you intend to download the WSDL file by using the Download WSDL button, set this value to True.

имя;Name
Введите уникальное имя задачи веб-службы.Provide a unique name for the Web Service task. Это имя используется в качестве метки для значка задачи.This name is used as the label in the task icon.

Примечание

Имена задач в пределах пакета должны быть уникальными.Task names must be unique within a package.

ОписаниеDescription
Введите описание задачи веб-службы.Type a description of the Web Service task.

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

Эта кнопка недоступна, пока не указано имя существующего локального файла в поле WSDLFile .This button is not enabled until you provide the name of an existing local file in the WSDLFile box.

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

Используйте страницу Вход в диалоговом окне Редактор задачи «Веб-служба» , чтобы указать веб-службу, веб-метод и значения, предоставляемые в качестве входных данных веб-метода.Use the Input page of the Web Service Task Editor dialog box to specify the Web Service, the Web method, and the values to provide to the Web method as input. Значения можно предоставить, либо непосредственно введя строки в столбце «Значение», либо выбрав переменные в столбце «Значение».The values can be provided either by typing strings directly in the Value column, or by selecting variables in the Value column.

ПараметрыOptions

СлужбаService
Чтобы выполнить веб-метод, выберите веб-службу из списка.Select a Web service from the list to use to execute the Web method.

МетодMethod
Чтобы выполнить задачу, выберите веб-метод из списка.Select a Web method from the list for the task to execute.

WebMethodDocumentationWebMethodDocumentation
Введите описание веб-метода или нажмите кнопку обзора (...) , а затем введите описание в диалоговом окне Документация веб-метода.Type a description of Web method, or the click the browse button (...) and then type the description in the Web Method Documentation dialog box.

имя;Name
Перечисляет имена входных данных веб-метода.Lists the names of the inputs to the Web method.

ТипType
Перечисляет тип входных данных.Lists the data type of the inputs.

Примечание

Задача «Веб-служба» поддерживает только параметры следующих типов данных: типы-примитивы, такие как integer и string, массивы и последовательности типов-примитивов, а также перечисления.The Web Service task supports parameters of the following data types only: primitive types such as integers and strings; arrays and sequences of primitive types; and enumerations.

ПеременнаяVariable
Установите флажки, чтобы использовать переменные для входных данных.Select the check boxes to use variables to provide inputs.

ЗначениеValue
Если установлены флажки «Переменная», выберите переменные из списка для входных данных; в противном случае введите значения входных данных вручную.If the Variable check-boxes are selected, select the variables in the list to provide the inputs; otherwise, type the values to use in the inputs.

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

Используйте страницу Вывод диалогового окна Редактор задачи «Веб-служба» , чтобы указать, где следует хранить результаты, возвращенные веб-методом.Use the Output page of the Web Service Task Editor dialog box to specify where to store the result returned by the Web method.

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

OutputTypeOutputType
Выберите тип хранения, используемый для хранения результатов.Select the storage type to use when storing the results. Это свойство имеет параметры, указанные в следующей таблице.This property has the options listed in the following table.

ЗначениеValue ОписаниеDescription
Соединение с файломFile Connection Хранить результаты в файле.Store the results in a file. При выборе этого значения отображается динамический параметр Файл.Selecting this value displays the dynamic option, File.
ПеременнаяVariable Хранить результаты в переменной.Store the results in a variable. При выборе этого значения отображается динамический параметр Переменная.Selecting this value displays the dynamic option, Variable.

Динамические параметры OutputTypeOutputType Dynamic Options

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

ФайлFile
Выберите в списке диспетчер подключений файлов или щелкните <New Connection...>, чтобы создать диспетчер подключений.Select a File connection manager in the list or click <New Connection...> to create a new connection manager.

См. также: подробные сведения о диспетчере файловых подключений и о редакторе диспетчера файловых подключений.Related Topics: File Connection Manager, File Connection Manager Editor

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

ПеременнаяVariable
Выберите переменную в списке или щелкните <New Variable...> для создания переменной.Select a variable in the list or click <New Variable...> to create a new variable.

См. также: подробные сведения о переменных в службах Integration Services (SSIS) и о добавлении переменной.Related Topics: Integration Services (SSIS) Variables, Add Variable

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