SOAP 웹 서비스 작업 사용 예
- 최종 업데이트2023/10/30
SOAP 웹 서비스 작업을 이용하여 두 개의 숫자 값을 전달하고 온라인 계산기 애플리케이션에서 합계를 반환합니다.
프로시저
SOAP 웹 서비스 호출을 수행하려면 다음 단계를 수행합니다.
- SOAP 웹 서비스 작업을 두 번 클릭하거나 끌어 놓습니다.
-
연결 방법 선택:
- URI를 사용하여 연결하려면 URI를 입력합니다(예:
http://www.dneonline.com/calculator.asmx?WSDL
). - 파일을 이용하여 연결하려면 Control Room 또는 바탕화면에서 파일을 선택하거나 변수를 삽입합니다.
- URI를 사용하여 연결하려면 URI를 입력합니다(예:
- 옵션:
주소 위치 필드에 SOAP 엔드포인트를 입력합니다.
주소 위치를 지정하면 실행 중에 봇이 이 위치를 사용합니다. 그렇지 않으면 봇은 WSDL 파일의 주소 위치를 사용합니다.
-
SOAP 요청 빌드를 클릭합니다.
작업과 매개변수에 대한 세부 정보와 함께 서비스와 포트를 표시하는 SOAP 요청 창이 나타납니다.
- SOAP 요청 창에서 포트 목록을 보려는 서비스를 확장합니다. 필요한 포트를 클릭하여 사용 가능한 작업 목록을 표시합니다. 필요한 작업을 선택하고 적용을 클릭하여 SOAP 요청에서 작업 세부정보를 검색합니다.
-
서비스 필드에 서비스 이름을 입력합니다.
이 필드는 웹 서비스에서 지원하는 포트 모음을 식별합니다. 여기에는
@SOAP 웹
서비스 호출에 대한 서비스 이름 값이 있습니다(예: Calculator). - 옵션:
포트 필드에 연결할 엔드포인트를 입력합니다.
포트를 지정하지 않으면 봇은 선택된 서비스를 기반으로 WSDL 파일에 나와 있는 첫 번째 포트를 사용합니다. 그러나 해당 포트가 SOAP 웹 서비스에서 지원되지 않는 경우 봇 실행이 실패합니다.이 필드에는
@SOAP 웹
서비스 호출에 대한 서비스 이름 값이 있습니다(예: CalculatorSoap). -
포트 필드에서 지정한 엔드포인트의 SOAP 버전을 선택합니다.
1.1 또는 1.2를 선택합니다.주: SOAP 버전 은 WSDL 파일에 지정된 다음 네임스페이스 중 하나를 사용하여 결정할 수 있습니다.
- SOAP 1.1 네임스페이스: http://schemas.xmlsoap.org/soap/envelope
- SOAP 1.2 네임스페이스: http://www.w3.org/2003/05/soap-envelope
-
작업 필드에서, 지정한 엔드포인트의 서비스 기능 이름을 포트 필드에 입력합니다.
다음 중 하나에 해당하면 봇 실행이 실패합니다.
- 포트 필드에 나와 있는 포트에 작업이 없습니다.
- 포트에 대한 SOAP 요청에 나와 있는 작업을 사용할 수 없습니다.
이 필드에는@SOAP 웹
서비스 호출에 대한 서비스 이름 값이 있습니다(예: Add). -
작업 매개변수 또는 원시 데이터 매개변수를 선택하여 매개변수 세부 정보를 제공합니다.
주: SOAP 요청 빌드를 선택한 경우 작업 탭의 매개변수 세부정보 테이블이 선택한 작업의 매개변수로 자동으로 채워집니다. 이러한 매개변수에 대한 값을 제공합니다. 특정 작업에 대한 매개변수를 추가, 편집 또는 삭제할 수 있습니다.
-
작업 매개변수를 선택한 경우, 각 매개변수의 이름과 값을 입력합니다. 예를 들어, 다음 값을 입력합니다.
- 첫 번째 이름 필드에 intA
- 첫 번째 값 필드에 10
- 두 번째 이름 필드에 intB
- 두 번째 값 필드에 20
- 원시 데이터 매개변수를 선택한 경우 매개변수 또는 자격증명 매개변수를 선택합니다.
-
작업 매개변수를 선택한 경우, 각 매개변수의 이름과 값을 입력합니다. 예를 들어, 다음 값을 입력합니다.
-
매개변수: 원시 데이터의 일반 텍스트로 자격증명(사용자 이름 또는 비밀번호)을 노출하지 않고 자격증명 보관함의 자격증명 값을 사용할 수 있습니다. 이렇게 하려면 먼저 자격증명 매퍼에서 자격증명을 매핑하고 중괄호 안에 있는 원시 데이터의 참조 이름을 사용해야 합니다.
예를 들어, 원시 데이터에서 서버에 인증하기 위해 비밀번호를 일반 텍스트로 제공했습니다.
<aut:AuthHeader> <aut:Password> abc@123</aut:Password> </aut:AuthHeader>
자격증명 보관함의 비밀번호를 사용하려면 다음 단계를 수행합니다.-
대체 추가를 클릭합니다.
XML 형식 이름 필드에 참조 이름(예: pwd)을 입력합니다. 자격증명을 선택하여 자격증명 저장소의 가용 값을 사용하거나, 변수를 선택하여 자격증명 변수를 사용하거나, 안전하지 않은 문자열을 선택하여 사용할 값을 수동으로 지정합니다.자격증명 저장소와 사용 방법에 대한 자세한 내용은 Credential Vault의 자격증명 및 로커 항목을 참조하십시오.
- 추가를 클릭합니다.
-
다음과 같이 중괄호 안에 원시 데이터의 참조를 지정합니다.
<aut:AuthHeader> <aut:Password>{{pwd}}</aut:Password> </aut:AuthHeader>
원시 데이터에 지정된 참조 이름pwd
는 자격증명 저장소에 저장된 해당 값을 대체합니다.대체 추가에 지정된 것과 동일한 형식으로 참조 이름을 입력해야 합니다. 예를 들어, 대체 추가에 pwd로 비밀번호를 입력하고 원시 데이터의 참조 이름으로password
를 입력한 경우 봇을 실행하면 봇에서 오류가 발생합니다.
-
대체 추가를 클릭합니다.
- 자격증명 매개변수: 원시 데이터 매개변수를 자격증명으로 입력하려는 경우. 자격증명을 선택하여 Credential Vault의 가용 값을 사용하거나 변수를 선택하여 자격증명 변수를 사용하거나, 안전하지 않은 문자열을 선택하여 사용할 값을 수동으로 지정할 수 있습니다.
-
인증 모드 목록에서 인증 없음 또는 기본을 선택합니다.
- 인증 없음을 선택한 경우 다음 단계로 진행합니다.
- 기본을 선택한 경우 자격증명을 입력합니다.
- 옵션: Control Room 또는 바탕화면에서 파일을 선택하여 클라이언트 인증서를 제공하거나 변수를 삽입합니다.
- 옵션: 맞춤형 헤더 제공.
- 옵션: XML 출력을 저장할 파일을 제공합니다.
-
전체 응답을 선택하거나 선택한 응답을 선택하여 응답의 범위를 좁힙니다.
- 전체 응답을 선택한 경우, 다음 단계로 진행합니다.
-
선택된 응답을 선택한다면,
XPath 빌드 옵션을 사용하지 않고 수동으로 Xpath 식을 생성하는 경우 다음 단계를 수행합니다.
- XPath 식을 제공합니다. 예시:
/*[local-name()='Envelope' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='Body' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='AddResponse' and namespace-uri()='http://tempuri.org/']/*[local-name()='AddResult' and namespace-uri()='http://tempuri.org/']
- XML 출력의 섹션을 선택합니다. 값, 내부 XML 또는 외부 XML을 선택합니다.
-
값 옵션을 선택한 경우 다음과 같이 반환 내용을 선택합니다. 다음으로 구분된 문자열 또는 문자열 목록.
-
다음으로 구분된 문자열을 선택한 경우, 구분 기호 옵션을 선택합니다. 파이프, 세미콜론 또는 사용자 지정.사용자 지정을 선택한 경우 사용자 지정 구분 기호(선택 사항) 필드에 변수 또는 문자를 입력하십시오.주: 구분 기호로 특수 문자 달러 기호($)는 지원되지 않습니다.
- SOAP 응답의 출력을 문자열 목록으로 반환하려면 문자열 목록을 선택합니다.주: 데이터 유형이 문자열인 목록 유형의 변수만 지정할 수 있습니다.
-
다음으로 구분된 문자열을 선택한 경우, 구분 기호 옵션을 선택합니다. 파이프, 세미콜론 또는 사용자 지정.
- XPath 식을 제공합니다. 예시:
-
Xpath 빌드를 클릭합니다.
출력 미리보기 창이 나타납니다.
-
응답 본문에서 적절한 노드를 선택합니다. XML 경로가 자동으로 생성됩니다. 적용을 클릭합니다.
Xpath 빌드 옵션을 사용하는 경우 XPath 식과 값 필드는 선택한 작업을 기반으로 하는 세부 정보로 자동으로 채워집니다.
- 옵션:
SOAP 요청을 보내고 응답을 받을 때 시간 초과 값을 설정하려면 작업이 완료될 때까지 대기 필드에 대기 시간(밀리초)을 지정합니다.
기본적으로 대기 시간은 60,000밀리초입니다.
-
P12 인증서를 구성합니다.
- SSL 인증 파일을 얻으려면 다음 옵션 중 하나를 선택합니다. Control Room 파일, 바탕화면 파일 또는 변수.
- 키 저장소 속성을 구성합니다.
- 키 저장소 파일(선택사항): 키 저장소 파일을 p12 형식으로 제공하려면 다음 옵션 중 하나를 선택합니다. Control Room 파일, 바탕화면 파일 또는 변수.. 키 저장소 파일에는 클라이언트의 개인 키와 인증서가 포함됩니다.
- 키 저장소 비밀번호(선택사항): 키 저장소 파일에 대한 암호를 제공하려면 다음 옵션 중 하나를 선택합니다. 자격증명, 변수 또는 안전하지 않은 문자열. 비밀번호는 키 저장소 파일에 액세스하는 데 사용됩니다.
-
XML 출력을 저장할 변수를 선택합니다.
예: prompt-assignment
-
본문 메시지에 prompt-assignment 변수가 있는 메시지 상자
작업을 삽입하여 SOAP 웹 서비스
작업의 출력을 확인합니다.
봇을 실행하면 메시지 상자에 30이 표시됩니다.