v_query – 범위 지정, 전역

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기5분

    • 원격 테이블에 대해 실행 중인 쿼리를 나타내는 스크립트 가능 객체입니다.

    이 API를 사용하려면 Remote Tables 플러그인(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(문자열 필드)

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

    참고 항목:
    표 5. 매개변수
    이름 유형 설명
    필드 문자열 쿼리할 필드의 이름입니다.
    표 6. 반환
    유형 설명
    문자열 쿼리 조건의 필드 값입니다. 예를 들어, name=John 이 인코딩된 쿼리인 경우 getParameter("name") 는 "John"을 반환합니다.

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

    v_query.getParameter("caller_id");

    출력:

    12345123451234512345123451234501

    v_query - getSysId()

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

    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 get 쿼리의 Sys_id 값(예: sys_id=123인 경우 이 메서드는 123을 반환합니다.

    다음 예제는 외부 공급업체 소스에서 특정 레코드 검색의 코드 조각입니다.

    v_query.getSysId();

    출력:

    a3a7ffb6dba41010db2051735e4619b7

    v_query - getTextSearch()

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

    참고 항목:
    표 9. 매개변수
    이름 유형 설명
    없음
    표 10. 반환
    유형 설명
    문자열 텍스트 검색 쿼리 매개변수(예 : 이메일)입니다.

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

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

    출력:

    email

    v_query - isGet()

    쿼리가 가져오기 쿼리인지, 즉 sys_id별로 레코드를 검색하는 쿼리인지 여부를 결정합니다.

    참고 항목:
    표 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()

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

    참고 항목:
    표 13. 매개변수
    이름 유형 설명
    없음
    표 14. 반환
    유형 설명
    부울 쿼리에 텍스트 쿼리 매개변수가 포함되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 쿼리에 텍스트 쿼리 매개변수가 포함됩니다.
    • false: 쿼리에 텍스트 쿼리 매개변수가 포함되어 있지 않습니다.

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

    v_query.isTextSearch();

    v_query - setLastErrorMessage(문자열 메시지)

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

    참고 항목:
    표 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);