SOAPMessageV2 - 범위 지정, 전역

SOAPMessageV2 - 실행()

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

표 1. 매개변수
이름	유형	설명
없음

표 2. 반환
유형	설명
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 큐를 통해 메시지를 보낼 때 웹 서비스 제공자의 응답을 기다리지 않습니다.

표 3. 매개변수
이름	유형	설명
없음

표 4. 반환
유형	설명
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 메시지의 끝점을 가져옵니다.

표 5. 매개변수
이름	유형	설명
없음

표 6. 반환
유형	설명
문자열	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() 메서드를 호출하여 응답 객체를 가져와야 합니다.

표 7. 매개변수
이름	유형	설명
없음

표 8. 반환
유형	설명
문자열	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로 설정합니다.

표 9. 매개변수
이름	유형	설명
headerName	문자열	값을 가져올 요청 헤더입니다.

표 10. 반환
유형	설명
문자열	지정된 헤더의 값입니다.

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로 설정합니다.

표 11. 매개변수
이름	유형	설명
없음

표 12. 반환
유형	설명
객체	각 헤더의 이름을 연결된 값에 매핑하는 객체입니다.

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(userName 문자열, userPass 문자열)

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

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

표 13. 매개변수
이름	유형	설명
userName	문자열	SOAP 메시지를 인증할 때 사용할 사용자 이름입니다.
유저패스	문자열	지정된 사용자의 암호입니다.

표 14. 반환
유형	설명
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 Server를 통해 보낸 SOAP 메시지에만 적용됩니다. 제공된 관련자는 응답에 대한 ECC 큐 기록의 에이전트 관련자 필드를 채웁니다. MID Server를 통해 비동기 자동화를 설계할 때 각 아웃바운드 요청에 대해 고유한 관련자를 제공하여 ECC 큐의 올바른 결과를 요청과 연결합니다.

표 15. 매개변수
이름	유형	설명
관련자	문자열	고유 식별자

표 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.setEccCorrelator("unique_id");

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

SOAP 메시지 페이로드에 기록하여 데이터베이스의 값을 겹쳐씁니다.

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

name 매개 변수에 유효한 값입니다.

source: 엔드포인트 URL입니다.
name: 실행할 SOAP 메시지 함수입니다.

표 17. 매개변수
이름	유형	설명
이름	문자열	ECC 매개변수의 이름입니다.
값	문자열	지정된 ECC 매개변수에 할당할 값입니다.

표 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.setEccParameter("source","http://very.long.endpoint");

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

SOAP 메시지의 끝점을 설정합니다.

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

표 19. 매개변수
이름	유형	설명
엔드포인트	문자열	인터페이스할 SOAP Web Service 제공자의 URL입니다.

표 20. 반환
유형	설명
void

var sm = new sn_ws.SOAPMessageV2();
sm.setEndpoint("http://web.service.endpoint");

SOAPMessageV2 - setHttpTimeout(Number timeoutMs)

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

표 21. 매개변수
이름	유형	설명
시간 초과	번호	웹 서비스 제공자의 응답을 기다리는 시간(밀리초)입니다.

표 22. 반환
유형	설명
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 요청.

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

표 24. 반환
유형	설명
void

SOAPMessageV2 - setMIDServer(문자열 midServerName)

MID Server를 통해 보낼 SOAP 메시지를 구성합니다.

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

표 25. 매개변수
이름	유형	설명
midServer이름	문자열	MID 서버 SOAP 메시지를 보낼 주소의 이름입니다. 인스턴스에 지정된 이름의 활성 MID 서버 항목이 있어야 합니다.

표 26. 반환
유형	설명
void

SOAPMessageV2 - setMutualAuth(profileName 문자열)

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

이 메서드를 사용하여 프로토콜 프로파일을 설정하면 SOAP 메시지 레코드에 대해 선택된 프로토콜 프로파일이 무효화됩니다.

표 27. 매개변수
이름	유형	설명
profileName	문자열	상호 인증에 사용할 프로토콜 프로파일의 이름입니다.

표 28. 반환
유형	설명
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 메시지 본문 내의 모든 값을 명시적으로 정의해야 합니다.

표 29. 매개변수
이름	유형	설명
requestBody	문자열	SOAP 메시지의 본문입니다.

표 30. 반환
유형	설명
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 헤더를 지정된 값으로 설정합니다.

표 31. 매개변수
이름	유형	설명
headerName	문자열	헤더의 이름입니다.
headerValue	문자열	지정된 헤더에 할당할 값입니다.

표 32. 반환
유형	설명
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() 생성자를 사용할 때 이 메서드를 호출해야 합니다.

표 33. 매개변수
이름	유형	설명
비누 작업	문자열	이 SOAP 메시지가 수행하는 SOAP 작업입니다.

표 34. 반환
유형	설명
void

var sm = new sn_ws.SOAPMessageV2();
sm.setSOAPAction("GetQuote");
//construct SOAP message by specifying endpoint and auth
sm.execute();

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

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

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

표 35. 매개변수
이름	유형	설명
이름	문자열	SOAP 메시지 변수의 이름입니다.
값	문자열	지정된 변수에 할당할 값입니다.

표 36. 반환
유형	설명
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 예약된 문자를 이스케이프하지 않습니다.

표 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.setStringParameterNoEscape("symbol","NOW");

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

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

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

표 39. 매개변수
이름	유형	설명
keystoreId	문자열	사용할 Java 또는 PKCS12 키 저장소의 Sys_id입니다.
keystore별칭	문자열	공개 키와 개인 키를 식별하는 별칭입니다.
keystore암호	문자열	키 저장소 기록에 할당된 암호입니다.
인증서 ID	문자열	신뢰할 수 있는 서버 인증서의 Sys_id입니다.

표 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.setWSSecurity("70d65e074f3812001f6eac118110c71a","Quote keys","UXr82cqX75Z7MaSa+EyjGA==","ba969a074f3812001f6eac118110c76d");

SOAPMessageV2 - SOAPMessageV2()

비어 있는 SOAPMessageV2 객체를 인스턴스화합니다.

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

표 41. 매개변수
이름	유형	설명
없음

var sm = new sn_ws.SOAPMessageV2();

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

SOAP 메시지 레코드 및 해당 레코드와 연관된 기능에서 SOAPMessageV2 객체를 인스턴스화합니다.

SOAP 메시지 레코드의 끝점, 인증 또는 MID 서버 설정과 같은 값이 이 개체에 적용됩니다.

표 42. 매개변수
이름	유형	설명
비누메시지	문자열	이 객체의 기반으로 사용할 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.