웹 서비스 태스크Web Service Task

웹 서비스 태스크는 웹 서비스 메서드를 실행합니다.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(Web Service Description Language) 파일로 연결할 수 있습니다.The HTTP connection manager can point to a Web site or to a Web Service Description Language (WSDL) file. WSDL 파일로 연결하는 HTTP 연결 관리자의 URL에는 ?WSDL 매개 변수가 포함됩니다(예: http://MyServer/MyWebService/MyPage.asmx?WSDL).The URL of the HTTP connection manager that points to a WSDL file includes the ?WSDL parameter: for example, http://MyServer/MyWebService/MyPage.asmx?WSDL.

디자이너에서 제공하는 웹 서비스 태스크 편집기 SSISSSIS 대화 상자를 사용하여 웹 서비스 태스크를 구성하려면 WSDL 파일을 로컬에서 사용할 수 있어야 합니다.The WSDL file must be available locally to configure the Web Service task using the Web Service Task Editor dialog box that SSISSSIS 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 DescriptionDescription
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

SSISSSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.You can set properties through SSISSSIS Designer or programmatically.

SSISSSIS 디자이너에서 설정할 수 있는 속성에 대한 자세한 내용을 보려면 다음 항목을 클릭하십시오.For more information about the properties that you can set in SSISSSIS 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
목록에서 연결 관리자를 선택 하거나 클릭 < 새 연결... > 새 연결 관리자를 만듭니다.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.

DescriptionDescription
웹 서비스 태스크에 대한 설명을 입력합니다.Type a description of the Web Service task.

WSDL 다운로드Download 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.

참고

웹 서비스 태스크는 정수 및 문자열과 같은 기본 형식, 기본 형식의 배열 및 시퀀스, 열거 등과 같은 데이터 형식의 매개 변수만 지원합니다.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.

ValueValue
Variable 확인란이 선택된 경우 목록에서 변수를 선택하여 입력을 제공하고 선택되지 않은 경우 입력에 사용할 값을 입력합니다.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.

ValueValue DescriptionDescription
파일 연결File Connection 결과를 파일에 저장합니다.Store the results in a file. 이 값을 선택하면 동적 옵션 File이 표시됩니다.Selecting this value displays the dynamic option, File.
변수Variable 결과를 변수에 저장합니다.Store the results in a variable. 이 값을 선택하면 동적 옵션 Variable이 표시됩니다.Selecting this value displays the dynamic option, Variable.

OutputType 동적 옵션OutputType Dynamic Options

OutputType = 파일 연결OutputType = File Connection

파일File
목록에서 파일 연결 관리자를 선택 하거나 클릭 < 새 연결... > 새 연결 관리자를 만듭니다.Select a File connection manager in the list or click <New Connection…> to create a new connection manager.

관련 항목: File Connection Manager, File Connection Manager EditorRelated Topics: File Connection Manager, File Connection Manager Editor

OutputType = 변수OutputType = Variable

변수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

technet.microsoft.com의 비디오, How to: Call a Web Service by Using the Web Service Task (SQL Server Video)(방법: 웹 서비스 태스크를 사용하여 웹 서비스 호출(SQL Server 비디오))Video, How to: Call a Web Service by Using the Web Service Task (SQL Server Video), on technet.microsoft.com.