---
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_record - 범위, 전역

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

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

v_record API를 사용하면 원격 테이블 기록에 예외 또는 오류 메시지를 설정할 수 있습니다. 원격 테이블을 사용하면 REST 또는 SOAP 서비스를 사용하여 외부 소스 또는 다른 인스턴스에서 데이터를 검색할 수 있습니다.

이 API는 작업 공간이나 목록 및 양식을 변경하지 않고 스크립트에서 GlideRecord 생성, 업데이트 및 삭제 메서드가 사용되는 모든 곳에서 실행됩니다.

이 API를 사용하려면 원격 테이블 플러그인(com.glide.script.vtable)을 활성화해야 합니다. 자세한 내용은 [Create script definitions for a remote table](https://www.servicenow.com/docs/access?context=create-remote-table-script&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 문서를 참조하십시오.

스크립트 가능 객체와 [v_query -- 범위 지정, 전역](https://servicenow-prod.fluidtopics.net/O6_TgChbdOYd7tXE1ym3jQ#v_queryAPI "v_query API에는 원격 테이블에 대해 실행되는 쿼리를 나타내는 스크립트 가능한 객체에 대한 정보를 가져오는 메서드가 있습니다.")v_record 사용하여 원격 테이블을 쿼리하고 API를 [v_table -- 범위 지정, 전역](https://servicenow-prod.fluidtopics.net/dUrYpwn9jT5jlhU5oRo7TQ#v_tableAPI "v_table API는 스크립트 객체를 통해 원격 테이블에 행을 추가하는 메서드를 제공합니다.") 사용하여 원격 테이블을 생성합니다.

## v_record - setLastErrorMessage(문자열 lastErrorMessage) {#ariaid-title2}

양식 또는 목록 뷰와 시스템 로그의 원격 테이블 기록에 대해 편집 가능한 작업 중에 표시할 예외 또는 오류 메시지를 설정합니다.
주:  
v_record는 삽입, 업데이트 또는 삭제 작업이 실행되는 원격 기록을 나타내므로 이 방법을 사용해도 테이블이 업데이트되지 않습니다.
{#v_record-setLastErrorMessage_S__table_mlx_v4c_fdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 마지막 오류 메시지 | 문자열 | 원격 테이블 기록에서 마지막 오류 또는 예외로 표시할 예외 또는 오류 메시지입니다. 양식 또는 목록 뷰에 표시되며 시스템 로그에 기록됩니다. |
[표 1. 매개변수]

{#v_record-setLastErrorMessage_S__table_mlx_v4c_fdc} {#v_record-setLastErrorMessage_S__table_nlx_v4c_fdc__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 2. 반환]

{#v_record-setLastErrorMessage_S__table_nlx_v4c_fdc}  
다음 예제에서는 원격 테이블 기록에서 편집 가능한 작업 중에 예외 메시지 "삽입을 실행하는 동안 예외가 발생했습니다"를 표시합니다.

    (function executeInsert(v_record) { 
       try{ 
    //add logic to insert the record in the remote table 
       } catch(ex) { 
          v_record.setLastErrorMessage("Exception encountered executing the insert");
       } 
    })(v_record); 
    (function executeUpdate(v_record, v_changed_fields) { 
       try{
    //add logic to update the record in the remote table from the changed fields in 	
    // v_changed_fields 
       }catch(ex) { 
          v_record.setLastErrorMessage("Exception encountered executing the update"); 
       } 
    })
    (v_record, v_changed_fields); 
    (function executeDelete(v_record) { 
       try{ 
    //add logic to delete the record in the remote table 
       }catch(ex) { 
          v_record.setLastErrorMessage("Exception encountered executing the delete"); 
       } 
    })(v_record);

출력:

    "Exception encountered executing the insert"

출력은 원격 시스템에서 수행된 조작(예: 삽입, 업데이트, 삭제)에 예외가 있을 때 setLastErrorMessage() 를 사용하여 설정된 예외 메시지입니다. 반환된 예외가 없으면 작업은 성공한 것으로 간주됩니다.