SOAP 웹 서비스 작업 사용 예

SOAP 웹 서비스 작업을 이용하여 두 개의 숫자 값을 전달하고 온라인 계산기 애플리케이션에서 합계를 반환합니다.

프로시저

SOAP 웹 서비스 호출을 수행하려면 다음 단계를 수행합니다.

  1. SOAP 웹 서비스 작업을 두 번 클릭하거나 끌어 놓습니다.
  2. 연결 방법 선택:
    • URI를 사용하여 연결하려면 URI를 입력합니다(예: http://www.dneonline.com/calculator.asmx?WSDL ).
    • 파일을 이용하여 연결하려면 Control Room 또는 바탕화면에서 파일을 선택하거나 변수를 삽입합니다.
  3. 옵션: 주소 위치 필드에 SOAP 엔드포인트를 입력합니다.
    주소 위치를 지정하면 실행 중에 봇이 이 위치를 사용합니다. 그렇지 않으면 봇은 WSDL 파일의 주소 위치를 사용합니다.
    주: SOAP URI를 수동으로 생성하고 SOAP 요청 빌드 옵션을 사용하지 않는 경우 단계로 이동합니다.
  4. SOAP 요청 빌드를 클릭합니다.
    작업과 매개변수에 대한 세부 정보와 함께 서비스와 포트를 표시하는 SOAP 요청 창이 나타납니다.
  5. SOAP 요청 창에서 포트 목록을 보려는 서비스를 확장합니다. 필요한 포트를 클릭하여 사용 가능한 작업 목록을 표시합니다. 필요한 작업을 선택하고 적용을 클릭하여 SOAP 요청에서 작업 세부정보를 검색합니다.
    SOAP 요청 빌드 옵션을 사용하는 경우 서비스, 포트, 작업, 작업 매개변수 필드는 선택한 작업을 기반으로 하는 세부 정보로 자동으로 채워집니다. 단계로 이동합니다.
  6. 서비스 필드에 서비스 이름을 입력합니다.
    이 필드는 웹 서비스에서 지원하는 포트 모음을 식별합니다. 여기에는@SOAP 웹서비스 호출에 대한 서비스 이름 값이 있습니다(예: Calculator).
  7. 옵션: 포트 필드에 연결할 엔드포인트를 입력합니다.
    포트를 지정하지 않으면 봇은 선택된 서비스를 기반으로 WSDL 파일에 나와 있는 첫 번째 포트를 사용합니다. 그러나 해당 포트가 SOAP 웹 서비스에서 지원되지 않는 경우 봇 실행이 실패합니다.
    이 필드에는@SOAP 웹서비스 호출에 대한 서비스 이름 값이 있습니다(예: CalculatorSoap).
  8. 포트 필드에서 지정한 엔드포인트의 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
  9. 작업 필드에서, 지정한 엔드포인트의 서비스 기능 이름을 포트 필드에 입력합니다.
    다음 중 하나에 해당하면 봇 실행이 실패합니다.
    • 포트 필드에 나와 있는 포트에 작업이 없습니다.
    • 포트에 대한 SOAP 요청에 나와 있는 작업을 사용할 수 없습니다.
    이 필드에는@SOAP 웹서비스 호출에 대한 서비스 이름 값이 있습니다(예: Add).
  10. 작업 매개변수 또는 원시 데이터 매개변수를 선택하여 매개변수 세부 정보를 제공합니다.
    주: SOAP 요청 빌드를 선택한 경우 작업 탭의 매개변수 세부정보 테이블이 선택한 작업의 매개변수로 자동으로 채워집니다. 이러한 매개변수에 대한 값을 제공합니다. 특정 작업에 대한 매개변수를 추가, 편집 또는 삭제할 수 있습니다.
    • 작업 매개변수를 선택한 경우, 각 매개변수의 이름과 값을 입력합니다. 예를 들어, 다음 값을 입력합니다.
      1. 첫 번째 이름 필드에 intA
      2. 첫 번째 값 필드에 10
      3. 두 번째 이름 필드에 intB
      4. 두 번째 값 필드에 20
    • 원시 데이터 매개변수를 선택한 경우 매개변수 또는 자격증명 매개변수를 선택합니다.
  11. 매개변수: 원시 데이터의 일반 텍스트로 자격증명(사용자 이름 또는 비밀번호)을 노출하지 않고 자격증명 보관함의 자격증명 값을 사용할 수 있습니다. 이렇게 하려면 먼저 자격증명 매퍼에서 자격증명을 매핑하고 중괄호 안에 있는 원시 데이터의 참조 이름을 사용해야 합니다.

    예를 들어, 원시 데이터에서 서버에 인증하기 위해 비밀번호를 일반 텍스트로 제공했습니다.

    <aut:AuthHeader>
<aut:Password> abc@123</aut:Password>
</aut:AuthHeader>
    자격증명 보관함의 비밀번호를 사용하려면 다음 단계를 수행합니다.
    1. 대체 추가를 클릭합니다.
      XML 형식 이름 필드에 참조 이름(예: pwd)을 입력합니다. 자격증명을 선택하여 자격증명 저장소의 가용 값을 사용하거나, 변수를 선택하여 자격증명 변수를 사용하거나, 안전하지 않은 문자열을 선택하여 사용할 값을 수동으로 지정합니다.
      자격증명 저장소와 사용 방법에 대한 자세한 내용은 Credential Vault의 자격증명 및 로커 항목을 참조하십시오.
    2. 추가를 클릭합니다.
    3. 다음과 같이 중괄호 안에 원시 데이터의 참조를 지정합니다. 
      <aut:AuthHeader>
<aut:Password>{{pwd}}</aut:Password>
</aut:AuthHeader>
      원시 데이터에 지정된 참조 이름 pwd는 자격증명 저장소에 저장된 해당 값을 대체합니다.
      대체 추가에 지정된 것과 동일한 형식으로 참조 이름을 입력해야 합니다. 예를 들어, 대체 추가에 pwd로 비밀번호를 입력하고 원시 데이터의 참조 이름으로 password를 입력한 경우 봇을 실행하면 봇에서 오류가 발생합니다.
  12. 자격증명 매개변수: 원시 데이터 매개변수를 자격증명으로 입력하려는 경우. 자격증명을 선택하여 Credential Vault의 가용 값을 사용하거나 변수를 선택하여 자격증명 변수를 사용하거나, 안전하지 않은 문자열을 선택하여 사용할 값을 수동으로 지정할 수 있습니다.
  13. 인증 모드 목록에서 인증 없음 또는 기본을 선택합니다.
    • 인증 없음을 선택한 경우 다음 단계로 진행합니다.
    • 기본을 선택한 경우 자격증명을 입력합니다.
  14. 옵션: Control Room 또는 바탕화면에서 파일을 선택하여 클라이언트 인증서를 제공하거나 변수를 삽입합니다.
  15. 옵션: 맞춤형 헤더 제공.
  16. 옵션: XML 출력을 저장할 파일을 제공합니다.
  17. 전체 응답을 선택하거나 선택한 응답을 선택하여 응답의 범위를 좁힙니다.
    • 전체 응답을 선택한 경우, 다음 단계로 진행합니다.
    • 선택된 응답을 선택한다면, XPath 빌드 옵션을 사용하지 않고 수동으로 Xpath 식을 생성하는 경우 다음 단계를 수행합니다.
      1. 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/']
      2. XML 출력의 섹션을 선택합니다. 값, 내부 XML 또는 외부 XML을 선택합니다.
      3. 값 옵션을 선택한 경우 다음과 같이 반환 내용을 선택합니다. 다음으로 구분된 문자열 또는 문자열 목록.
        • 다음으로 구분된 문자열을 선택한 경우, 구분 기호 옵션을 선택합니다. 파이프, 세미콜론 또는 사용자 지정.
          사용자 지정을 선택한 경우 사용자 지정 구분 기호(선택 사항) 필드에 변수 또는 문자를 입력하십시오.
          주: 구분 기호로 특수 문자 달러 기호($)는 지원되지 않습니다.
        • SOAP 응답의 출력을 문자열 목록으로 반환하려면 문자열 목록을 선택합니다.
          주: 데이터 유형이 문자열인 목록 유형의 변수만 지정할 수 있습니다.
  18. Xpath 빌드를 클릭합니다.
    출력 미리보기 창이 나타납니다.
  19. 응답 본문에서 적절한 노드를 선택합니다. XML 경로가 자동으로 생성됩니다. 적용을 클릭합니다.
    Xpath 빌드 옵션을 사용하는 경우 XPath 식과 값 필드는 선택한 작업을 기반으로 하는 세부 정보로 자동으로 채워집니다.
  20. 옵션: SOAP 요청을 보내고 응답을 받을 때 시간 초과 값을 설정하려면 작업이 완료될 때까지 대기 필드에 대기 시간(밀리초)을 지정합니다.
    기본적으로 대기 시간은 60,000밀리초입니다.
  21. P12 인증서를 구성합니다.
    • SSL 인증 파일을 얻으려면 다음 옵션 중 하나를 선택합니다. Control Room 파일, 바탕화면 파일 또는 변수.
    • 키 저장소 속성을 구성합니다.
      • 키 저장소 파일(선택사항): 키 저장소 파일을 p12 형식으로 제공하려면 다음 옵션 중 하나를 선택합니다. Control Room 파일, 바탕화면 파일 또는 변수.. 키 저장소 파일에는 클라이언트의 개인 키와 인증서가 포함됩니다.
      • 키 저장소 비밀번호(선택사항): 키 저장소 파일에 대한 암호를 제공하려면 다음 옵션 중 하나를 선택합니다. 자격증명, 변수 또는 안전하지 않은 문자열. 비밀번호는 키 저장소 파일에 액세스하는 데 사용됩니다.
  22. XML 출력을 저장할 변수를 선택합니다.
    예: prompt-assignment
  23. 본문 메시지에 prompt-assignment 변수가 있는 메시지 상자 작업을 삽입하여 SOAP 웹 서비스 작업의 출력을 확인합니다.
    봇을 실행하면 메시지 상자에 30이 표시됩니다.