SOAPMessageV2 - 범위가 지정됨, 전역

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기15분

    • SOAPMessageV2 API는 JavaScript를 사용하여 아웃바운드 SOAP 메시지를 보내는 메소드를 제공합니다.

    이 API를 사용하여 SOAP 제공자가 리턴한 응답을 관리할 수 있습니다.

    범위가 지정된 애플리케이션 또는 전역 범위 내에서 이 API를 사용할 수 있습니다.

    이 API는 sn_ws 네임스페이스에서 실행됩니다.

    참고 항목:

    SOAPMessageV2 - SOAPMessageV2()

    빈 SOAPMessageV2 객체를 인스턴스화합니다.

    이러한 방식으로 인스턴스화된 개체를 사용하는 경우 SOAP 작업 및 끝점을 수동으로 지정해야 합니다.

    표 1. 매개변수
    이름 유형 설명
    없음 
    var sm = new sn_ws.SOAPMessageV2();

    SOAPMessageV2 - SOAPMessageV2(문자열 soapMessage, 문자열 soapFunction)

    SOAP 메시지 레코드 및 해당 레코드와 연관된 함수에서 SOAPMessageV2 오브젝트를 인스턴스화합니다.

    SOAP 메시지 기록의 엔드포인트, 인증 또는 MID 서버 설정과 같은 값이 이 객체에 적용됩니다.

    표 2. 매개변수
    이름 유형 설명
    비누메시지 문자열 이 개체의 기본으로 사용할 SOAP 메시지 레코드입니다.
    비누 함수 문자열 실행할 SOAP 함수입니다. 사용 가능한 SOAP 함수는 웹 서비스 제공자가 제공하는 WSDL에 따라 다릅니다. 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.

    SOAPMessageV2 - execute()

    엔드포인트에 SOAP 메시지를 보냅니다.

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    SOAPResponseV2 - 범위가 지정됨, 전역 SOAP 공급자가 반환한 응답입니다. 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var response = sm.execute(); //Might throw exception if http connection timed out or some issue with sending request itself because of encryption/decryption of password.

    SOAPMessageV2 - executeAsync()

    SOAP 메시지를 ECC 큐로 보냅니다.

    ECC 큐의 SOAP 메시지는 SOAPClient 비즈니스 규칙에 의해 처리됩니다.

    기본적으로 이 비즈니스 규칙은 비동기식으로 실행되지 않습니다. 비동기적으로 실행되도록 이 비즈니스 규칙을 구성하려면 When 값을 Async로 설정하고 스크립트 끝에 current.update()를 추가합니다. 인스턴스는 ECC 큐를 통해 메시지를 보낼 때 웹 서비스 제공자의 응답을 기다리지 않습니다.

    표 5. 매개변수
    이름 유형 설명
    없음
    표 6. 반환
    유형 설명
    SOAPResponseV2 - 범위가 지정됨, 전역 SOAP 공급자가 반환한 응답입니다.
    주:
    응답이 처리되기 전에 SOAP 응답 개체를 사용하려고 하면 시간 초과 오류가 발생할 수 있습니다.
    		 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var response = sm.executeAsync();

    SOAPMessageV2 - getEndpoint()

    SOAP 메시지의 엔드포인트를 가져옵니다.

    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 SOAP 웹 서비스 제공자의 URL입니다. 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var endpoint = sm.getEndpoint();

    SOAPMessageV2 - getRequestBody()

    SOAP 메시지 본문의 내용을 반환합니다.

    주:
    getRequestBody() 메서드를 호출하기 전에 execute() 메서드를 호출하여 응답 객체를 가져와야 합니다.
    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    문자열 SOAP 메시지 본문입니다. 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","StockQuoteSoap.GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var response = sm.execute();
var requestBody = response.getRequestBody();

    SOAPMessageV2 - getRequestHeader(문자열 headerName)

    SOAP 클라이언트에서 지정한 HTTP 헤더의 값을 가져옵니다.

    기본적으로 이 메서드는 시스템에서 자동으로 설정한 헤더의 값을 반환할 수 없습니다. 이 메서드에 모든 헤더에 대한 액세스 권한을 부여하려면 glide.http.log_debug 속성을 true로 설정합니다.

    표 11. 매개변수
    이름 유형 설명
    headerName 문자열 값을 가져오려는 요청 헤더입니다.
    표 12. 반환
    유형 설명
    문자열 지정된 헤더의 값입니다. 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var header = sm.getRequestHeader("Accept");

    SOAPMessageV2 - getRequestHeaders()

    SOAP 클라이언트가 설정한 HTTP 헤더와 관련 값을 가져옵니다.

    이 메서드는 시스템에서 자동으로 설정한 헤더를 반환하지 않습니다. 모든 헤더를 반환하도록 이 메서드를 구성하려면 glide.http.log_debug 속성을 true로 설정합니다.

    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    객체 각 헤더의 이름을 연결된 값에 매핑하는 객체입니다. 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var requestHeaders = sm.getRequestHeaders();

    SOAPMessageV2 - setBasicAuth(String userName, String userPass)

    SOAP 메시지에 대한 기본 인증 헤더를 설정합니다.

    이 메서드를 사용하여 기본 인증 헤더를 설정하면 SOAP 메시지 기록에 정의된 기본 인증 값이 무효화됩니다.

    표 15. 매개변수
    이름 유형 설명
    userName 문자열 SOAP 메시지를 인증할 때 사용할 사용자 이름입니다.
    userPass 문자열 지정된 사용자의 암호입니다.
    표 16. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setBasicAuth("username","password");

    SOAPMessageV2 - setEccCorrelator(문자열 관련자)

    아웃바운드 요청과 결과 응답 레코드를 ECC 큐에 연결합니다.

    이 메서드는 MID 서버를 통해 보낸 SOAP 메시지에만 적용됩니다. 제공된 관련자는 응답에 대한 ECC 큐 기록의 에이전트 관련자 필드를 채웁니다. MID 서버를 통해 비동기 자동화를 설계할 때 각 아웃바운드 요청에 대한 고유 관련자를 제공하여 ECC 큐의 올바른 결과를 요청과 연결합니다.

    표 17. 매개변수
    이름 유형 설명
    관련자 문자열 고유 식별자
    표 18. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setEccCorrelator("unique_id");

    SOAPMessageV2 - setEccParameter(문자열 이름, 문자열 값)

    SOAP 메시지 페이로드에 기록하여 데이터베이스의 값을 재정의합니다.

    이 메서드는 를 통해 MID 서버전송된 SOAP 메시지에만 적용됩니다. 엔드포인트 URL이 최대 SOAP 엔드포인트 필드 길이보다 긴 경우와 같이 데이터베이스의 SOAP 메시지 값이 유효하지 않은 경우 이 메서드를 사용합니다.

    이름 매개 변수에 유효한 값입니다.
    • source: 엔드포인트 URL입니다.
    • name: 실행할 SOAP 메시지 함수입니다.
    표 19. 매개변수
    이름 유형 설명
    이름 문자열 ECC 매개변수의 이름입니다.
    값 문자열 지정된 ECC 매개변수에 할당할 값입니다.
    표 20. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setEccParameter("source","http://very.long.endpoint");

    SOAPMessageV2 - setEndpoint(문자열 엔드포인트)

    SOAP 메시지의 엔드포인트를 설정합니다.

    기본적으로 SOAP 메시지는 SOAP 메시지 기록에 지정된 엔드포인트를 사용합니다. 이 메서드를 사용하여 기본값을 재정의합니다. 매개변수 없이 SOAPMessageV2() 생성자를 사용할 때 이 메서드를 호출해야 합니다.

    표 21. 매개변수
    이름 유형 설명
    endpoint 문자열 인터페이스하려는 SOAP 웹 서비스 제공자의 URL입니다.
    표 22. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2();
sm.setEndpoint("http://web.service.endpoint");

    SOAPMessageV2 - setHttpTimeout(숫자, timeoutMs)

    요청 제한시간이 초과되기 전에 SOAP 메시지가 웹 서비스 제공자로부터 응답을 기다리는 시간을 설정합니다.

    표 23. 매개변수
    이름 유형 설명
    timeoutMs입니다. 번호 웹 서비스 제공자의 응답을 기다리는 시간(밀리초)입니다.
    표 24. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setHttpTimeout(6000);

    SOAPMessageV2 - setLogLevel(문자열 레벨)

    이 메시지와 해당 응답에 대한 로그 수준을 설정합니다.

    SOAPMessageV2 API를 사용하여 로그 수준을 설정하면 SOAP 메시지 기록에 구성된 로그 수준이 무효화됩니다. 엔드포인트 도메인이 제외되거나 속성이 glide.outbound_http_log.override true인 경우에는 이 로그 수준이 적용되지 않을 수 있습니다. 아웃바운드 웹 서비스 로그를 보려면 다음으로 이동합니다. 시스템 로그 > 아웃바운드 HTTP 요청.

    표 25. 매개변수
    이름 유형 설명
    수준 문자열 로그 수준입니다. 유효한 값은 basic, elevated 및 all입니다.
    표 26. 반환
    유형 설명
    void

    SOAPMessageV2 - setMIDServer(문자열 midServerName)

    SOAP 메시지가 MID 서버를 통해 전송되도록 구성합니다.

    기본적으로 SOAP 메시지는 SOAP 메시지 함수 기록에 지정된 것을 MID 서버 사용합니다. 이 메서드를 사용하여 기본값을 재정의합니다.

    표 27. 매개변수
    이름 유형 설명
    midServerName 문자열 MID 서버 SOAP 메시지를 보내려는 사용자의 이름입니다. 인스턴스에 지정된 이름의 활성 MID 서버 파일이 있어야 합니다.
    표 28. 반환
    유형 설명
    void

    SOAPMessageV2 - setMutualAuth(문자열 profileName)

    SOAP 메시지에 대한 상호 인증 프로토콜 프로파일을 설정합니다.

    이 방법을 사용하여 프로토콜 프로파일을 설정하면 SOAP 메시지 기록에 대해 선택된 프로토콜 프로파일이 무효화됩니다.

    표 29. 매개변수
    이름 유형 설명
    profileName 문자열 상호 인증에 사용할 프로토콜 프로파일의 이름입니다.
    표 30. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setMutualAuth("auth_profile_name");

    SOAPMessageV2 - setRequestBody(문자열 requestBody)

    웹 서비스 제공자에게 보낼 본문 콘텐츠를 설정합니다.

    이 메서드를 사용하여 본문 내용을 설정할 때 본문의 변수는 SOAP 메시지 함수 기록의 매개변수로 대체되지 않습니다. SOAP 메시지 본문 내의 모든 값을 명시적으로 정의해야 합니다.

    표 31. 매개변수
    이름 유형 설명
    requestBody 문자열 SOAP 메시지의 본문입니다.
    표 32. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
var body = "<SOAP message body>";
sm.setRequestBody(body);

    SOAPMessageV2 - setRequestHeader(문자열 headerName, 문자열 headerValue)

    SOAP 메시지의 HTTP 헤더를 지정된 값으로 설정합니다.

    표 33. 매개변수
    이름 유형 설명
    headerName 문자열 헤더의 이름입니다.
    headerValue 문자열 지정된 헤더에 할당할 값입니다.
    표 34. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setRequestHeader("Accept","Application/json");

    SOAPMessageV2 - setSOAPAction(문자열 soapAction)

    이 SOAP 메시지가 수행하는 SOAP 작업을 정의합니다.

    웹 서비스 제공자의 WSDL은 수행할 수 있는 SOAP 조치를 나열합니다. 매개변수 없이 SOAPMessageV2() 생성자를 사용할 때 이 메서드를 호출해야 합니다.

    표 35. 매개변수
    이름 유형 설명
    비누 동작 문자열 이 SOAP 메시지가 수행하는 SOAP 작업입니다.
    표 36. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2();
sm.setSOAPAction("GetQuote");
//construct SOAP message by specifying endpoint and auth
sm.execute();

    SOAPMessageV2 - setStringParameter(문자열 이름, 문자열 값)

    SOAP 메시지 기록에서 지정된 이름의 변수를 지정된 값으로 설정합니다.

    값의 XML 예약 문자는 해당하는 이스케이프 문자로 변환됩니다.

    표 37. 매개변수
    이름 유형 설명
    이름 문자열 SOAP 메시지 변수의 이름입니다.
    값 문자열 지정된 변수에 할당할 값입니다.
    표 38. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setStringParameter("symbol","NOW");

    SOAPMessageV2 - setStringParameterNoEscape(문자열 이름, 문자열 값)

    SOAP 메시지 기록에서 지정된 이름의 변수를 지정된 값으로 설정합니다.

    이 메서드는 setStringParameter와 동일하지만 XML 예약 문자를 이스케이프하지 않습니다.

    표 39. 매개변수
    이름 유형 설명
    이름 문자열 SOAP 메시지 변수의 이름입니다.
    값 문자열 지정된 변수에 할당할 값입니다.
    표 40. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setStringParameterNoEscape("symbol","NOW");

    SOAPMessageV2 - setWSSecurity(문자열 keystoreId, 문자열 keystoreAlias, 문자열 keystorePassword, 문자열 certificateId)

    SOAP 메시지에 대한 웹 서비스 보안 값을 설정합니다.

    이 메서드를 사용하여 보안 값을 설정하면 SOAP 메시지 레코드에 정의된 웹 서비스 보안 값을 덮어씁니다.

    표 41. 매개변수
    이름 유형 설명
    키 스토어 ID 문자열 사용할 Java 또는 PKCS12 키 저장소의 Sys_id입니다.
    keystoreAlias 문자열 공개 키와 개인 키를 식별하는 별칭입니다.
    keystore암호 문자열 키 스토어 기록에 할당된 암호입니다.
    certificateId 문자열 신뢰할 수 있는 서버 인증서의 Sys_id입니다.
    표 42. 반환
    유형 설명
    void 
    var sm = new sn_ws.SOAPMessageV2("StockQuote","GetQuote"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setWSSecurity("70d65e074f3812001f6eac118110c71a","Quote keys","UXr82cqX75Z7MaSa+EyjGA==","ba969a074f3812001f6eac118110c76d");