---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# v_query - 범위, 전역

# v_query - 범위, 전역 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분

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

이 API를 사용하려면 Remote Tables 플러그인(com.glide.script.vtable)을 활성화해야 합니다. 자세한 정보는 [원격 테이블 및 스크립트를 사용하여 외부 데이터 검색의 내용을 참조하십시오](https://www.servicenow.com/docs/access?context=remote-tables&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).

원격 테이블 행은 [v_table](https://servicenow-prod.fluidtopics.net/URjcrZAuWmS3qo13pHqFRg#v_tableAPI "v_table API는 스크립트 가능한 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.") API를 사용하여 생성됩니다.

## v_query - getCondition(문자열 필드) {#ariaid-title2}

지정된 필드에 대해 인코딩된 쿼리 문자열을 가져옵니다.
[API v_table](https://servicenow-prod.fluidtopics.net/URjcrZAuWmS3qo13pHqFRg#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=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) 참조하십시오 .{#vquery-getEncodedQuery__link_encoded_query_strings}

[API v_table](https://servicenow-prod.fluidtopics.net/URjcrZAuWmS3qo13pHqFRg#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=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/URjcrZAuWmS3qo13pHqFRg#v_tableAPI "v_table 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}

| 유형 | 설명 |
|-|-|
| 문자열 | get 쿼리의 Sys_id 값(예: `sys_id=123`인 경우 이 메서드는 123을 반환합니다. |
[표 8. 반환]

{#vquery-getSysId__table_k3v_xm3_nlb}  
다음 예는 [외부 공급업체 소스에서 특정 기록 검색](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
* [스크립트에서 테이블 쿼리](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/URjcrZAuWmS3qo13pHqFRg#v_tableAPI "v_table 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=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/URjcrZAuWmS3qo13pHqFRg#v_tableAPI "v_table 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=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
* [스크립트에서 테이블 쿼리](https://www.servicenow.com/docs/access?context=c_UsingGlideRecordToQueryTables&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/URjcrZAuWmS3qo13pHqFRg#v_tableAPI "v_table 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/2W~ifl1LvyXJ6zdY~n~R1Q#c_GlideRecordScopedAPI "범위가 지정된 GlideRecord API는 데이터베이스 운영에 사용됩니다.")
* [외부 공급업체 소스에서 특정 기록 검색 중](https://www.servicenow.com/docs/access?context=remote-table-script-def-example2&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
* [v_table](https://servicenow-prod.fluidtopics.net/URjcrZAuWmS3qo13pHqFRg#v_tableAPI "v_table 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);