RESTMessageV2 - 범위 지정, 전역

RESTMessageV2 - disableForcedVariableSubstitution()

아웃바운드 REST 메시지에서 강제 변수 대체를 사용하지 않도록 설정합니다.

주:

요청에 중괄호 또는 달러 기호를 사용하면 실수로 잘린 출력이 반환될 수 있습니다. 요청으로 인해 응답이 잘못 잘리거나 응답이 새 줄로 분할되는 경우, 이 커뮤니티 문서에서 잠재적인 해결 방법을 참조하십시오.

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

표 2. 반환
유형	설명
void

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get");
sm.disableForcedVariableSubstitution();
var response = sm.execute();

RESTMessageV2 - 실행()

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

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

표 4. 반환
유형	설명
RESTResponse	REST 공급자가 반환한 응답입니다.

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //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.

RESTMessageV2 - executeAsync()

REST 메시지를 엔드포인트에 비동기적으로 보냅니다. 인스턴스는 비동기 호출을 수행할 때 웹 서비스 제공자의 응답을 기다리지 않습니다.

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

표 6. 반환
유형	설명
RESTResponse	REST 공급자가 반환한 응답입니다.

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다. executeAsync를 사용하는 경우 비동기 호출을 활용하기 위해 별도의 비즈니스 규칙에서 응답 본문을 처리하는 것이 좋습니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var response = sm.executeAsync(); //Might throw exception if http connection timed out or some issue with sending request itself because of encryption/decryption of password.

RESTMessageV2 - get엔드포인트()

REST 메시지에 대한 끝점의 URL을 가져옵니다.

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

표 8. 반환
유형	설명
문자열	REST 웹 서비스 제공자의 URL입니다.

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var endpoint = sm.getEndpoint();

RESTMessageV2 - getRequestBody()

REST 메시지 본문의 내용을 가져옵니다.

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

표 10. 반환
유형	설명
문자열	REST 메시지 본문입니다.

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var body = sm.getRequestBody();

RESTMessageV2 - getRequestHeader(headerName 문자열)

REST 메시지에 지정된 HTTP 헤더의 값을 가져옵니다.

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

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

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

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var header = sm.getRequestHeader("Accept");

RESTMessageV2 - getRequestHeaders()

REST 클라이언트에서 설정한 HTTP 헤더와 연결된 값을 가져옵니다.

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

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

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

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
var headers = sm.getRequestHeaders();

RESTMessageV2 - RESTMessageV2()

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

이러한 방식으로 인스턴스화된 개체를 사용하는 경우 HTTP 메서드와 끝점을 수동으로 지정해야 합니다.

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

var sm = new sn_ws.RESTMessageV2();

RESTMessageV2 - RESTMessageV2(문자열 이름, 문자열 methodName)

REST 메시지 기록의 정보를 사용하여 RESTMessageV2 객체를 인스턴스화합니다.

이 생성자를 사용하려면 먼저 REST 메시지 레코드를 정의해야 합니다.

표 16. 매개변수
이름	유형	설명
이름	문자열	REST 메시지 기록의 이름입니다.
Methodname	문자열	사용할 HTTP 메서드의 이름(예: GET/get 또는 PUT/PUT - 대/소문자 구분 안 함)

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.

RESTMessageV2 - saveResponseBodyAsAttachment(문자열 tableName, 문자열 recordSysId, 문자열 fileName)

반환된 응답 본문을 첨부 파일 기록으로 저장하도록 REST 메시지를 구성합니다.

MID Server를 통해 전송되는 REST 메시지와 함께 이 함수를 사용하는 경우 MID Server 사용자에게는 첨부 파일 기록을 읽고 쓰는 데 필요한 모든 역할과 매개변수에 tableName 지정된 테이블에서 기록을 읽고 쓰는 데 필요한 모든 역할이 있어야 합니다.

응답 본문이 첨부 파일로 저장하기 위해 이진 파일일 필요는 없습니다. JSON 또는 XML과 같은 텍스트 형식을 사용하는 응답 본문도 저장할 수 있습니다. 인스턴스가 첨부 파일을 저장하지 못하면 관련 RESTResponseV2 객체에서 getErrorMessage() 를 호출하여 오류 세부사항을 확인하십시오.

표 17. 매개변수
이름	유형	설명
tableName	문자열	저장된 파일을 첨부하려는 기록이 들어 있는 테이블을 지정합니다.
recordSysID	문자열	저장된 파일을 첨부하려는 기록의 sys_id 지정합니다.
fileName	문자열	저장된 파일에 지정할 파일 이름을 지정합니다.

표 18. 반환
유형	설명
void

(function sampleRESTMessageV2() {
  try{
    var request  = new sn_ws.RESTMessageV2();        
    request.setHttpMethod('get');

    var attachment_sys_id  = '<attachment_record_sys_id>', 
      tablename = 'incident',
      recordSysId = '<incident_sys_id>',            
      response,            
      httpResponseStatus,             
      filename ='<filename>';

    //endpoint - ServiceNow REST Attachment API        
    request.setEndpoint('https://<instance_name>.service-now.com/api/now/attachment/' + attachment_sys_id  +'/file');        
    request.setBasicAuth('<username>', '<password>');

    //RESTMessageV2 - saveResponseBodyAsAttachment(String tableName, String recordSysId, String fileName)        
    request.saveResponseBodyAsAttachment(tablename, recordSysId, filename);        

    response = request.execute();        
    httpResponseStatus = response.getStatusCode();  
      
    gs.info(" http response status_code:  " + httpResponseStatus);    
  }
  catch(ex){
    var message  = ex.getMessage();        
    gs.info(message);    
  }
})();

RESTMessageV2 - saveResponseBodyAsAttachment(tableName 문자열, recordSysId 문자열, fileName 문자열, encryptContext 문자열)

반환된 응답 본문을 암호화된 첨부 파일 기록으로 저장하도록 REST 메시지를 구성합니다.

MID Server를 통해 전송되는 REST 메시지와 함께 이 함수를 사용하는 경우 MID Server 사용자에게는 첨부 파일 기록을 읽고 쓰는 데 필요한 모든 역할과 매개변수에 tableName 지정된 테이블에서 기록을 읽고 쓰는 데 필요한 모든 역할이 있어야 합니다.

응답 본문이 첨부 파일로 저장하기 위해 이진 파일일 필요는 없습니다. JSON 또는 XML과 같은 텍스트 형식을 사용하는 응답 본문도 저장할 수 있습니다. 인스턴스가 첨부 파일을 저장하지 못하면 관련 RESTResponseV2 객체에서 getErrorMessage() 를 호출하여 오류 세부사항을 확인하십시오.

표 19. 매개변수
이름	유형	설명
tableName	문자열	저장된 파일을 첨부하려는 기록이 들어 있는 테이블을 지정합니다.
recordSysID	문자열	저장된 파일을 첨부하려는 기록의 sys_id 지정합니다.
fileName	문자열	저장된 파일에 지정할 파일 이름을 지정합니다.
encryptContext	문자열	암호화 컨텍스트의 sys_id 지정합니다. 저장된 파일은 이 컨텍스트를 사용하여 암호화됩니다.

표 20. 반환
유형	설명
void

RESTMessageV2 - setAuthenticationProfile(문자열 유형, 문자열 profileId)

기존 기본 인증 또는 OAuth 2.0 프로파일을 사용하여 REST 메시지에 대한 자격 증명을 설정합니다.

표 21. 매개변수
이름	유형	설명
유형	문자열	사용할 인증 프로파일의 유형입니다. 유효한 값은 기본 인증을 사용하는 'basic' 또는 OAuth 2.0을 사용하는 'oauth2'입니다.
프로파일 ID	문자열	인증 프로파일 기록의 sys_id입니다. 기본 인증을 사용하는 경우 기본 인증 구성[sys_auth_profile_basic] 기록의 sys_id 지정합니다. OAuth 2.0을 사용하는 경우 OAuth 엔터티 프로파일 [oauth_entity_profile] 기록의 sys_id 지정합니다.

표 22. 반환
유형	설명
void

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var requestBody;
var responseBody;
var status;
var sm;
try{
       // Might throw exception if message doesn't exist or not visible due to scope.
	sm = new sn_ws.RESTMessageV2("<REST_message_record>", "get");  

       //set auth profile to an OAuth 2.0 profile record.
	sm.setAuthenticationProfile('oauth2', '1234adsf123212131123qasdsf'); 

	sm.setStringParameter("symbol", "NOW");
	sm.setStringParameterNoEscape("xml_data","<data>test</data>");

       //In milliseconds. Wait at most 10 seconds for response from http request.
	sm.setHttpTimeout(10000); 
       //Might throw exception if http connection timed out or some issue 
       //with sending request itself because of encryption/decryption of password.
	response = sm.execute();	
       responseBody = response.haveError() ? response.getErrorMessage() : response.getBody();
	status = response.getStatusCode();
} catch(ex) {
	responseBody = ex.getMessage();
	status = '500';
} finally {
	requestBody = sm ? sm.getRequestBody():null;
}

RESTMessageV2 - setBasicAuth(userName 문자열, userPass 문자열)

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

이 방법을 사용하여 보안 값을 설정하면 REST 메시지 기록에 대해 정의된 기본 인증 값이 무효화됩니다.

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

표 24. 반환
유형	설명
void

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setBasicAuth("username","password");

RESTMessageV2 - setEccCorrelator(문자열 관련자)

아웃바운드 요청과 ECC 큐의 결과 응답 기록을 연결합니다. 이 메서드는 를 통해 MID 서버전송되는 REST 메시지에만 적용됩니다.

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

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

표 26. 반환
유형	설명
void

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setEccCorrelator("unique_identifier");

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

REST 메시지 페이로드에 기록하여 데이터베이스의 값을 재정의합니다. 이 메서드는 MID Server를 통해 보낸 REST 메시지에만 적용됩니다.

엔드포인트 URL이 최대 REST 엔드포인트 필드 길이보다 긴 경우와 같이 데이터베이스의 REST 메시지 값이 올바르지 않은 경우 이 메서드를 사용합니다. source를 name 매개 변수로 전달하여 이 메서드를 사용하면 엔드포인트 URL만 설정할 수 있습니다.

표 27. 매개변수
이름	유형	설명
이름	문자열	source와 같은 매개변수의 이름입니다.
값	문자열	지정된 매개 변수에 할당할 값입니다.

표 28. 반환
유형	설명
void

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setEccParameter("source","http://very.long.endpoint.url");

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

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

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

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

표 30. 반환
유형	설명
void

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

RESTMessageV2 - setHttpMethod(String 메서드)

이 REST 메시지가 수행하는 HTTP 메서드(예: GET 또는 PUT)를 설정합니다.

매개 변수 없이 생성자를 RESTMessageV2 - RESTMessageV2() 사용하는 경우 HTTP 메서드를 설정해야 합니다.

표 31. 매개변수
이름	유형	설명
방법	문자열	수행할 HTTP 메서드입니다.

표 32. 반환
유형	설명
void

var sm = new sn_ws.RESTMessageV2();
sm.setHttpMethod("post");

RESTMessageV2 - setHttpTimeout(timeoutMs) 수

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

표 33. 매개변수
이름	유형	설명
시간 초과	번호	REST 제공자에 대한 호출 시간이 초과되기 전의 시간(밀리초)입니다. 주: 이 값은 소켓의 시간 제한을 설정하고 소켓이 지정된 시간 내에 데이터를 받지 못하는 경우에만 시간 초과됩니다. 응답이 스트리밍되는 환경의 경우 연결이 시간 제한 값보다 훨씬 오래 지속될 수 있습니다.

표 34. 반환
유형	설명
없음

다음 예시를 사용하려면 <REST_message_record> 를 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

// Might throw exception if message doesn't exist or not visible due to scope.
var sm = new sn_ws.RESTMessageV2("<REST_message_record>", "get");
sm.setHttpTimeout(6000);

RESTMessageV2 - setLogLevel(문자열 레벨)

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

RESTMessageV2 API를 사용하여 로그 레벨을 설정하면 REST 메시지 레코드에 구성된 로그 레벨을 겹쳐씁니다. 엔드포인트 도메인이 제외되거나 속성이 glide.outbound_http_log.override true인 경우 이 로그 수준이 적용되지 않을 수 있습니다. 아웃바운드 웹 서비스 로그를 보려면 다음으로 이동합니다. 시스템 로그 > 아웃바운드 HTTP 요청.

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

표 36. 반환
유형	설명
void

var rm = new sn_ws.RESTMessageV2();
rm.setLogLevel('all');

RESTMessageV2 - setMIDServer(문자열 midServer)

를 통해 MID 서버통신하도록 REST 메시지를 구성합니다.

표 37. 매개변수
이름	유형	설명
중앙 서버	문자열	사용할 이름입니다 MID 서버 . 인스턴스에 지정된 이름의 활성 MID 서버 항목이 있어야 합니다.

표 38. 반환
유형	설명
void

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setMIDServer("mid_server_name");

RESTMessageV2 - setMutualAuth(profileName 문자열)

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

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

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

표 40. 반환
유형	설명
void

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setMutualAuth("mutual_auth_profile_name");

RESTMessageV2 - setQueryParameter(문자열 이름, 문자열 값)

name=value 형식으로 요청 URL의 끝에 매개변수를 추가합니다.

예를 들어, 코드 setQueryParameter("sysparm_query","active=true^ORDERBYnumber^ORDERBYDESCcategory"); 요청 URL에 sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory 텍스트를 추가합니다.

표 41. 매개변수
이름	유형	설명
이름	문자열	전달할 URL 매개변수의 이름입니다.
값	문자열	URL 매개변수를 할당하는 값입니다.

표 42. 반환
유형	설명
void

var sm = new sn_ws.RESTMessageV2();
//Set up message, including endpoint and authentication
sm.setQueryParameter("sysparm_query","active=true^ORDERBYnumber^ORDERBYDESCcategory");

RESTMessageV2 - setRequestBody(문자열 본문)

PUT 또는 POST HTTP 메서드를 사용할 때 웹 서비스 공급자에게 보낼 본문 내용을 설정합니다.

이 방법을 사용하여 본문 내용을 설정하면 본문의 변수가 REST 메시지 함수 기록의 매개변수를 대체하지 않습니다. REST 메시지 본문 내의 모든 값을 명시적으로 정의해야 합니다.

표 43. 매개변수
이름	유형	설명
본문	문자열	보낼 본문 요청입니다.

표 44. 반환
유형	설명
void

var sm = new sn_ws.RESTMessageV2("Update user","post"); //Might throw exception if message doesn't exist or not visible due to scope.
var body = "<Message body content>";
sm.setRequestBody(body);

RESTMessageV2 - setRequestBodyFromAttachment(attachmentSysId 문자열)

기존 첨부 파일 기록을 사용하여 요청 본문을 설정합니다.

를 통해 MID 서버전송되는 REST 메시지와 함께 이 함수를 사용하는 경우, MID 서버 사용자는 첨부 파일 기록을 읽는 데 필요한 모든 역할을 가지고 있어야 합니다.

표 45. 매개변수
이름	유형	설명
attachmentSysId	문자열	이 REST 메시지에서 보낼 첨부 파일 [sys_attachment] 기록의 Sys_id입니다.

표 46. 반환
유형	설명
void

(function sampleRESTMessageV2() {
    try {
        var request = new sn_ws.RESTMessageV2();
        request.setHttpMethod('post');
        request.setEndpoint('<web service endpoint URL>');
        request.setRequestBodyFromAttachment('<attachment sys_id>');
        
        var response = request.execute();
        var httpResponseStatus = response.getStatusCode();
      
        gs.info("http response status_code: " + httpResponseStatus);        
    }
    catch (ex) {
        var message = ex.getMessage();
        gs.info(message);
    }
})();

RESTMessageV2 - setRequestHeader(문자열 이름, 문자열 값)

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

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

표 48. 반환
유형	설명
void

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setRequestHeader("Accept","Application/json");

RESTMessageV2 - setRequestorProfile(requestorContext 문자열, requestorId 문자열)

다른 요청자와 연결된 OAuth 접근 토큰을 검색하기 위해 REST 메시지의 기본 요청자 프로파일을 재정의합니다.

이 방법은 OAuth 2.0 인증을 사용하도록 구성된 REST 메시지에만 적용됩니다. 이 방법은 선택 사항이며 대부분의 구성에서 필요하지 않습니다.

표 49. 매개변수
이름	유형	설명
requestorContext	문자열
requestorId	문자열

표 50. 반환
유형	설명
void

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

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

값의 XML 예약된 문자는 해당 이스케이프된 문자로 변환됩니다. setStringParameterNoEscape를 사용하여 XML 예약된 문자를 이스케이프하지 않고 변수를 설정합니다.

표 51. 매개변수
이름	유형	설명
이름	문자열	REST 메시지 변수의 이름입니다. 값을 할당하려면 먼저 REST 메시지 기록에 이 매개변수를 정의해야 합니다.
값	문자열	변수를 할당할 값입니다.

표 52. 반환
유형	설명
void

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setStringParameter("s","NOW");

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

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

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

표 53. 매개변수
이름	유형	설명
이름	문자열	REST 메시지 변수의 이름입니다. 값을 할당하려면 먼저 REST 메시지 기록에 이 매개변수를 정의해야 합니다.
값	문자열	변수를 할당할 값입니다.

표 54. 반환
유형	설명
void

다음 예제에서 REST_message_record 인스턴스의 REST 메시지 기록 이름으로 바꿉니다.

var sm = new sn_ws.RESTMessageV2("<REST_message_record>","get"); //Might throw exception if message doesn't exist or not visible due to scope.
sm.setStringParameterNoEscape("s","NOW");