v_record - スコープ対象、グローバル

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • v_record API を使用すると、リモートテーブルレコードに例外またはエラーメッセージを設定できます。リモートテーブルを使用すると、外部ソースから、または REST サービスや SOAP サービスを使用して別のインスタンスからデータを取得できます。

    この API は、ワークスペース、リスト、フォームを変更することなく、スクリプト内で GlideRecord の作成、更新、および削除メソッドが使用される場所であればどこでも実行されます。

    この API では、リモートテーブルプラグイン (com.glide.script.vtable) を有効にする必要があります。 詳細については、「Create script definitions for a remote table」を参照してください。

    v_query:スコープ対象、グローバル スクリプト可能オブジェクトとともに v_record を使用してリモートテーブルをクエリし、v_table – スコープ対象、グローバル API を使用してリモートテーブルを作成します。

    v_record:setLastErrorMessage(文字列 lastErrorMessage)

    フォームまたはリストビュー、およびシステムログのリモートテーブルレコードに対する編集可能な操作中に表示する例外またはエラーメッセージを設定します。

    注:
    v_recordは、挿入、更新、または削除操作が実行されるリモートレコードを表すため、このメソッドを使用した結果としてテーブルが更新されることはありません。
    表 : 1. パラメーター
    名前 タイプ 説明
    lastErrorMessage 文字列 リモートテーブルレコードの最後のエラーまたは例外として表示する例外またはエラーメッセージ。フォームまたはリストビューに表示され、システムログに書き込まれます。
    表 : 2. 返される内容
    タイプ 説明
    なし

    次の例では、リモートテーブルレコードの編集可能な操作中に表示される例外メッセージ「挿入の実行中に例外が発生しました」を設定します。

    (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() を使用して設定された例外メッセージです。返された例外がない場合、操作は成功と見なされます。