v_query – 범위 지정, 전역

v_query API는 원격 테이블에 대해 실행 중인 쿼리를 나타내는 스크립트 가능한 개체에 대한 정보를 가져오는 메서드를 제공합니다.

이 API를 사용하려면 원격 테이블 플러그인(com.glide.script.vtable)을 활성화해야 합니다. 자세한 내용은 원격 테이블 및 스크립트를 사용하여 외부 데이터 검색을 참조하세요.

원격 테이블 행은 v_table API를 사용하여 생성됩니다.

v_query - getCondition(문자열 필드)

지정된 필드에 대해 인코딩된 쿼리 문자열을 가져옵니다.

v_table API도 참조하세요.

표 1. 매개변수

이름	유형	설명
필드	문자열	필드의 이름입니다.

표 2. 반환

유형	설명
문자열	지정된 필드에 대해 인코딩된 쿼리 문자열을 반환합니다.

다음 예에서는 인코딩된 쿼리가 number=INC0001^active=true인 필드에 대한 결과를 보여줍니다.

var result = v_query.getCondition("number");
gs.info(result);

출력:

number=INC0001

v_query - getEncodedQuery()

원격 테이블에 대한 쿼리를 인코딩된 쿼리 문자열로 반환합니다.

자세한 내용은 인코딩된 쿼리 문자열을 참조하십시오 .

v_table API도 참조하세요.

표 3. 매개변수

이름	유형	설명
없음

표 4. 반환

유형	설명
문자열	문자열로 인코딩된 쿼리입니다.

다음 예는 외부 공급업체 소스에서 특정 기록 검색의 코드 스니펫입니다.

gs.info(v_query.getEncodedQuery());

출력:

active=true^priority=1

v_query - getParameter(문자열 필드)

같음 쿼리 조건의 필드 값을 가져옵니다.

참조:

• 외부 공급업체 소스에서 특정 기록 검색
• v_table API를 참조하십시오.

표 5. 매개변수

이름	유형	설명
필드	문자열	쿼리할 필드의 이름입니다.

표 6. 반환

유형	설명
문자열	쿼리 조건의 필드 값입니다. 예를 들어, name=John 이 인코딩된 쿼리인 경우 getParameter("name") 은 "John"을 반환합니다.

다음 예제에서는 발신자 ID 필드의 값을 가져오는 방법을 보여 줍니다.

v_query.getParameter("caller_id");

출력:

12345123451234512345123451234501

v_query - getSysId()

가져오기 쿼리에서 sys_id 값을 반환합니다.

표 7. 매개변수

이름	유형	설명
없음

표 8. 반환

유형	설명
문자열	예를 들어 sys_id=123인 경우 GET 쿼리의 Sys_id 값은 123을 반환합니다.

다음 예는 외부 공급업체 소스에서 특정 기록 검색의 코드 스니펫입니다.

v_query.getSysId();

출력:

a3a7ffb6dba41010db2051735e4619b7

v_query - getTextSearch()

텍스트 검색 쿼리 매개변수를 가져옵니다.

참조:

• 인코딩된 쿼리 문자열
• 스크립트에서 테이블 쿼리
• v_table API를 참조하십시오.

표 9. 매개변수

이름	유형	설명
없음

표 10. 반환

유형	설명
문자열	텍스트 검색 쿼리 매개변수입니다(예: 이메일).

다음 예제에서는 쿼리에 GOTO123TEXTQUERY321=email과 같은 텍스트 쿼리 매개 변수가 포함된 경우 메서드가 true를 반환합니다.

// for query value GOTO123TEXTQUERY321=email
v_query.getTextSearch();

출력:

email

v_query - isGet()

쿼리가 가져오기 쿼리인지, 즉 sys_id별로 레코드를 조회하는 쿼리인지 판별합니다.

참조:

• 외부 공급업체 소스에서 특정 기록 검색
• v_table API를 참조하십시오.

표 11. 매개변수

이름	유형	설명
없음

표 12. 반환

유형	설명
부울	플래그는 특정 기록에 대한 쿼리의 쿼리 형식이 sys_id= 임을 나타냅니다. 유효한 값은 다음과 같습니다. true: 쿼리에 sys_id 필드에 같음 쿼리 조건이 포함되어 있습니다. false: 쿼리에 sys_id 필드에 같음 쿼리 조건이 포함되어 있지 않습니다.

다음 예제에서 인코딩된 쿼리가 sys_id=d1954c744662010bd7e061e67a6776e이면 v_query.isGet() 메서드는 true를 반환합니다. 인코딩된 쿼리가 Number=INC0000001와 같은 다른 쿼리인 경우 v_query.isGet() 메서드는 false를 반환합니다.

// Virtual table to query
var row = {
 sys_id: "d1954c744662010bd7e061e67a6776e",
 number: "INC0000001",
 short_description: "New laptop request",
 u_balance: 1200.23
};

v_table.addRow(row);

v_query.isGet();

v_query - isTextSearch()

쿼리에 텍스트 쿼리 매개변수가 포함되어 있는지 나타냅니다.

참조:

• 인코딩된 쿼리 문자열
• 스크립트에서 테이블 쿼리
• v_table API를 참조하십시오.

표 13. 매개변수

이름	유형	설명
없음

표 14. 반환

유형	설명
부울	쿼리에 텍스트 쿼리 매개변수가 포함되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 쿼리에 텍스트 쿼리 매개변수가 포함되어 있습니다. false: 쿼리에 텍스트 쿼리 매개변수가 포함되어 있지 않습니다.

다음 예제에서는 쿼리에 GOTO123TEXTQUERY321=email과 같은 텍스트 쿼리 매개 변수가 포함된 경우 메서드가 true를 반환합니다.

v_query.isTextSearch();

v_query - setLastErrorMessage(문자열 메시지)

GlideRecord에서 마지막 오류 메시지를 설정합니다.

참조:

• 범위가 지정된 GlideRecord - getLastErrorMessage()
• 외부 공급업체 소스에서 특정 기록 검색
• v_table API를 참조하십시오.

표 15. 매개변수

이름	유형	설명
메시지	문자열	오류 메시지.

표 16. 반환

유형	설명
안 함

다음 예제에서는 오류 메시지를 설정하는 데 사용되는 기본 구조를 보여 줍니다.

(function executeQuery (v_table, v_query) {
 try {

 // Add code to test for errors during execution
 } catch(ex) {

  v_query.setLastErrorMessage(ex.message);

 }

}) (v_table, v_query);

다음 예제에서는 REST API에서 마지막 오류 메시지를 설정하는 방법을 보여 줍니다.

(function executeQuery (v_table, v_query) { 
 try {

 // call a REST API
 } catch(ex) {

  v_query.setLastErrorMessage("Error obtaining results from remote service");

 }

}) (v_table, v_query);