--- sourceDocument: 호주 API 참조 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference Release : - australia ft:locale : - ko-KR ft:publication_title : - 호주 API 참조 ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # v_query -- 범위 지정, 전역 # v_query -- 범위 지정, 전역 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분 v_query API에는 원격 테이블에 대해 실행되는 쿼리를 나타내는 스크립트 가능한 객체에 대한 정보를 가져오는 메서드가 있습니다. 이 API를 사용하려면 원격 테이블 플러그인(com.glide.script.vtable)을 활성화해야 합니다. 자세한 내용은 [원격 테이블 및 스크립트를 사용하여 외부 데이터 검색을 참조하십시오.](https://www.servicenow.com/docs/access?context=remote-tables&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 원격 테이블 행은 [v_table](https://servicenow-prod.fluidtopics.net/dUrYpwn9jT5jlhU5oRo7TQ#v_tableAPI "v_table API는 스크립트 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.") API를 사용하여 생성됩니다. ## v_query - getCondition(문자열 필드) {#ariaid-title2} 지정된 필드에 대해 인코딩된 쿼리 문자열을 가져옵니다. [API v_table](https://servicenow-prod.fluidtopics.net/dUrYpwn9jT5jlhU5oRo7TQ#v_tableAPI "v_table API는 스크립트 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.")도 참조하십시오. {#vquery-getCondition_S__table_j3v_xm3_nlb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 필드 | 문자열 | 필드의 이름입니다. | [표 1. 매개변수] {#vquery-getCondition_S__table_j3v_xm3_nlb} {#vquery-getCondition_S__table_k3v_xm3_nlb__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 지정된 필드에 대해 [인코딩된 쿼리 문자열](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) 을 반환합니다. | [표 2. 반환] {#vquery-getCondition_S__table_k3v_xm3_nlb} 다음 예제에서는 인코딩된 쿼리가 `number=INC0001^active=true`인 필드에 대한 결과를 보여줍니다. var result = v_query.getCondition("number"); gs.info(result); 출력: number=INC0001 ## v_query - getEncodedQuery() {#ariaid-title3} 원격 테이블에 대한 쿼리를 인코딩된 쿼리 문자열로 반환합니다. 자세한 내용은 [인코딩된 쿼리 문자열을](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) 참조하십시오.{#vquery-getEncodedQuery__link_encoded_query_strings} [API v_table](https://servicenow-prod.fluidtopics.net/dUrYpwn9jT5jlhU5oRo7TQ#v_tableAPI "v_table API는 스크립트 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.")도 참조하십시오. {#vquery-getEncodedQuery__table_j3v_xm3_nlb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 3. 매개변수] {#vquery-getEncodedQuery__table_j3v_xm3_nlb} {#vquery-getEncodedQuery__table_k3v_xm3_nlb__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 문자열로 인코딩된 쿼리입니다. | [표 4. 반환] {#vquery-getEncodedQuery__table_k3v_xm3_nlb} 다음 예는 [외부 공급업체 소스에서 특정 기록 검색](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)의 스니펫입니다. gs.info(v_query.getEncodedQuery()); 출력: active=true^priority=1 ## v_query - getParameter(문자열 필드) {#ariaid-title4} 동등 쿼리 조건에서 필드 값을 가져옵니다. 참조 : * [외부 공급업체 소스에서 특정 기록 검색](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/dUrYpwn9jT5jlhU5oRo7TQ#v_tableAPI "v_table API는 스크립트 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.") API {#vquery-getParameter_S__ul_y54_hnd_sqb} {#vquery-getParameter_S__table_j3v_xm3_nlb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 필드 | 문자열 | 쿼리할 필드의 이름입니다. | [표 5. 매개변수] {#vquery-getParameter_S__table_j3v_xm3_nlb} {#vquery-getParameter_S__table_k3v_xm3_nlb__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 쿼리 조건의 필드 값입니다. 예를 들어 `name=John` 이 인코딩된 쿼리이면 getParameter("name")는`"John"`을 반환합니다. | [표 6. 반환] {#vquery-getParameter_S__table_k3v_xm3_nlb} 다음 예는 호출자 ID 필드의 값을 가져오는 방법을 보여줍니다. v_query.getParameter("caller_id"); 출력: 12345123451234512345123451234501 ## v_query - getSysId() {#ariaid-title5} GET 쿼리에서 sys_id 값을 반환합니다. {#vquery-getSysId__table_j3v_xm3_nlb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 7. 매개변수] {#vquery-getSysId__table_j3v_xm3_nlb} {#vquery-getSysId__table_k3v_xm3_nlb__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 예를 들어 `sys_id=123`인 경우 GET 쿼리의 값을 Sys_id하면 이 메서드는 123을 반환합니다. | [표 8. 반환] {#vquery-getSysId__table_k3v_xm3_nlb} 다음 예는 [외부 공급업체 소스에서 특정 기록 검색](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)의 스니펫입니다. v_query.getSysId(); 출력: a3a7ffb6dba41010db2051735e4619b7 ## v_query - getTextSearch() {#ariaid-title6} 텍스트 검색 쿼리 매개변수를 가져옵니다. 참조 : * [인코딩된 쿼리 문자열](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) * [스크립트에서 테이블 쿼리](https://servicenow-prod.fluidtopics.net/m0vf2kDl_EIzsnZAFaz94g#c_UsingGlideRecordToQueryTables "GlideRecord API의 메서드를 사용하여 테이블에서 모든 기록을 반환하거나, 테이블에서 특정 조건을 만족하는 기록을 반환하거나, 단일 테이블 또는 텍스트 인덱스 그룹의 여러 테이블에서 문자열을 포함하는 기록을 반환할 수 있습니다.") * [v_table](https://servicenow-prod.fluidtopics.net/dUrYpwn9jT5jlhU5oRo7TQ#v_tableAPI "v_table API는 스크립트 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.") API {#vquery-getTextSearch__ul_a2q_rkp_nlb} {#vquery-getTextSearch__table_j3v_xm3_nlb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 9. 매개변수] {#vquery-getTextSearch__table_j3v_xm3_nlb} {#vquery-getTextSearch__table_k3v_xm3_nlb__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 텍스트 검색 쿼리 매개변수( 예: 이메일) | [표 10. 반환] {#vquery-getTextSearch__table_k3v_xm3_nlb} 다음 예제에서 쿼리에 텍스트 쿼리 매개변수( `예: GOTO123TEXTQUERY321=email`)가 포함된 경우 메서드가 true를 반환합니다. // for query value GOTO123TEXTQUERY321=email v_query.getTextSearch(); 출력: email ## v_query - isGet() {#ariaid-title7} 쿼리가 가져오기 쿼리인지, 즉 sys_id로 기록을 검색하는 쿼리인지 확인합니다. 참조 : * [외부 공급업체 소스에서 특정 기록 검색](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/dUrYpwn9jT5jlhU5oRo7TQ#v_tableAPI "v_table API는 스크립트 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.") API {#vquery-isGet__ul_y54_hnd_sqb} {#vquery-isGet__table_j3v_xm3_nlb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 11. 매개변수] {#vquery-isGet__table_j3v_xm3_nlb} {#vquery-isGet__table_k3v_xm3_nlb__entry__2} | 유형 | 설명 | |-|-| | 부울 | 플래그는 특정 기록에 대한 쿼리의 쿼리 형식이 `sys_id=` 임을 나타냅니다. 유효한 값은 다음과 같습니다. * true: 쿼리에 sys_id 필드에 동등 쿼리 조건이 포함되어 있습니다. * false: 쿼리가 sys_id 필드에 동일성 쿼리 조건을 포함하지 않습니다. {#vquery-isGet__ul_jdl_pfb_add} | [표 12. 반환] {#vquery-isGet__table_k3v_xm3_nlb} 다음 예제에서 인코딩된 쿼리가 `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() {#ariaid-title8} 쿼리에 텍스트 쿼리 매개변수가 포함되어 있는지 여부를 나타냅니다. 참조 : * [인코딩된 쿼리 문자열](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) * [스크립트에서 테이블 쿼리](https://servicenow-prod.fluidtopics.net/m0vf2kDl_EIzsnZAFaz94g#c_UsingGlideRecordToQueryTables "GlideRecord API의 메서드를 사용하여 테이블에서 모든 기록을 반환하거나, 테이블에서 특정 조건을 만족하는 기록을 반환하거나, 단일 테이블 또는 텍스트 인덱스 그룹의 여러 테이블에서 문자열을 포함하는 기록을 반환할 수 있습니다.") * [v_table](https://servicenow-prod.fluidtopics.net/dUrYpwn9jT5jlhU5oRo7TQ#v_tableAPI "v_table API는 스크립트 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.") API {#vquery-isTextSearch__ul_a2q_rkp_nlb} {#vquery-isTextSearch__table_j3v_xm3_nlb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 13. 매개변수] {#vquery-isTextSearch__table_j3v_xm3_nlb} {#vquery-isTextSearch__table_k3v_xm3_nlb__entry__2} | 유형 | 설명 | |-|-| | 부울 | 쿼리에 텍스트 쿼리 매개변수가 포함되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 쿼리에 텍스트 쿼리 매개변수가 포함되어 있습니다. * false: 쿼리에 텍스트 쿼리 매개변수가 포함되어 있지 않습니다. {#vquery-isTextSearch__ul_jdl_pfb_add} | [표 14. 반환] {#vquery-isTextSearch__table_k3v_xm3_nlb} 다음 예제에서 쿼리에 텍스트 쿼리 매개변수( `예: GOTO123TEXTQUERY321=email`)가 포함된 경우 메서드가 true를 반환합니다. v_query.isTextSearch(); ## v_query - setLastErrorMessage(문자열 메시지) {#ariaid-title9} GlideRecord의 마지막 오류 메시지를 설정합니다. 참조 : * [범위가 지정된 GlideRecord - getLastErrorMessage()](https://servicenow-prod.fluidtopics.net/PdjBDkljzRHVS4qRn2BIdw#c_GlideRecordScopedAPI "범위가 지정된 GlideRecord API는 데이터베이스 작업에 사용됩니다.") * [외부 공급업체 소스에서 특정 기록 검색](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) * [v_table](https://servicenow-prod.fluidtopics.net/dUrYpwn9jT5jlhU5oRo7TQ#v_tableAPI "v_table API는 스크립트 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.") API {#vquery-setLastErrorMessage_S__ul_dbm_rvc_sqb} {#vquery-setLastErrorMessage_S__table_j3v_xm3_nlb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 메시지 | 문자열 | 오류 메시지. | [표 15. 매개변수] {#vquery-setLastErrorMessage_S__table_j3v_xm3_nlb} {#vquery-setLastErrorMessage_S__table_k3v_xm3_nlb__entry__2} | 유형 | 설명 | |-|-| | 없음 | | [표 16. 반환] {#vquery-setLastErrorMessage_S__table_k3v_xm3_nlb} 다음 예시에서는 오류 메시지를 설정하는 데 사용되는 기본 구조를 보여줍니다. (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);